[Python-checkins] CVS: python/dist/src/Doc/lib libuserdict.tex,1.19,1.20

2001年10月26日 11:37:29 -0700

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv24531/lib
Modified Files:
	libuserdict.tex 
Log Message:
Add notes pointing out that these classes are kept for backward compatibility
and suggeest that new code that does not require compatibility with older
Python versions subclass dictionary, list, or str.
Index: libuserdict.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libuserdict.tex,v
retrieving revision 1.19
retrieving revision 1.20
diff -C2 -d -r1.19 -r1.20
*** libuserdict.tex	2000年10月10日 22:00:03	1.19
--- libuserdict.tex	2001年10月26日 18:37:27	1.20
***************
*** 5,8 ****
--- 5,13 ----
 \modulesynopsis{Class wrapper for dictionary objects.}
 
+ \note{This module is available for backward compatibility only. If
+ you are writing code that does not need to work with versions of
+ Python earlier than Python 2.2, please consider subclassing directly
+ from the built-in \class{dictionary} type.}
+ 
 This module defines a class that acts as a wrapper around
 dictionary objects. It is a useful base class for
***************
*** 39,42 ****
--- 44,52 ----
 
 
+ \note{This module is available for backward compatibility only. If
+ you are writing code that does not need to work with versions of
+ Python earlier than Python 2.2, please consider subclassing directly
+ from the built-in \class{list} type.}
+ 
 This module defines a class that acts as a wrapper around
 list objects. It is a useful base class for
***************
*** 92,95 ****
--- 102,112 ----
 \moduleauthor{Peter Funk}{pf@artcom-gmbh.de}
 \sectionauthor{Peter Funk}{pf@artcom-gmbh.de}
+ 
+ \note{This \class{UserString} class from this module is available for
+ backward compatibility only. If you are writing code that does not
+ need to work with versions of Python earlier than Python 2.2, please
+ consider subclassing directly from the built-in \class{str} type
+ instead of using \class{UserString} (there is no built-in equivalent
+ to \class{MutableString}).}
 
 This module defines a class that acts as a wrapper around string