[Python-checkins] r86188 - in python/branches/release31-maint: Doc/glossary.rst Doc/howto/sorting.rst

georg.brandl python-checkins at python.org
Fri Nov 5 08:11:47 CET 2010


Author: georg.brandl
Date: Fri Nov  5 08:11:47 2010
New Revision: 86188

Log:
Merged revisions 86187 via svnmerge from 
svn+ssh://svn.python.org/python/branches/py3k

........
  r86187 | georg.brandl | 2010-11-05 07:10:41 +0000 (Fr, 05 Nov 2010) | 1 line
  
  Move glossary entry to the right position and fix link.
........


Modified:
   python/branches/release31-maint/   (props changed)
   python/branches/release31-maint/Doc/glossary.rst
   python/branches/release31-maint/Doc/howto/sorting.rst

Modified: python/branches/release31-maint/Doc/glossary.rst
==============================================================================
--- python/branches/release31-maint/Doc/glossary.rst	(original)
+++ python/branches/release31-maint/Doc/glossary.rst	Fri Nov  5 08:11:47 2010
@@ -283,26 +283,6 @@
       instances of user-defined classes are hashable by default; they all
       compare unequal, and their hash value is their :func:`id`.
 
-   key function
-      A key function or collation function is a callable that returns a value
-      used for sorting or ordering.  For example, :func:`locale.strxfrm` is
-      used to produce a sort key that is aware of locale specific sort
-      conventions.
-
-      A number of tools in Python accept key functions to control how elements
-      are ordered or grouped.  They include :func:`min`, :func:`max`,
-      :func:`sorted`, :meth:`list.sort`, :func:`heapq.nsmallest`,
-      :func:`heapq.nlargest`, and :func:`itertools.groupby`.
-
-      There are several ways to create a key function.  For example. the
-      :meth:`str.lower` method can serve as a key function for case insensitive
-      sorts.  Alternatively, an ad-hoc key function can be built from a
-      :keyword:`lambda` expression such as ``lambda r: (r[0], r[2])``.  Also,
-      the :mod:`operator` module provides three key function constuctors:
-      :func:`~operator.attrgetter`, :func:`~operator.itemgetter`, and
-      :func:`~operator.methodcaller`.  See the :ref:`Sorting HOW TO` for
-      examples of how to create and use key functions.
-
    IDLE
       An Integrated Development Environment for Python.  IDLE is a basic editor
       and interpreter environment which ships with the standard distribution of
@@ -370,6 +350,26 @@
 
       More information can be found in :ref:`typeiter`.
 
+   key function
+      A key function or collation function is a callable that returns a value
+      used for sorting or ordering.  For example, :func:`locale.strxfrm` is
+      used to produce a sort key that is aware of locale specific sort
+      conventions.
+
+      A number of tools in Python accept key functions to control how elements
+      are ordered or grouped.  They include :func:`min`, :func:`max`,
+      :func:`sorted`, :meth:`list.sort`, :func:`heapq.nsmallest`,
+      :func:`heapq.nlargest`, and :func:`itertools.groupby`.
+
+      There are several ways to create a key function.  For example. the
+      :meth:`str.lower` method can serve as a key function for case insensitive
+      sorts.  Alternatively, an ad-hoc key function can be built from a
+      :keyword:`lambda` expression such as ``lambda r: (r[0], r[2])``.  Also,
+      the :mod:`operator` module provides three key function constuctors:
+      :func:`~operator.attrgetter`, :func:`~operator.itemgetter`, and
+      :func:`~operator.methodcaller`.  See the :ref:`Sorting HOW TO
+      <sortinghowto>` for examples of how to create and use key functions.
+
    keyword argument
       Arguments which are preceded with a ``variable_name=`` in the call.
       The variable name designates the local name in the function to which the

Modified: python/branches/release31-maint/Doc/howto/sorting.rst
==============================================================================
--- python/branches/release31-maint/Doc/howto/sorting.rst	(original)
+++ python/branches/release31-maint/Doc/howto/sorting.rst	Fri Nov  5 08:11:47 2010
@@ -1,3 +1,5 @@
+.. _sortinghowto:
+
 Sorting HOW TO
 **************
 


More information about the Python-checkins mailing list