Mailman 3 January 2020 - docs

[issue33095] Cross-reference isolated mode from relevant locations
by Nick Coghlan 04 Jan '20

04 Jan '20

New submission from Nick Coghlan <ncoghlan(a)gmail.com>: In https://bugs.python.org/issue33053#msg313966, jwilk noted that it isn't obvious from https://docs.python.org/3/using/cmdline.html#cmdoption-m how to keep the current directory from being added to `sys.path` when using the -m switch. The answer is to pass the `-I` switch as well (to activate isolated mode), but there's no cross reference to help readers discover that fact. https://docs.python.org/3/using/cmdline.html#id2 is the main documentation for isolated mode, so the steps needed to close this issue are: 1. At least add a reference from the -m switch documentation to the -I switch documentation 2. Review the other parts of the `using` docs that describe how `sys.path` is initialised, and reference the -I switch documentation where relevant ---------- assignee: docs@python components: Documentation keywords: easy messages: 314022 nosy: docs@python, jwilk, ncoghlan priority: normal severity: normal stage: needs patch status: open title: Cross-reference isolated mode from relevant locations type: enhancement versions: Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33095> _______________________________________

5 10

[issue39158] ast.literal_eval() doesn't support empty sets
by Serhiy Storchaka 04 Jan '20

04 Jan '20

Serhiy Storchaka <storchaka+cpython(a)gmail.com> added the comment: The documentation for ast.literal_eval(): Safely evaluate an expression node or a string containing a Python literal or container display. The string or node provided may only consist of the following Python literal structures: strings, bytes, numbers, tuples, lists, dicts, sets, booleans, and ``None``. https://docs.python.org/3/library/ast.html#ast.literal_eval If we are going to add support of a function call set(), we should change the documentation. And if add support of non-literals, where should we stop? Should we support also frozenset() and bytearray()? inf and nan? infj and nanj? complex()? Ellipsis? __debug__? ---------- assignee: -> docs@python components: +Documentation -Library (Lib) nosy: +docs@python resolution: fixed -> stage: resolved -> needs patch status: closed -> open _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39158> _______________________________________

1 0

[issue39183] Text divided in two strings due to wrong formatting
by Rafael Fontenelle 03 Jan '20

03 Jan '20

New submission from Rafael Fontenelle <rffontenelle(a)gmail.com>: When translating Python docs, the 'library/ensurepip' module [1] has an bullet list where one item's text is split in two due to a simple extra whitespace character. This causes two separated translations strings "``--default-pip``: if a \"default pip\" installation is requested, the" and "``pip`` script will be installed in addition to the two regular scripts." , which clearly should be a single one. Its effect can be seen also in the resulting documentation, where these strings are shown in different lines even when there are enough space in the browser window to should it all. Solution is to remove the extra space and formatting is good again. [1] https://docs.python.org/3/library/ensurepip.html ---------- assignee: docs@python components: Documentation messages: 359170 nosy: docs@python, rffontenelle priority: normal severity: normal status: open title: Text divided in two strings due to wrong formatting type: enhancement versions: Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39183> _______________________________________

3 7

Solicitud de Informacion
by Juan Castela 02 Jan '20

02 Jan '20

Estimados Sres : Me he propuesto aprender el lenguaje de programacion Python, he instalado en mi pc la ultima version del producto (3.8.1) de 32 bits, en mi portatil tengo Windows XP Profesional de 64 bits pero la version de Python de 64 bits no la encuentro en su pagina web, dentro de poco tiempo actualizare mi portatil a Windows 10. ¿ Existe una version de Python 3.8.1 de 64 bits ? y si es asi como puedo descargarla. Me gustaria disponer de todos los manuales que aparecen en su pagina web en la version en castellano pero al bajar los PDF en zip solo estan en ingles, podrian decirme como puedo conseguir bajar la version que deseo. Muchas gracias y aprovecho esta oportunidad para enviarles un cordial saludo. Juan Castela Hernandez

1 0

Re: argparse: append action with default list adds to list instead of overriding (issue 16399)
by roy＠panix.com 02 Jan '20

02 Jan '20

This looks basically fine, but I'd leave off "This means that". http://bugs.python.org/review/16399/

1 0

[issue16399] argparse: append action with default list adds to list instead of overriding
by hai shi 02 Jan '20

02 Jan '20

hai shi <shihai1991(a)126.com> added the comment: I update the doc of argparse and think this bpo could be closed when PR merged. ---------- nosy: +rhettinger _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue16399> _______________________________________

1 0

[issue16399] argparse: append action with default list adds to list instead of overriding
by hai shi 02 Jan '20

02 Jan '20

Change by hai shi <shihai1991(a)126.com>: ---------- nosy: +shihai1991 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue16399> _______________________________________

1 0

[issue16399] argparse: append action with default list adds to list instead of overriding
by hai shi 01 Jan '20

01 Jan '20

Change by hai shi <shihai1991(a)126.com>: ---------- pull_requests: +17226 stage: -> patch review pull_request: https://github.com/python/cpython/pull/17793 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue16399> _______________________________________

1 0

[issue39181] Add `os.makedirs()` as `Path.mkdir()` equivalent in correspondence table
by jack1142 01 Jan '20

01 Jan '20

New submission from jack1142 <kuba.kuczys(a)gmail.com>: https://github.com/python/cpython/blob/3.7/Doc/library/pathlib.rst#correspo… The table mapping `os` functions to `Path`'s equivalents is missing `os.makedirs` in the row with `Path.mkdir()` and they are both equivalent when `Path.mkdir()` is used with `parents=True` kwarg. I can make a PR once this gets triaged, I'm not sure if this doc improvement should only be made to master branch or also 3.7/3.8 so let me know about that too, thanks. ---------- assignee: docs@python components: Documentation messages: 359162 nosy: docs@python, jack1142 priority: normal severity: normal status: open title: Add `os.makedirs()` as `Path.mkdir()` equivalent in correspondence table type: enhancement versions: Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39181> _______________________________________

1 0

[issue39180] Missing getlines func documentation from linecache module
by Khalid Mammadov 01 Jan '20

01 Jan '20

Change by Khalid Mammadov <khalidmammadov9(a)gmail.com>: ---------- assignee: docs@python components: Documentation nosy: docs@python, khalidmammadov priority: normal severity: normal status: open title: Missing getlines func documentation from linecache module versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39180> _______________________________________

1 0

docs January 2020