[Python-checkins] python/dist/src/Doc/lib libstdtypes.tex, 1.138, 1.139

[rhettinger at users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1:/tmp/cvs-serv6236/Doc/lib

Modified Files:
	libstdtypes.tex 
Log Message:
Add list.sorted() classmethod.

Index: libstdtypes.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libstdtypes.tex,v
retrieving revision 1.138
retrieving revision 1.139
diff -C2 -d -r1.138 -r1.139
*** libstdtypes.tex	22 Oct 2003 02:56:40 -0000	1.138
--- libstdtypes.tex	29 Oct 2003 06:54:42 -0000	1.139
***************
*** 630,634 ****
  \begin{methoddesc}[string]{istitle}{}
  Return true if the string is a titlecased string and there is at least one
! character, i.e. uppercase characters may only follow uncased
  characters and lowercase characters only cased ones.  Return false
  otherwise.
--- 630,634 ----
  \begin{methoddesc}[string]{istitle}{}
  Return true if the string is a titlecased string and there is at least one
! character, for example uppercase characters may only follow uncased
  characters and lowercase characters only cased ones.  Return false
  otherwise.
***************
*** 976,979 ****
--- 976,982 ----
                          \optional{, \var{reverse}=False}}})}
  	{sort the items of \var{s} in place}{(7), (8), (9), (10)}
+   \lineiii{\var{s}.sorted(\var{iterable}\optional{, \var{cmp}=None\optional{, \var{key}=None
+                         \optional{, \var{reverse}=False}}})}
+ 	{return a new sorted list from the items in \var{iterable}}{(8), (9), (11)}     
  \end{tableiii}
  \indexiv{operations on}{mutable}{sequence}{types}
***************
*** 1025,1030 ****
    the sorted or reversed list.
  
! \item[(8)] The \method{sort()} method takes optional arguments for
!   controlling the comparisions.
  
    \var{cmp} specifies a custom comparison function of two arguments
--- 1028,1033 ----
    the sorted or reversed list.
  
! \item[(8)] The \method{sort()} and \method{sorted()} methods take optional
!   arguments for controlling the comparisions.
  
    \var{cmp} specifies a custom comparison function of two arguments
***************
*** 1053,1057 ****
  
  \item[(9)]  Starting with Python 2.3, the \method{sort()} method is
!   guaranteed to be stable.  A sort is stable if it guarantees not to
    change the relative order of elements that compare equal --- this is
    helpful for sorting in multiple passes (for example, sort by
--- 1056,1061 ----
  
  \item[(9)]  Starting with Python 2.3, the \method{sort()} method is
!   guaranteed to be stable.  Starting with Python 2.4, the \method{sorted()}
!   method is also guaranteed to be stable.  A sort is stable if it does not
    change the relative order of elements that compare equal --- this is
    helpful for sorting in multiple passes (for example, sort by
***************
*** 1063,1066 ****
--- 1067,1073 ----
    \exception{ValueError} if it can detect that the list has been
    mutated during a sort.
+ 
+ \item[(11)] \method{sorted()} is a class method that returns a new list.
+   \versionadded{2.4}
  \end{description}