Mailman 3 January 2017 - docs

ipaddress Tutorial
by Jon Crawfurd 15 Jan '17

15 Jan '17

Python Team, I have an enhanced ipaddress tutorial that I like to offer the Python community, but I'm not sure what to do with it. I'm a long time network engineer learning Python for personal enrichment. The ipaddress module tutorial information that I found online is adequate, but I thought it could (and should) be enhanced, and decided to give it a go. The attached includes my enhanced documentation plus an IPv4 subnetting training program that I coded to take advantage of the ipaddress module functions. Recommendations for a next step? Cordially, Jon Crawfurd ____________________________________________________________________________ "The ultimate measure of a man is not where he stands in moments of comfort and convenience, but where he stands at times of challenge and controversy." Martin Luther King

1 0

[issue29062] Documentation link error
by Frank Millman 14 Jan '17

14 Jan '17

New submission from Frank Millman: If you call up online documentation for Python3.6, and select modules>h>hashlib, it takes you to 15.2. hashlib — BLAKE2 hash functions It should take you to 15.1. hashlib — Secure hashes and message digests ---------- assignee: docs@python components: Documentation messages: 283930 nosy: docs@python, frankmillman priority: normal severity: normal status: open title: Documentation link error type: behavior versions: Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29062> _______________________________________

7 27

[issue15527] Double parents in functions references
by Serhiy Storchaka 14 Jan '17

14 Jan '17

New submission from Serhiy Storchaka: :c:func:`PyMem_Malloc(n)` on Doc/c-api/memory.rst:109 rendered in HTML as <tt class="xref c c-func docutils literal"><span class="pre">PyMem_Malloc(1)()</span></tt> (note double parents). There are many other examples on this and other pages. The issue is actual for all modern versions of Python. ---------- assignee: docs@python components: Documentation messages: 167137 nosy: docs@python, storchaka priority: normal severity: normal status: open title: Double parents in functions references versions: Python 2.7, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15527> _______________________________________

6 22

man
by Vitaly Zdanevich 14 Jan '17

14 Jan '17

Hi, thank you for documentation. I am about this page https://docs.python.org/3/download.html - is there any way to read all Python-documentation in man of info? Take a look at this page http://php.net/download-docs.php where mentioned man-like solution `pear install doc.php.net/pman` - maybe exists something like that for Python? not only pydoc, but all content that I can download from https://docs.python.org/3/download.html ?

1 0

[issue28130] Document that time.tzset updates time module constants
by Alexander Belopolsky 12 Jan '17

12 Jan '17

New submission from Alexander Belopolsky: Reported by MAL in #22798 (msg251840): "The fact that tzset() does update the module globals is not documented." The documentation should explicitly list timezone, daylight, altzone and tzname as the globals that are updated when time.tzset() is called. ---------- assignee: docs@python components: Documentation keywords: easy messages: 276294 nosy: belopolsky, docs@python priority: normal severity: normal status: open title: Document that time.tzset updates time module constants versions: Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28130> _______________________________________

5 9

[issue29249] Pathlib glob ** bug
by Jon Walsh 12 Jan '17

12 Jan '17

Jon Walsh added the comment: Seems a bit strange to not have glob() and match() working the same though. Is there any reason for that? ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29249> _______________________________________

1 0

[issue29249] Pathlib glob ** bug
by Serhiy Storchaka 12 Jan '17

12 Jan '17

Serhiy Storchaka added the comment: ** is supported not just as a prefix. Path('./Lib').glob('**/*.py') emits the same paths as Path('.').glob('Lib/**/*.py'). But ** is supported only in glob(), not in match(). The support of ** in match() is not documented. Would be worth to document explicitly that it is not supported. ---------- assignee: -> docs@python components: +Documentation -Library (Lib) nosy: +docs@python, serhiy.storchaka stage: -> needs patch type: behavior -> enhancement versions: +Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29249> _______________________________________

1 0

-b option undocumented (issue 11681)
by ncoghlan＠gmail.com 12 Jan '17

12 Jan '17

http://bugs.python.org/review/11681/diff/19720/Doc/using/cmdline.rst File Doc/using/cmdline.rst (right): http://bugs.python.org/review/11681/diff/19720/Doc/using/cmdline.rst#newcod… Doc/using/cmdline.rst:196: Issue a warning when comparing :class:`bytes` with :class:`bytearray`. For 2.x, :class:`unicode` is the relevant cross-reference here. It may also be worth adding a second paragraph explicitly mentioning the difference from the Python 3 flag: ==== Note that, unlike the corresponding Python 3.x flag, this will NOT emit warnings for comparisons between :class:`str` and :class:`unicode`. Instead, the ``str`` instance will be implicitly decoded to ``unicode`` and Unicode comparison used. ==== http://bugs.python.org/review/11681/diff/19720/Doc/using/cmdline.rst#newcod… Doc/using/cmdline.rst:199: .. versionchanged:: 3.5 3.x versionchanged notes are left out of the 2.x docs However, this should have a "versionadded" note for 2.6 (since it was added as part of a merge back from the Py3k branch). http://bugs.python.org/review/11681/

1 0

[issue29239] Fix wrong issue number in what's new entry
by Roundup Robot 11 Jan '17

11 Jan '17

New submission from Roundup Robot: New changeset 114b03fa4c04 by Martin Panter in branch '3.6': Issue #29239: Fix --enable-optimizations bug number https://hg.python.org/cpython/rev/114b03fa4c04 New changeset 4e29c7f2b3e5 by Martin Panter in branch 'default': Issue #29239: Merge bug number from 3.6 https://hg.python.org/cpython/rev/4e29c7f2b3e5 ---------- nosy: +python-dev _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29239> _______________________________________

2 1

[issue29239] Fix wrong issue number in what's new entry
by Jim Fasarakis-Hilliard 11 Jan '17

11 Jan '17

Changes by Jim Fasarakis-Hilliard <d.f.hilliard(a)gmail.com>: ---------- assignee: docs@python components: Documentation files: fix_issue.patch keywords: patch nosy: Jim Fasarakis-Hilliard, docs@python priority: normal severity: normal status: open title: Fix wrong issue number in what's new entry versions: Python 3.6 Added file: http://bugs.python.org/file46256/fix_issue.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29239> _______________________________________

1 0