summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorNeal Norwitz <nnorwitz@gmail.com>2006-01-03 02:12:20 (GMT)
committerNeal Norwitz <nnorwitz@gmail.com>2006-01-03 02:12:20 (GMT)
commit36cbdf9596646571542f62dcb1dd77ddfcfcb85b (patch)
treee551d8dbe42215536b13571258e71510050b914c
parent1a196b5db8fb091b942eeb1223b388367054c7e4 (diff)
downloadcpython-36cbdf9596646571542f62dcb1dd77ddfcfcb85b.zip
cpython-36cbdf9596646571542f62dcb1dd77ddfcfcb85b.tar.gz
cpython-36cbdf9596646571542f62dcb1dd77ddfcfcb85b.tar.bz2
Updated doc from patch 1117398
-rw-r--r--Doc/lib/libcookielib.tex15
1 files changed, 10 insertions, 5 deletions
diff --git a/Doc/lib/libcookielib.tex b/Doc/lib/libcookielib.tex
index b55da78..125abe2 100644
--- a/Doc/lib/libcookielib.tex
+++ b/Doc/lib/libcookielib.tex
@@ -36,7 +36,9 @@ The module defines the following exception:
\begin{excdesc}{LoadError}
Instances of \class{FileCookieJar} raise this exception on failure to
-load cookies from a file.
+load cookies from a file. \note{For backwards-compatibility
+with Python 2.4 (which raised an \exception{IOError}),
+\exception{LoadError} is a subclass of \exception{IOError}}.
\end{excdesc}
@@ -273,16 +275,19 @@ Old cookies are kept unless overwritten by newly loaded ones.
Arguments are as for \method{save()}.
The named file must be in the format understood by the class, or
-\exception{LoadError} will be raised.
+\exception{LoadError} will be raised. Also, \exception{IOError} may
+be raised, for example if the file does not exist. \note{For
+backwards-compatibility with Python 2.4 (which raised
+an \exception{IOError}), \exception{LoadError} is a subclass
+of \exception{IOError}.}
\end{methoddesc}
\begin{methoddesc}[FileCookieJar]{revert}{filename=\constant{None},
ignore_discard=\constant{False}, ignore_expires=\constant{False}}
Clear all cookies and reload cookies from a saved file.
-Raises \exception{cookielib.LoadError} or \exception{IOError} if
-reversion is not successful; the object's state will not be altered if
-this happens.
+\method{revert()} can raise the same exceptions as \method{load()}.
+If there is a failure, the object's state will not be altered.
\end{methoddesc}
\class{FileCookieJar} instances have the following public attributes: