Issue #17844: Add links to encoders and decoders for bytes-to-bytes codecs.

serhiy-storchaka · serhiy-storchaka · commit 9e62d35e656f · 2013-05-22T15:33:09.000+03:00
diff --git a/Doc/library/codecs.rst b/Doc/library/codecs.rst
@@ -1188,33 +1188,33 @@ particular, the following variants typically exist:
 
 The following codecs provide bytes-to-bytes mappings.
 
-.. tabularcolumns:: |l|L|
-
-+--------------------+---------------------------+
-| Codec              | Purpose                   |
-+====================+===========================+
-| base64_codec       | Convert operand to MIME   |
-|                    | base64 (the result always |
-|                    | includes a trailing       |
-|                    | ``'\n'``)                 |
-+--------------------+---------------------------+
-| bz2_codec          | Compress the operand      |
-|                    | using bz2                 |
-+--------------------+---------------------------+
-| hex_codec          | Convert operand to        |
-|                    | hexadecimal               |
-|                    | representation, with two  |
-|                    | digits per byte           |
-+--------------------+---------------------------+
-| quopri_codec       | Convert operand to MIME   |
-|                    | quoted printable          |
-+--------------------+---------------------------+
-| uu_codec           | Convert the operand using |
-|                    | uuencode                  |
-+--------------------+---------------------------+
-| zlib_codec         | Compress the operand      |
-|                    | using gzip                |
-+--------------------+---------------------------+
+.. tabularcolumns:: |l|L|L|
+
++--------------------+---------------------------+------------------------------+
+| Codec              | Purpose                   | Encoder/decoder              |
++====================+===========================+==============================+
+| base64_codec       | Convert operand to MIME   | :meth:`base64.b64encode`,    |
+|                    | base64 (the result always | :meth:`base64.b64decode`     |
+|                    | includes a trailing       |                              |
+|                    | ``'\n'``)                 |                              |
++--------------------+---------------------------+------------------------------+
+| bz2_codec          | Compress the operand      | :meth:`bz2.compress`,        |
+|                    | using bz2                 | :meth:`bz2.decompress`       |
++--------------------+---------------------------+------------------------------+
+| hex_codec          | Convert operand to        | :meth:`base64.b16encode`,    |
+|                    | hexadecimal               | :meth:`base64.b16decode`     |
+|                    | representation, with two  |                              |
+|                    | digits per byte           |                              |
++--------------------+---------------------------+------------------------------+
+| quopri_codec       | Convert operand to MIME   | :meth:`quopri.encodestring`, |
+|                    | quoted printable          | :meth:`quopri.decodestring`  |
++--------------------+---------------------------+------------------------------+
+| uu_codec           | Convert the operand using | :meth:`uu.encode`,           |
+|                    | uuencode                  | :meth:`uu.decode`            |
++--------------------+---------------------------+------------------------------+
+| zlib_codec         | Compress the operand      | :meth:`zlib.compress`,       |
+|                    | using gzip                | :meth:`zlib.decompress`      |
++--------------------+---------------------------+------------------------------+
 
 The following codecs provide string-to-string mappings.
 
diff --git a/Misc/NEWS b/Misc/NEWS
@@ -42,7 +42,6 @@ IDLE
 
 - Issue #14146: Highlight source line while debugging on Windows.
 
-
 Tests
 -----
 
@@ -51,6 +50,8 @@ Tests
 Documentation
 -------------
 
+- Issue #17844: Add links to encoders and decoders for bytes-to-bytes codecs.
+
 - Issue #14097: improve the "introduction" page of the tutorial.
 
 - Issue #17977: The documentation for the cadefault argument's default value
