summaryrefslogtreecommitdiffstats
path: root/Doc/library/cgi.rst
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2008-05-11 21:42:51 (GMT)
committerGeorg Brandl <georg@python.org>2008-05-11 21:42:51 (GMT)
commit49d1b4f919039f6caeddf2d1eba9708c0cfe8bd4 (patch)
tree1212071bced2d3df87a39f81f827f6f23b3f9d82 /Doc/library/cgi.rst
parentfb16cf1d9b6d3f5e8d48b19409f083435973d9c0 (diff)
downloadcpython-49d1b4f919039f6caeddf2d1eba9708c0cfe8bd4.zip
cpython-49d1b4f919039f6caeddf2d1eba9708c0cfe8bd4.tar.gz
cpython-49d1b4f919039f6caeddf2d1eba9708c0cfe8bd4.tar.bz2
Remove old backwards-compatibility classes from the cgi module.
Diffstat (limited to 'Doc/library/cgi.rst')
-rw-r--r--Doc/library/cgi.rst35
1 files changed, 6 insertions, 29 deletions
diff --git a/Doc/library/cgi.rst b/Doc/library/cgi.rst
index 9f0171c..0a9ccd3 100644
--- a/Doc/library/cgi.rst
+++ b/Doc/library/cgi.rst
@@ -63,9 +63,7 @@ prints a simple piece of HTML::
Using the cgi module
--------------------
-Begin by writing ``import cgi``. Do not use ``from cgi import *`` --- the
-module defines all sorts of names for its own use or for backward compatibility
-that you don't want in your namespace.
+Begin by writing ``import cgi``.
When you write a new script, consider adding the line::
@@ -83,12 +81,11 @@ produced by :mod:`cgitb` provide information that can save you a lot of time in
tracking down bugs. You can always remove the ``cgitb`` line later when you
have tested your script and are confident that it works correctly.
-To get at submitted form data, it's best to use the :class:`FieldStorage` class.
-The other classes defined in this module are provided mostly for backward
-compatibility. Instantiate it exactly once, without arguments. This reads the
-form contents from standard input or the environment (depending on the value of
-various environment variables set according to the CGI standard). Since it may
-consume standard input, it should be instantiated only once.
+To get at submitted form data, use the :class:`FieldStorage` class. Instantiate
+it exactly once, without arguments. This reads the form contents from standard
+input or the environment (depending on the value of various environment
+variables set according to the CGI standard). Since it may consume standard
+input, it should be instantiated only once.
The :class:`FieldStorage` instance can be indexed like a Python dictionary, and
also supports the standard dictionary methods :meth:`__contains__` and
@@ -245,26 +242,6 @@ Using these methods you can write nice compact code::
do_something(item)
-Old classes
------------
-
-These classes, present in earlier versions of the :mod:`cgi` module, are still
-supported for backward compatibility. New applications should use the
-:class:`FieldStorage` class.
-
-:class:`SvFormContentDict` stores single value form content as dictionary; it
-assumes each field name occurs in the form only once.
-
-:class:`FormContentDict` stores multiple value form content as a dictionary (the
-form items are lists of values). Useful if your form contains multiple fields
-with the same name.
-
-Other classes (:class:`FormContent`, :class:`InterpFormContentDict`) are present
-for backwards compatibility with really old applications only. If you still use
-these and would be inconvenienced when they disappeared from a next version of
-this module, drop me a note.
-
-
.. _functions-in-cgi-module:
Functions