[Python-checkins] docs 36789: resolve incorrect note regarding UTF-8 (GH-13111)

[Cheryl Sabella]

https://github.com/python/cpython/commit/f98c3c59c0930ee41175d8935f72bfeed5fee17a
commit: f98c3c59c0930ee41175d8935f72bfeed5fee17a
branch: master
author: redshiftzero <jen at freedom.press>
committer: Cheryl Sabella <cheryl.sabella at gmail.com>
date: 2019-05-17T06:44:17-04:00
summary:

docs 36789: resolve incorrect note regarding UTF-8 (GH-13111)

files:
M Doc/howto/unicode.rst

diff --git a/Doc/howto/unicode.rst b/Doc/howto/unicode.rst
index 7b2d7b8abf87..24c3235e4add 100644
--- a/Doc/howto/unicode.rst
+++ b/Doc/howto/unicode.rst
@@ -135,17 +135,22 @@ used than UTF-8.)  UTF-8 uses the following rules:
 UTF-8 has several convenient properties:
 
 1. It can handle any Unicode code point.
-2. A Unicode string is turned into a sequence of bytes containing no embedded zero
-   bytes.  This avoids byte-ordering issues, and means UTF-8 strings can be
-   processed by C functions such as ``strcpy()`` and sent through protocols that
-   can't handle zero bytes.
+2. A Unicode string is turned into a sequence of bytes that contains embedded
+   zero bytes only where they represent the null character (U+0000). This means
+   that UTF-8 strings can be processed by C functions such as ``strcpy()`` and sent
+   through protocols that can't handle zero bytes for anything other than
+   end-of-string markers.
 3. A string of ASCII text is also valid UTF-8 text.
 4. UTF-8 is fairly compact; the majority of commonly used characters can be
    represented with one or two bytes.
 5. If bytes are corrupted or lost, it's possible to determine the start of the
    next UTF-8-encoded code point and resynchronize.  It's also unlikely that
    random 8-bit data will look like valid UTF-8.
-
+6. UTF-8 is a byte oriented encoding. The encoding specifies that each
+   character is represented by a specific sequence of one or more bytes. This
+   avoids the byte-ordering issues that can occur with integer and word oriented
+   encodings, like UTF-16 and UTF-32, where the sequence of bytes varies depending
+   on the hardware on which the string was encoded.
 
 
 References