added quote and unquote

gvanrossum · gvanrossum · commit 61d34f47c39c · 1995-02-27T17:51:51.000Z
diff --git a/Doc/lib/liburllib.tex b/Doc/lib/liburllib.tex
@@ -2,7 +2,7 @@ \section{Built-in module \sectcode{urllib}}
 \stmodindex{urllib}
 \index{WWW}
 \indexii{World-Wide}{Web}
-\index{URLs}
+\index{URL}
 
 This module provides a high-level interface for fetching data across
 the World-Wide Web.  In particular, the \code{urlopen} function is
@@ -49,6 +49,21 @@ \section{Built-in module \sectcode{urllib}}
 \code{urlretrieve()}.
 \end{funcdesc}
 
+\begin{funcdesc}{quote}{string\optional{\, addsafe}}
+Replace special characters in \var{string} using the \code{\%xx} escape.
+Letters, digits, and the characters ``\code{_,.-}'' are never quoted.
+The optional \var{addsafe} parameter specifies additional characters
+that should not be quoted --- its default value is \code{'/'}.
+
+Example: \code{quote('/~conolly/')} yields \code{'/\%7econnolly/'}.
+\end{funcdesc}
+
+\begin{funcdesc}{unquote}{string}
+Remove \code{\%xx} escapes by their single-character equivalent.
+
+Example: \code{unquote('/\%7Econnolly/')} yields \code{'/~connolly/'}.
+\end{funcdesc}
+
 Restrictions:
 
 \begin{itemize}
diff --git a/Doc/liburllib.tex b/Doc/liburllib.tex
@@ -2,7 +2,7 @@ \section{Built-in module \sectcode{urllib}}
 \stmodindex{urllib}
 \index{WWW}
 \indexii{World-Wide}{Web}
-\index{URLs}
+\index{URL}
 
 This module provides a high-level interface for fetching data across
 the World-Wide Web.  In particular, the \code{urlopen} function is
@@ -49,6 +49,21 @@ \section{Built-in module \sectcode{urllib}}
 \code{urlretrieve()}.
 \end{funcdesc}
 
+\begin{funcdesc}{quote}{string\optional{\, addsafe}}
+Replace special characters in \var{string} using the \code{\%xx} escape.
+Letters, digits, and the characters ``\code{_,.-}'' are never quoted.
+The optional \var{addsafe} parameter specifies additional characters
+that should not be quoted --- its default value is \code{'/'}.
+
+Example: \code{quote('/~conolly/')} yields \code{'/\%7econnolly/'}.
+\end{funcdesc}
+
+\begin{funcdesc}{unquote}{string}
+Remove \code{\%xx} escapes by their single-character equivalent.
+
+Example: \code{unquote('/\%7Econnolly/')} yields \code{'/~connolly/'}.
+\end{funcdesc}
+
 Restrictions:
 
 \begin{itemize}
