[Python-checkins] CVS: python/dist/src/Doc/lib libstdtypes.tex,1.72,1.73

[Fred L. Drake]

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

Modified Files:
	libstdtypes.tex 
Log Message:
Explain what [].insert() does when the target index is negative.

Index: libstdtypes.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libstdtypes.tex,v
retrieving revision 1.72
retrieving revision 1.73
diff -C2 -d -r1.72 -r1.73
*** libstdtypes.tex	2001/10/20 04:24:09	1.72
--- libstdtypes.tex	2001/10/26 18:57:14	1.73
***************
*** 840,852 ****
    \lineiii{\var{s}.insert(\var{i}, \var{x})}
  	{same as \code{\var{s}[\var{i}:\var{i}] = [\var{x}]}
! 	  if \code{\var{i} >= 0}}{}
    \lineiii{\var{s}.pop(\optional{\var{i}})}
!     {same as \code{\var{x} = \var{s}[\var{i}]; del \var{s}[\var{i}]; return \var{x}}}{(4)}
    \lineiii{\var{s}.remove(\var{x})}
  	{same as \code{del \var{s}[\var{s}.index(\var{x})]}}{(3)}
    \lineiii{\var{s}.reverse()}
! 	{reverses the items of \var{s} in place}{(5)}
    \lineiii{\var{s}.sort(\optional{\var{cmpfunc}})}
! 	{sort the items of \var{s} in place}{(5), (6)}
  \end{tableiii}
  \indexiv{operations on}{mutable}{sequence}{types}
--- 840,852 ----
    \lineiii{\var{s}.insert(\var{i}, \var{x})}
  	{same as \code{\var{s}[\var{i}:\var{i}] = [\var{x}]}
! 	  if \code{\var{i} >= 0}}{(4)}
    \lineiii{\var{s}.pop(\optional{\var{i}})}
!     {same as \code{\var{x} = \var{s}[\var{i}]; del \var{s}[\var{i}]; return \var{x}}}{(5)}
    \lineiii{\var{s}.remove(\var{x})}
  	{same as \code{del \var{s}[\var{s}.index(\var{x})]}}{(3)}
    \lineiii{\var{s}.reverse()}
! 	{reverses the items of \var{s} in place}{(6)}
    \lineiii{\var{s}.sort(\optional{\var{cmpfunc}})}
! 	{sort the items of \var{s} in place}{(6), (7)}
  \end{tableiii}
  \indexiv{operations on}{mutable}{sequence}{types}
***************
*** 875,888 ****
    \var{s}.
  
! \item[(4)] The \method{pop()} method is only supported by the list and
    array types.  The optional argument \var{i} defaults to \code{-1},
    so that by default the last item is removed and returned.
  
! \item[(5)] The \method{sort()} and \method{reverse()} methods modify the
    list in place for economy of space when sorting or reversing a large
    list.  To remind you that they operate by side effect, they don't return
    the sorted or reversed list.
  
! \item[(6)] The \method{sort()} method takes an optional argument
    specifying a comparison function of two arguments (list items) which
    should return a negative, zero or positive number depending on whether
--- 875,892 ----
    \var{s}.
  
! \item[(4)] When a negative index is passed as the first parameter to
!   the \method{insert()} method, the new element is prepended to the
!   sequence.
! 
! \item[(5)] The \method{pop()} method is only supported by the list and
    array types.  The optional argument \var{i} defaults to \code{-1},
    so that by default the last item is removed and returned.
  
! \item[(6)] The \method{sort()} and \method{reverse()} methods modify the
    list in place for economy of space when sorting or reversing a large
    list.  To remind you that they operate by side effect, they don't return
    the sorted or reversed list.
  
! \item[(7)] The \method{sort()} method takes an optional argument
    specifying a comparison function of two arguments (list items) which
    should return a negative, zero or positive number depending on whether