[issue28749] Fixed the documentation of the mapping codec APIs

[Serhiy Storchaka]

Serhiy Storchaka added the comment:

Thanks Xiang. I forgot about comments in headers, the updated path updates them too.

> Why are you removing the introductory section on how mappings work ?

Because it is not correct. I copied it to descriptions of concrete functions with correcting it according to the peculiarity of particular function.

> Also, this wording needs to be corrected: "bytes (integers in the range from 0 to 255)". Bytes are not integers. I'd suggest to use the more correct wording "bytes strings of length 1".

The word "bytes" means here not Python bytes object, but is used in more common meaning: an integer in the range from 0 to 255.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28749>
_______________________________________