[issue10891] Tweak sorting howto to eliminate redundancy
Raymond Hettinger rhettin...@users.sourceforge.net added the comment: Made some tweaks r88358. Sorry, I'm leaving the list.sort references as-is. I consider them to be important in a document that needs to clearly differentiate list.sort from __builtin__.sorted(). -- assignee: eric.araujo - rhettinger resolution: - fixed status: open - closed ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10891 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue10891] Tweak sorting howto to eliminate redundancy
Georg Brandl ge...@python.org added the comment: I do think that list.sort() method of a list is a bit too much. -- nosy: +georg.brandl ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10891 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue10891] Tweak sorting howto to eliminate redundancy
Raymond Hettinger rhettin...@users.sourceforge.net added the comment: You can put in the backslashes before the two periods, but not the other changes. I want the method names to continue to be spelled-out in full so that it is more clear what they are referring to. Even in spoken English, I typically say list sort or sort method of the builtin list type. This helps distinguish it from the sorted() builtin. -- assignee: rhettinger - eric.araujo ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10891 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue10891] Tweak sorting howto to eliminate redundancy
New submission from Éric Araujo mer...@netwok.org: When reading over the sorting howto, I noticed redundancy of the form “the list.sort() method of a list”. Raymond, if you approve the attached patch, please assign back to me. There were no warnings during doc build and no link was broken. Note that :meth:`list.sort` (or :meth:`~list.sort`) does not trigger a link to the doc of the method, since sort is not marked up with a method directive but listed in a table alongside other list and bytearray methods (http://docs.python.org/dev/library/stdtypes#typesseq-mutable). This table is preceded by index-generating markup, but it does not create a target for :meth:`list.sort`; that’s a separate issue. Until it’s solved, the sorting howto could turn the first occurrence of “list” into a link to the right section, using :ref:`typesseq-mutable list`, or continue to live without a link to list or list.sort. -- assignee: rhettinger components: Documentation files: minor-sorting-changes.diff keywords: patch messages: 126083 nosy: d...@python, eric.araujo, rhettinger priority: normal severity: normal stage: commit review status: open title: Tweak sorting howto to eliminate redundancy versions: Python 2.7, Python 3.1, Python 3.2 Added file: http://bugs.python.org/file20364/minor-sorting-changes.diff ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10891 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com