[issue24563] Encoding declaration: doc supported encodings
Martin Panter added the comment: You can remove the “.. XXX” line; I understand it is just like a TODO comment, and with this fixed it would no longer be relevant. I suggest putting the links next to the sentence that ends “. . . the encoding name must be recognized by Python.” The links should be internal links, rather than hard-coded Internet links to another version of the documentation. See https://docs.python.org/devguide/documenting.html#cross-linking-markup. The Standard Encodings section already has a label already set up for you to use :) -- nosy: +vadmium stage: needs patch - patch review ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue24563 ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue24563] Encoding declaration: doc supported encodings
Martin Panter added the comment: PEP 263 doesn’t say exactly what encodings are supported. It mentions Shift JIS is supported, but UTF-16 is not. Only UTF-8 is allowed if the file starts with a UTF-8 BOM. I guess many of the Python-specific text encodings from the second section may be supported. Probably any text encoding in general, as long as the first one or two lines can “rougly” be parsed in ASCII. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue24563 ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue24563] Encoding declaration: doc supported encodings
Sameer Kulkarni added the comment: I have added link to Standard Encodings : https://docs.python.org/3/library/codecs.html#standard-encodings and Python Specific Encodings : https://docs.python.org/3/library/codecs.html#python-specific-encodings -- keywords: +patch nosy: +ksameersrk Added file: http://bugs.python.org/file39884/encoding_links.patch ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue24563 ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue24563] Encoding declaration: doc supported encodings
New submission from Terry J. Reedy: The source .rst for https://docs.python.org/3/reference/lexical_analysis.html#encoding-declarations has at the end: .. XXX there should be a list of supported encodings. While I believe this is impractical, there could be a link to https://docs.python.org/3/library/codecs.html#standard-encodings -- and possible subsubsections that follow. Are the latter supported for Python code? -- assignee: docs@python components: Documentation messages: 246233 nosy: docs@python, terry.reedy priority: normal severity: normal stage: needs patch status: open title: Encoding declaration: doc supported encodings type: enhancement versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue24563 ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com