cProfile reports the profiling result in a table with the headers

  ncalls  tottime  percall  cumtime  percall filename:lineno(function)

The respective arguments are 

  calls   time     -        cumulative -     nfl

Since I had to lookup these different names everytime I used cProfile, I think that it should take the table headings as argument aliases.

Also there is inconsistent naming of pcalls between docs and code.

In the docs of Stats.sort_stats pcalls is named primitive call count.
In the code at Stats.sort_arg_dict_default it was just named call count.

I created 4 patches to fix that in Python 2.7 and Python 3.2. The first is attached here, the later will be attached to comments. 

They apply to 822d7a1f8885 for 2.7 and 89b699e68fa2 for 3.2.

I also created a patch for adding percall sorting, but that requires more invasive changes and I did not see a simple name to distinguish between the two bycall headings.

What would be the best way to get this patch reviewed?

I'll take a look next week if nobody else do it before.

Thank you!

Did you get to taking a look?

Is there anything I should change?

New changeset cc3e27b7da41 by Andrew Svetlov in branch '2.7':
Issue #14900: Distuguish call count and primitive call count in pstat output.
http://hg.python.org/cpython/rev/cc3e27b7da41

New changeset 410e92589164 by Andrew Svetlov in branch '3.2':
Issue #14900: Distuguish call count and primitive call count in pstat output.
http://hg.python.org/cpython/rev/410e92589164

New changeset fb216fee32db by Andrew Svetlov in branch '3.3':
Merge issue #14900: Distuguish call count and primitive call count in pstat output.
http://hg.python.org/cpython/rev/fb216fee32db

New changeset bc658b6a1d4e by Andrew Svetlov in branch 'default':
Issue #14900: Distuguish call count and primitive call count in pstat output.
http://hg.python.org/cpython/rev/bc658b6a1d4e

I definitely agree with renaming "call count" to "primitive call count".
Thank you for patch.

BTW please fill Python Contributor Agreement: http://www.python.org/psf/contrib/

New changeset 69b310f7acfa by Andrew Svetlov in branch '2.7':
Issue #14900: Add aliases for sorting params for pstat to follow column names from pstat output.
http://hg.python.org/cpython/rev/69b310f7acfa

New changeset 511a3c51731e by Andrew Svetlov in branch '3.2':
Issue #14900: Add aliases for sorting params for pstat to follow column names from pstat output.
http://hg.python.org/cpython/rev/511a3c51731e

New changeset 29d4ac311627 by Andrew Svetlov in branch '3.3':
Merge issue #14900: Add aliases for sorting params for pstat to follow column names from pstat output.
http://hg.python.org/cpython/rev/29d4ac311627

New changeset 7b8b1b30e5f8 by Andrew Svetlov in branch 'default':
Merge issue #14900: Add aliases for sorting params for pstat to follow column names from pstat output.
http://hg.python.org/cpython/rev/7b8b1b30e5f8

I'm ok with aliases also.
Issue with percall can be fixed only in 3.4 via renaming one of the column.
Thanks again.

Documentation also need to be updated to reflect changes.

Copyright-assignment signed and sent.

Thanks!

Looks like you missed *sort* parameter for ".. function:: run(command, filename=None, sort=-1)"
Also it will be nice to insert link to Stats.sort_stats in doc text for run functions.

Jepp, I missed that. I hope the added patches clear that up.

Sorry, I cannot figure out what hg repo version should I use to apply 
sort-argument* patches.
Can you prepare 2 cumulative patches for 2.7 and 3.2 which can be applied to current repo state?
It's CPython team policy to send patches which can be applied to pure repo if no other rule explicitly specified.
Thanks.

I’ll create them as soon as I get the time.

It’s not as if that’s really hard - but I still have to do it (need to diff against current tip - I already merged, so that should work without problems).

I'm waiting for your patch.
Thanks.

New changeset f263a84871de by Andrew Svetlov in branch '2.7':
Issue #14900: document added sort keys for profile stats.
http://hg.python.org/cpython/rev/f263a84871de

New changeset 52d6974fa05b by Andrew Svetlov in branch '3.2':
Issue #14900: document added sort keys for profile stats.
http://hg.python.org/cpython/rev/52d6974fa05b

New changeset 78963f00d4ad by Andrew Svetlov in branch '3.3':
Merge issue #14900: document added sort keys for profile stats.
http://hg.python.org/cpython/rev/78963f00d4ad

New changeset dd4783955353 by Andrew Svetlov in branch 'default':
Issue #14900: document added sort keys for profile stats.
http://hg.python.org/cpython/rev/dd4783955353

Fixed. For future improvements please open new issue.
Thanks.

…you were faster than me (I only managed to get the repo onto my current computer yesterday and the children kept me occupied). 

Thank you!

No problems!