diff -r ffa851df0825 -r 2fb8b9db1c86 symbian-qemu-0.9.1-12/python-2.6.1/Doc/library/quopri.rst --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/symbian-qemu-0.9.1-12/python-2.6.1/Doc/library/quopri.rst Fri Jul 31 15:01:17 2009 +0100 @@ -0,0 +1,64 @@ + +:mod:`quopri` --- Encode and decode MIME quoted-printable data +============================================================== + +.. module:: quopri + :synopsis: Encode and decode files using the MIME quoted-printable encoding. + + +.. index:: + pair: quoted-printable; encoding + single: MIME; quoted-printable encoding + +This module performs quoted-printable transport encoding and decoding, as +defined in :rfc:`1521`: "MIME (Multipurpose Internet Mail Extensions) Part One: +Mechanisms for Specifying and Describing the Format of Internet Message Bodies". +The quoted-printable encoding is designed for data where there are relatively +few nonprintable characters; the base64 encoding scheme available via the +:mod:`base64` module is more compact if there are many such characters, as when +sending a graphics file. + + +.. function:: decode(input, output[,header]) + + Decode the contents of the *input* file and write the resulting decoded binary + data to the *output* file. *input* and *output* must either be file objects or + objects that mimic the file object interface. *input* will be read until + ``input.readline()`` returns an empty string. If the optional argument *header* + is present and true, underscore will be decoded as space. This is used to decode + "Q"-encoded headers as described in :rfc:`1522`: "MIME (Multipurpose Internet + Mail Extensions) Part Two: Message Header Extensions for Non-ASCII Text". + + +.. function:: encode(input, output, quotetabs) + + Encode the contents of the *input* file and write the resulting quoted-printable + data to the *output* file. *input* and *output* must either be file objects or + objects that mimic the file object interface. *input* will be read until + ``input.readline()`` returns an empty string. *quotetabs* is a flag which + controls whether to encode embedded spaces and tabs; when true it encodes such + embedded whitespace, and when false it leaves them unencoded. Note that spaces + and tabs appearing at the end of lines are always encoded, as per :rfc:`1521`. + + +.. function:: decodestring(s[,header]) + + Like :func:`decode`, except that it accepts a source string and returns the + corresponding decoded string. + + +.. function:: encodestring(s[, quotetabs]) + + Like :func:`encode`, except that it accepts a source string and returns the + corresponding encoded string. *quotetabs* is optional (defaulting to 0), and is + passed straight through to :func:`encode`. + + +.. seealso:: + + Module :mod:`mimify` + General utilities for processing of MIME messages. + + Module :mod:`base64` + Encode and decode MIME base64 data +