Mailing List Archive

Update of /cvsroot/python/python/dist/src/Doc/whatsnew
In directory usw-pr-cvs1:/tmp/cvs-serv10373

Modified Files:
whatsnew23.tex
Log Message:
Document PEP 293.


Index: whatsnew23.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/whatsnew/whatsnew23.tex,v
retrieving revision 1.54
retrieving revision 1.55
diff -C2 -d -r1.54 -r1.55
*** whatsnew23.tex 7 Oct 2002 18:52:29 -0000 1.54
--- whatsnew23.tex 7 Oct 2002 19:01:07 -0000 1.55
***************
*** 493,497 ****
\section{PEP 293: Codec Error Handling Callbacks}

! XXX write this section

\begin{seealso}
--- 493,517 ----
\section{PEP 293: Codec Error Handling Callbacks}

! When encoding a Unicode string into a byte string, unencodable
! characters may be encountered. So far, Python allowed to specify the
! error processing as either ``strict'' (raise \code{UnicodeError},
! default), ``ignore'' (skip the character), or ``replace'' (with
! question mark). It may be desirable to specify an alternative
! processing of the error, e.g. by inserting an XML character reference
! or HTML entity reference into the converted string.
!
! Python now has a flexible framework to add additional processing
! strategies; new error handlers can be added with
! \function{codecs.register_error}. Codecs then can access the error
! handler with \code{codecs.lookup_error}. An equivalent C API has been
! added for codecs written in C. The error handler gets various state
! information, such as the string being converted, the position in the
! string where the error was detected, and the target encoding. It can
! then either raise an exception, or return a replacement string.
!
! Two additional error handlers have been implemented using this
! framework: ``backslashreplace'' using Python backslash quoting to
! represent the unencodable character, and ``xmlcharrefreplace'' emits
! XML character references.

\begin{seealso}