diff Doc/lib/libstdtypes.tex @ 32459:6b1ea5c07ff7 legacy-trunk

Document that encode() and decode() raise UnicodeError instead of ValueError. Add a note about error handling schemes added by PEP 293.
author Walter Dörwald <walter@livinglogic.de>
date Thu, 01 Jul 2004 19:58:47 +0000
parents b73ab309ada7
children 46e0431c9701
line wrap: on
line diff
--- a/Doc/lib/libstdtypes.tex	Thu Jul 01 19:26:04 2004 +0000
+++ b/Doc/lib/libstdtypes.tex	Thu Jul 01 19:58:47 2004 +0000
@@ -567,9 +567,11 @@
 \var{encoding} defaults to the default string encoding.  \var{errors}
 may be given to set a different error handling scheme.  The default is
 \code{'strict'}, meaning that encoding errors raise
-\exception{ValueError}.  Other possible values are \code{'ignore'} and
-\code{'replace'}.
+\exception{UnicodeError}.  Other possible values are \code{'ignore'},
+\code{'replace'} and any other name registered via
+\function{codecs.register_error}.
 \versionadded{2.2}
+\versionchanged[Support for other error handling schemes added]{2.3}
 \end{methoddesc}
 
 \begin{methoddesc}[string]{encode}{\optional{encoding\optional{,errors}}}
@@ -577,10 +579,13 @@
 default string encoding.  \var{errors} may be given to set a different
 error handling scheme.  The default for \var{errors} is
 \code{'strict'}, meaning that encoding errors raise a
-\exception{ValueError}.  Other possible values are \code{'ignore'} and
-\code{'replace'}.  For a list of possible encodings, see
-section~\ref{standard-encodings}.
+\exception{UnicodeError}.  Other possible values are \code{'ignore'},
+\code{'replace'}, \code{'xmlcharrefreplace'}, \code{'backslashreplace'}
+and any other name registered via \function{codecs.register_error}.
+For a list of possible encodings, see section~\ref{standard-encodings}.
 \versionadded{2.0}
+\versionchanged[Support for \code{'xmlcharrefreplace'} and
+\code{'backslashreplace'} and other error handling schemes added]{2.3}
 \end{methoddesc}
 
 \begin{methoddesc}[string]{endswith}{suffix\optional{, start\optional{, end}}}