diff options
| -rw-r--r-- | Doc/lib/libcgi.tex | 8 | ||||
| -rw-r--r-- | Doc/libcgi.tex | 8 |
2 files changed, 10 insertions, 6 deletions
diff --git a/Doc/lib/libcgi.tex b/Doc/lib/libcgi.tex index 56643d0..4d0c5d6 100644 --- a/Doc/lib/libcgi.tex +++ b/Doc/lib/libcgi.tex @@ -219,10 +219,12 @@ content-type and a dictionary of parameters. HTML. \end{funcdesc} -\begin{funcdesc}{escape}{}: convert the characters ``\code{\&}'', ``\code{<}'' and ``\code{>}'' to HTML-safe +\begin{funcdesc}{escape}{s\optional{\, quote}}: convert the characters +``\code{\&}'', ``\code{<}'' and ``\code{>}'' in string \var{s} to HTML-safe sequences. Use this if you need to display text that might contain -such characters in HTML. To translate URLs for inclusion in the HREF -attribute of an \code{<A>} tag, use \code{urllib.quote()}. +such characters in HTML. If the optional flag \var{quote} is true, +the double quote character (\code{"}) is also translated; this helps +for inclusion in an HTML attribute value, e.g. in ``\code{<A HREF="...">}''. \end{funcdesc} diff --git a/Doc/libcgi.tex b/Doc/libcgi.tex index 56643d0..4d0c5d6 100644 --- a/Doc/libcgi.tex +++ b/Doc/libcgi.tex @@ -219,10 +219,12 @@ content-type and a dictionary of parameters. HTML. \end{funcdesc} -\begin{funcdesc}{escape}{}: convert the characters ``\code{\&}'', ``\code{<}'' and ``\code{>}'' to HTML-safe +\begin{funcdesc}{escape}{s\optional{\, quote}}: convert the characters +``\code{\&}'', ``\code{<}'' and ``\code{>}'' in string \var{s} to HTML-safe sequences. Use this if you need to display text that might contain -such characters in HTML. To translate URLs for inclusion in the HREF -attribute of an \code{<A>} tag, use \code{urllib.quote()}. +such characters in HTML. If the optional flag \var{quote} is true, +the double quote character (\code{"}) is also translated; this helps +for inclusion in an HTML attribute value, e.g. in ``\code{<A HREF="...">}''. \end{funcdesc} |