Message126083
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. |
|
Date |
User |
Action |
Args |
2011-01-12 10:29:48 | eric.araujo | set | recipients:
+ eric.araujo, rhettinger, docs@python |
2011-01-12 10:29:48 | eric.araujo | set | messageid: <1294828188.31.0.578827978132.issue10891@psf.upfronthosting.co.za> |
2011-01-12 10:29:44 | eric.araujo | link | issue10891 messages |
2011-01-12 10:29:44 | eric.araujo | create | |
|