mirror of
https://github.com/python/cpython.git
synced 2025-11-11 14:44:57 +00:00
Removed some colons that shouldn't be there (probably leftovers from
docstring conversion).
This commit is contained in:
parent
27e4aa3168
commit
81e479a11f
2 changed files with 52 additions and 26 deletions
|
|
@ -155,10 +155,12 @@ These classes, present in earlier versions of the \code{cgi} module, are still
|
||||||
supported for backward compatibility. New applications should use the
|
supported for backward compatibility. New applications should use the
|
||||||
FieldStorage class.
|
FieldStorage class.
|
||||||
|
|
||||||
\code{SvFormContentDict}: single value form content as dictionary; assumes each
|
\code{SvFormContentDict}
|
||||||
|
single value form content as dictionary; assumes each
|
||||||
field name occurs in the form only once.
|
field name occurs in the form only once.
|
||||||
|
|
||||||
\code{FormContentDict}: multiple value form content as dictionary (the form
|
\code{FormContentDict}
|
||||||
|
multiple value form content as dictionary (the form
|
||||||
items are lists of values). Useful if your form contains multiple
|
items are lists of values). Useful if your form contains multiple
|
||||||
fields with the same name.
|
fields with the same name.
|
||||||
|
|
||||||
|
|
@ -175,18 +177,22 @@ These are useful if you want more control, or if you want to employ
|
||||||
some of the algorithms implemented in this module in other
|
some of the algorithms implemented in this module in other
|
||||||
circumstances.
|
circumstances.
|
||||||
|
|
||||||
\begin{funcdesc}{parse}{fp}: Parse a query in the environment or from a file (default \code{sys.stdin}).
|
\begin{funcdesc}{parse}{fp}
|
||||||
|
Parse a query in the environment or from a file (default \code{sys.stdin}).
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{parse_qs}{qs}: parse a query string given as a string argument (data of type
|
\begin{funcdesc}{parse_qs}{qs}
|
||||||
|
parse a query string given as a string argument (data of type
|
||||||
\code{application/x-www-form-urlencoded}).
|
\code{application/x-www-form-urlencoded}).
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{parse_multipart}{fp\, pdict}: parse input of type \code{multipart/form-data} (for
|
\begin{funcdesc}{parse_multipart}{fp\, pdict}
|
||||||
|
parse input of type \code{multipart/form-data} (for
|
||||||
file uploads). Arguments are \code{fp} for the input file and
|
file uploads). Arguments are \code{fp} for the input file and
|
||||||
\code{pdict} for the dictionary containing other parameters of \code{content-type} header
|
\code{pdict} for the dictionary containing other parameters of \code{content-type} header
|
||||||
|
|
||||||
Returns a dictionary just like \code{parse_qs()}: keys are the field names, each
|
Returns a dictionary just like \code{parse_qs()}
|
||||||
|
keys are the field names, each
|
||||||
value is a list of values for that field. This is easy to use but not
|
value is a list of values for that field. This is easy to use but not
|
||||||
much good if you are expecting megabytes to be uploaded -- in that case,
|
much good if you are expecting megabytes to be uploaded -- in that case,
|
||||||
use the \code{FieldStorage} class instead which is much more flexible. Note
|
use the \code{FieldStorage} class instead which is much more flexible. Note
|
||||||
|
|
@ -197,29 +203,36 @@ file uploads). Arguments are \code{fp} for the input file and
|
||||||
that.
|
that.
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{parse_header}{string}: parse a header like \code{Content-type} into a main
|
\begin{funcdesc}{parse_header}{string}
|
||||||
|
parse a header like \code{Content-type} into a main
|
||||||
content-type and a dictionary of parameters.
|
content-type and a dictionary of parameters.
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{test}{}: robust test CGI script, usable as main program.
|
\begin{funcdesc}{test}{}
|
||||||
|
robust test CGI script, usable as main program.
|
||||||
Writes minimal HTTP headers and formats all information provided to
|
Writes minimal HTTP headers and formats all information provided to
|
||||||
the script in HTML form.
|
the script in HTML form.
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{print_environ}{}: format the shell environment in HTML.
|
\begin{funcdesc}{print_environ}{}
|
||||||
|
format the shell environment in HTML.
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{print_form}{form}: format a form in HTML.
|
\begin{funcdesc}{print_form}{form}
|
||||||
|
format a form in HTML.
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{print_directory}{}: format the current directory in HTML.
|
\begin{funcdesc}{print_directory}{}
|
||||||
|
format the current directory in HTML.
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{print_environ_usage}{}: print a list of useful (used by CGI) environment variables in
|
\begin{funcdesc}{print_environ_usage}{}
|
||||||
|
print a list of useful (used by CGI) environment variables in
|
||||||
HTML.
|
HTML.
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{escape}{s\optional{\, quote}}: convert the characters
|
\begin{funcdesc}{escape}{s\optional{\, quote}}
|
||||||
|
convert the characters
|
||||||
``\code{\&}'', ``\code{<}'' and ``\code{>}'' in string \var{s} to HTML-safe
|
``\code{\&}'', ``\code{<}'' and ``\code{>}'' in string \var{s} to HTML-safe
|
||||||
sequences. Use this if you need to display text that might contain
|
sequences. Use this if you need to display text that might contain
|
||||||
such characters in HTML. If the optional flag \var{quote} is true,
|
such characters in HTML. If the optional flag \var{quote} is true,
|
||||||
|
|
|
||||||
|
|
@ -155,10 +155,12 @@ These classes, present in earlier versions of the \code{cgi} module, are still
|
||||||
supported for backward compatibility. New applications should use the
|
supported for backward compatibility. New applications should use the
|
||||||
FieldStorage class.
|
FieldStorage class.
|
||||||
|
|
||||||
\code{SvFormContentDict}: single value form content as dictionary; assumes each
|
\code{SvFormContentDict}
|
||||||
|
single value form content as dictionary; assumes each
|
||||||
field name occurs in the form only once.
|
field name occurs in the form only once.
|
||||||
|
|
||||||
\code{FormContentDict}: multiple value form content as dictionary (the form
|
\code{FormContentDict}
|
||||||
|
multiple value form content as dictionary (the form
|
||||||
items are lists of values). Useful if your form contains multiple
|
items are lists of values). Useful if your form contains multiple
|
||||||
fields with the same name.
|
fields with the same name.
|
||||||
|
|
||||||
|
|
@ -175,18 +177,22 @@ These are useful if you want more control, or if you want to employ
|
||||||
some of the algorithms implemented in this module in other
|
some of the algorithms implemented in this module in other
|
||||||
circumstances.
|
circumstances.
|
||||||
|
|
||||||
\begin{funcdesc}{parse}{fp}: Parse a query in the environment or from a file (default \code{sys.stdin}).
|
\begin{funcdesc}{parse}{fp}
|
||||||
|
Parse a query in the environment or from a file (default \code{sys.stdin}).
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{parse_qs}{qs}: parse a query string given as a string argument (data of type
|
\begin{funcdesc}{parse_qs}{qs}
|
||||||
|
parse a query string given as a string argument (data of type
|
||||||
\code{application/x-www-form-urlencoded}).
|
\code{application/x-www-form-urlencoded}).
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{parse_multipart}{fp\, pdict}: parse input of type \code{multipart/form-data} (for
|
\begin{funcdesc}{parse_multipart}{fp\, pdict}
|
||||||
|
parse input of type \code{multipart/form-data} (for
|
||||||
file uploads). Arguments are \code{fp} for the input file and
|
file uploads). Arguments are \code{fp} for the input file and
|
||||||
\code{pdict} for the dictionary containing other parameters of \code{content-type} header
|
\code{pdict} for the dictionary containing other parameters of \code{content-type} header
|
||||||
|
|
||||||
Returns a dictionary just like \code{parse_qs()}: keys are the field names, each
|
Returns a dictionary just like \code{parse_qs()}
|
||||||
|
keys are the field names, each
|
||||||
value is a list of values for that field. This is easy to use but not
|
value is a list of values for that field. This is easy to use but not
|
||||||
much good if you are expecting megabytes to be uploaded -- in that case,
|
much good if you are expecting megabytes to be uploaded -- in that case,
|
||||||
use the \code{FieldStorage} class instead which is much more flexible. Note
|
use the \code{FieldStorage} class instead which is much more flexible. Note
|
||||||
|
|
@ -197,29 +203,36 @@ file uploads). Arguments are \code{fp} for the input file and
|
||||||
that.
|
that.
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{parse_header}{string}: parse a header like \code{Content-type} into a main
|
\begin{funcdesc}{parse_header}{string}
|
||||||
|
parse a header like \code{Content-type} into a main
|
||||||
content-type and a dictionary of parameters.
|
content-type and a dictionary of parameters.
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{test}{}: robust test CGI script, usable as main program.
|
\begin{funcdesc}{test}{}
|
||||||
|
robust test CGI script, usable as main program.
|
||||||
Writes minimal HTTP headers and formats all information provided to
|
Writes minimal HTTP headers and formats all information provided to
|
||||||
the script in HTML form.
|
the script in HTML form.
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{print_environ}{}: format the shell environment in HTML.
|
\begin{funcdesc}{print_environ}{}
|
||||||
|
format the shell environment in HTML.
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{print_form}{form}: format a form in HTML.
|
\begin{funcdesc}{print_form}{form}
|
||||||
|
format a form in HTML.
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{print_directory}{}: format the current directory in HTML.
|
\begin{funcdesc}{print_directory}{}
|
||||||
|
format the current directory in HTML.
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{print_environ_usage}{}: print a list of useful (used by CGI) environment variables in
|
\begin{funcdesc}{print_environ_usage}{}
|
||||||
|
print a list of useful (used by CGI) environment variables in
|
||||||
HTML.
|
HTML.
|
||||||
\end{funcdesc}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{escape}{s\optional{\, quote}}: convert the characters
|
\begin{funcdesc}{escape}{s\optional{\, quote}}
|
||||||
|
convert the characters
|
||||||
``\code{\&}'', ``\code{<}'' and ``\code{>}'' in string \var{s} to HTML-safe
|
``\code{\&}'', ``\code{<}'' and ``\code{>}'' in string \var{s} to HTML-safe
|
||||||
sequences. Use this if you need to display text that might contain
|
sequences. Use this if you need to display text that might contain
|
||||||
such characters in HTML. If the optional flag \var{quote} is true,
|
such characters in HTML. If the optional flag \var{quote} is true,
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue