diff -r 128fa5eea9b1 Doc/faq/programming.rst --- a/Doc/faq/programming.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/faq/programming.rst Sun Dec 20 12:16:27 2015 +0100 @@ -1010,8 +1010,7 @@ may come up with. This is doubly true for primitives written in C, such as builtins and some extension types. For example, be sure to use either the :meth:`list.sort` built-in method or the related :func:`sorted` - function to do sorting (and see the - `sorting mini-HOWTO `_ for examples + function to do sorting (and see the :ref:`sortinghowto` for examples of moderately advanced usage). * Abstractions tend to create indirections and force the interpreter to work diff -r 128fa5eea9b1 Doc/library/functions.rst --- a/Doc/library/functions.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/functions.rst Sun Dec 20 12:16:27 2015 +0100 @@ -1306,8 +1306,7 @@ compare equal --- this is helpful for sorting in multiple passes (for example, sort by department, then by salary grade). - For sorting examples and a brief sorting tutorial, see `Sorting HowTo - `_\. + For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`. .. function:: staticmethod(function) diff -r 128fa5eea9b1 Doc/whatsnew/3.2.rst --- a/Doc/whatsnew/3.2.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/whatsnew/3.2.rst Sun Dec 20 12:16:27 2015 +0100 @@ -815,8 +815,8 @@ >>> # locale-aware sort order >>> sorted(iterable, key=cmp_to_key(locale.strcoll)) - For sorting examples and a brief sorting tutorial, see the `Sorting HowTo - `_ tutorial. + For sorting examples and a brief sorting tutorial, see the :ref:`sortinghowto` + tutorial. (Contributed by Raymond Hettinger.)