mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-07-30 14:44:10 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

Add notes pointing out that these classes are kept for backward compatibility

Browse source 
and suggeest that new code that does not require compatibility with older
Python versions subclass dictionary, list, or str.
This commit is contained in:
Fred Drake 2001-10-26 18:37:27 +00:00
parent 5445f078df
commit d5be3b75dd
1 changed files with 17 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

17
Doc/lib/libuserdict.tex
View file

@ -4,6 +4,11 @@
\declaremodule{standard}{UserDict}
\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
your own dictionary-like classes, which can inherit from
@ -38,6 +43,11 @@ class.
\modulesynopsis{Class wrapper for list 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{list} type.}
This module defines a class that acts as a wrapper around
list objects. It is a useful base class for
your own list-like classes, which can inherit from
@ -92,6 +102,13 @@ methods which need to be provided in that case.
\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
objects. It is a useful base class for your own string-like classes,
which can inherit from them and override existing methods or add new