[Python-checkins] python/dist/src/Doc/ref ref2.tex,1.48,1.49

[fdrake at users.sourceforge.net]

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

Modified Files:
	ref2.tex 
Log Message:
Elaborate the explanation of different flavors of _* identifiers.
Fixes SF bug #520325.


Index: ref2.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/ref/ref2.tex,v
retrieving revision 1.48
retrieving revision 1.49
diff -C2 -d -r1.48 -r1.49
*** ref2.tex	21 Jun 2003 13:40:02 -0000	1.48
--- ref2.tex	6 Sep 2003 03:50:07 -0000	1.49
***************
*** 321,343 ****
  
  Certain classes of identifiers (besides keywords) have special
! meanings.  These are:
  
! \begin{tableiii}{l|l|l}{code}{Form}{Meaning}{Notes}
! \lineiii{_*}{Not imported by \samp{from \var{module} import *}}{(1)}
! \lineiii{__*__}{System-defined name}{}
! \lineiii{__*}{Class-private name mangling}{}
! \end{tableiii}
  
! See sections: \ref{import}, ``The \keyword{import} statement'';
! \ref{specialnames}, ``Special method names'';
! \ref{atom-identifiers}, ``Identifiers (Names)''.
  
! Note:
  
- \begin{description}
- \item[(1)] The special identifier \samp{_} is used in the interactive
- interpreter to store the result of the last evaluation; it is stored
- in the \module{__builtin__} module.  When not in interactive mode,
- \samp{_} has no special meaning and is not defined.
  \end{description}
  
--- 321,357 ----
  
  Certain classes of identifiers (besides keywords) have special
! meanings.  These classes are identified by the patterns of leading and
! trailing underscore characters:
  
! \begin{description}
  
! \item[\code{_*}]
!   Not imported by \samp{from \var{module} import *}.  The special
!   identifier \samp{_} is used in the interactive interpreter to store
!   the result of the last evaluation; it is stored in the
!   \module{__builtin__} module.  When not in interactive mode, \samp{_}
!   has no special meaning and is not defined.
!   See section~\ref{import}, ``The \keyword{import} statement.''
  
!   \note{The name \samp{_} is often used in conjunction with
!   internationalization; refer to the documentation for the
!   \ulink{\module{gettext} module}{../lib/module-gettext.html} for more
!   information on this convention.}
! 
! \item[\code{__*__}]
!   System-defined names.  These names are defined by the interpreter
!   and it's implementation (including the standard library);
!   applications should not expect to define additional names using this
!   convention.  The set of names of this class defined by Python may be
!   extended in future versions.
!   See section~\ref{specialnames}, ``Special method names.''
! 
! \item[\code{__*}]
!   Class-private names.  Names in this category, when used within the
!   context of a class definition, are re-written to use a mangled for
!   to help avoid name clashes between ``private'' attributes of base
!   and derived classes.
!   See section~\ref{atom-identifiers}, ``Identifiers (Names).''
  
  \end{description}