[docs] [issue33449] Documentation for email.charset confusing about the location of constants
report at bugs.python.org
Wed May 9 13:38:58 EDT 2018
New submission from Francois Labelle <quantum.omega at gmail.com>:
When mentioning the constants contained in the module email.charset, the documentation prefixes them with "Charset", for example: Charset.QP, Charset.BASE64, Charset.SHORTEST. This suggests that the constants can be found on the class "Charset" (uppercase first letter) in the module, while they are in fact contained in the the "charset" (lowercase first letter) module itself.
This is probably a left-over from when the module was called email.Charset (in 2.2 I believe). Under Python 2.7, while the documentation uses the same nomenclature, at least the module is also importable under the name email.Charset so it makes more sense.
assignee: docs at python
nosy: Francois Labelle, docs at python
title: Documentation for email.charset confusing about the location of constants
versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8
Python tracker <report at bugs.python.org>
More information about the docs