Potential typo in Profiler docs?
In the[profiler docs](https://docs.python.org/3/library/profile.html), under the first profiler output example, it says
... The next line:Ordered by: cumulative time, indicates that the text string in the far right column was used to sort the output.
This doesn't appear to make sense, and indeed the example output is sorted by the "cumtime" column, and not by the text string column at the far right. Am I misreading this or is this a typo? Thanks! PS. Sorry I didn't raise a ticket, I'm new and shy about posting in public forums
See the profiler output example carefully. You can see "Ordered by: cumulative time" in the second line. On Mon, Jun 26, 2023 at 6:40 AM 2dfkit via docs <docs@python.org> wrote:
In the profiler docs, under the first profiler output example, it says
... The next line: Ordered by: cumulative time, indicates that the text string in the far right column was used to sort the output.
This doesn't appear to make sense, and indeed the example output is sorted by the "cumtime" column, and not by the text string column at the far right.
Am I misreading this or is this a typo?
Thanks! PS. Sorry I didn't raise a ticket, I'm new and shy about posting in public forums _______________________________________________ docs mailing list -- docs@python.org To unsubscribe send an email to docs-leave@python.org https://mail.python.org/mailman3/lists/docs.python.org/ Member address: songofacandy@gmail.com
-- Inada Naoki <songofacandy@gmail.com>
Right, the "Ordered by: cumulative time" agrees with the ordering in the output example. What I'm confused about is the statement that this line "indicates that the text string in the far right column was used to sort the output." In other words, the "far right column" sounds like it's referring to the column titled "filename:lineno(function)", and "text string...was used to sort the output" sounds like it's referring to the values under that column being used as the sorting key. Am I misinterpreting that? ------- Original Message ------- On Sunday, June 25th, 2023 at 11:36 PM, Inada Naoki <songofacandy@gmail.com> wrote:
See the profiler output example carefully. You can see "Ordered by: cumulative time" in the second line.
On Mon, Jun 26, 2023 at 6:40 AM 2dfkit via docs docs@python.org wrote:
In the profiler docs, under the first profiler output example, it says
... The next line: Ordered by: cumulative time, indicates that the text string in the far right column was used to sort the output.
This doesn't appear to make sense, and indeed the example output is sorted by the "cumtime" column, and not by the text string column at the far right.
Am I misreading this or is this a typo?
Thanks! PS. Sorry I didn't raise a ticket, I'm new and shy about posting in public forums _______________________________________________ docs mailing list -- docs@python.org To unsubscribe send an email to docs-leave@python.org https://mail.python.org/mailman3/lists/docs.python.org/ Member address: songofacandy@gmail.com
-- Inada Naoki songofacandy@gmail.com
I think "far right column" means "cumulative time" part of the "Ordered by: cumulative time" line. I am not sure that this sentence is clear, because I'm not native English speaker. -- Inada Naoki <songofacandy@gmail.com>
I'm a native English speaker and find this unclear/misleading. I also checked with 2 other native speakers (one experienced programmer, one beginner), and both of them agree too! ------- Original Message ------- On Monday, June 26th, 2023 at 2:36 PM, Inada Naoki <songofacandy@gmail.com> wrote:
I think "far right column" means "cumulative time" part of the "Ordered by: cumulative time" line. I am not sure that this sentence is clear, because I'm not native English speaker.
-- Inada Naoki songofacandy@gmail.com
Hello, Thank you for your report. It is now tracked at: https://github.com/python/cpython/issues/110383 On 25. 06. 23 22:48, 2dfkit via docs wrote:
In theprofiler docs <https://docs.python.org/3/library/profile.html>, under the first profiler output example, it says
... The next line:Ordered by: cumulative time, indicates that the text string in the far right column was used to sort the output.
This doesn't appear to make sense, and indeed the example output is sorted by the "cumtime" column, and not by the text string column at the far right.
Am I misreading this or is this a typo?
Thanks! PS. Sorry I didn't raise a ticket, I'm new and shy about posting in public forums
_______________________________________________ docs mailing list -- docs@python.org To unsubscribe send an email to docs-leave@python.org https://mail.python.org/mailman3/lists/docs.python.org/ Member address: encukou@gmail.com
participants (3)
-
2dfkit -
Inada Naoki -
Petr Viktorin