[Python-checkins] python/dist/src/Doc/lib libcodecs.tex,1.19,1.20

Wed, 30 Apr 2003 08:02:10 -0700

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1:/tmp/cvs-serv27487

Modified Files:
	libcodecs.tex 
Log Message:
- comment out \moduleauthor that broke formatting until the formatting
  tools can be fixed; added XXX comment
- general markup fixes

Index: libcodecs.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libcodecs.tex,v
retrieving revision 1.19
retrieving revision 1.20
diff -C2 -d -r1.19 -r1.20
*** libcodecs.tex	18 Apr 2003 21:48:55 -0000	1.19
--- libcodecs.tex	30 Apr 2003 15:02:07 -0000	1.20
***************
*** 545,549 ****
        graphic characters
  \item an IBM EBCDIC code page
! \item an IBM PC code page, which is ASCII compatible
  \end{itemize}

--- 545,549 ----
        graphic characters
  \item an IBM EBCDIC code page
! \item an IBM PC code page, which is \ASCII{} compatible
  \end{itemize}

***************
*** 808,817 ****
           {hex}
           {byte string}
!          {Convert operand to hexadecimal representation, with two digits per byte}

  \lineiv{idna}
           {}
           {Unicode string}
!          {Implements \rfc{3490}. \versionadded{2.3}. See also \module{encodings.idna}}

  \lineiv{mbcs}
--- 808,820 ----
           {hex}
           {byte string}
!          {Convert operand to hexadecimal representation, with two
!           digits per byte}

  \lineiv{idna}
           {}
           {Unicode string}
!          {Implements \rfc{3490}.
!           \versionadded{2.3}.
!           See also \refmodule{encodings.idna}}

  \lineiv{mbcs}
***************
*** 828,832 ****
           {}
           {Unicode string}
!          {Implements \rfc{3492}. \versionadded{2.3}}

  \lineiv{quopri_codec}
--- 831,836 ----
           {}
           {Unicode string}
!          {Implements \rfc{3492}.
!           \versionadded{2.3}}

  \lineiv{quopri_codec}
***************
*** 838,842 ****
           {}
           {Unicode string}
!          {Produce a string that is suitable as raw Unicode literal in Python source code}

  \lineiv{rot_13}
--- 842,847 ----
           {}
           {Unicode string}
!          {Produce a string that is suitable as raw Unicode literal in
!           Python source code}

  \lineiv{rot_13}
***************
*** 848,862 ****
           {}
           {byte string}
!          {Produce a string that is suitable as string literal in Python source code}

  \lineiv{undefined}
           {}
           {any}
!          {Raise an exception for all conversion. Can be used as the system encoding if no automatic coercion between byte and Unicode strings is desired.}

  \lineiv{unicode_escape}
           {}
           {Unicode string}
!          {Produce a string that is suitable as Unicode literal in Python source code}

  \lineiv{unicode_internal}
--- 853,871 ----
           {}
           {byte string}
!          {Produce a string that is suitable as string literal in
!           Python source code}

  \lineiv{undefined}
           {}
           {any}
!          {Raise an exception for all conversion. Can be used as the
!           system encoding if no automatic coercion between byte and
!           Unicode strings is desired.} 

  \lineiv{unicode_escape}
           {}
           {Unicode string}
!          {Produce a string that is suitable as Unicode literal in
!           Python source code}

  \lineiv{unicode_internal}
***************
*** 882,899 ****
  \declaremodule{standard}{encodings.idna}
  \modulesynopsis{Internationalized Domain Names implementation}
! \moduleauthor{Martin v. L\"owis}

  This module implements \rfc{3490} (Internationalized Domain Names in
  Applications) and \rfc{3492} (Nameprep: A Stringprep Profile for
  Internationalized Domain Names (IDN)). It builds upon the
! \code{punycode} encoding and \module{stringprep}. \versionadded{2.3}

! These RFCs together define a protocol to support non-ASCII characters
! in domain names. A domain name containing non-ASCII characters (such
  as ``www.Alliancefran\c{c}aise.nu'') is converted into an
! ASCII-compatible encoding (ACE, such as
  ``www.xn--alliancefranaise-npb.nu''). The ACE form of the domain name
  is then used in all places where arbitrary characters are not allowed
! by the protocol, such as DNS queries, HTTP \code{Host:} fields, and so
  on. This conversion is carried out in the application; if possible
  invisible to the user: The application should transparently convert
--- 891,912 ----
  \declaremodule{standard}{encodings.idna}
  \modulesynopsis{Internationalized Domain Names implementation}
! % XXX The next line triggers a formatting bug, so it's commented out
! % until that can be fixed.
! %\moduleauthor{Martin v. L\"owis}
! 
! \versionadded{2.3}

  This module implements \rfc{3490} (Internationalized Domain Names in
  Applications) and \rfc{3492} (Nameprep: A Stringprep Profile for
  Internationalized Domain Names (IDN)). It builds upon the
! \code{punycode} encoding and \module{stringprep}.

! These RFCs together define a protocol to support non-\ASCII{} characters
! in domain names. A domain name containing non-\ASCII{} characters (such
  as ``www.Alliancefran\c{c}aise.nu'') is converted into an
! \ASCII-compatible encoding (ACE, such as
  ``www.xn--alliancefranaise-npb.nu''). The ACE form of the domain name
  is then used in all places where arbitrary characters are not allowed
! by the protocol, such as DNS queries, HTTP \mailheader{Host} fields, and so
  on. This conversion is carried out in the application; if possible
  invisible to the user: The application should transparently convert
***************
*** 929,933 ****

  \begin{funcdesc}{ToASCCII}{label}
! Convert a label to ASCII, as specified in \rfc{3490}.
  \code{UseSTD3ASCIIRules} is assumed to be false.
  \end{funcdesc}
--- 942,946 ----

  \begin{funcdesc}{ToASCCII}{label}
! Convert a label to \ASCII, as specified in \rfc{3490}.
  \code{UseSTD3ASCIIRules} is assumed to be false.
  \end{funcdesc}