Mailman 3 February 2018 - docs

[issue30516] Documentation for datetime substract operation incorrect?
by Cheryl Sabella 02 Feb '18

02 Feb '18

Change by Cheryl Sabella <chekat2(a)gmail.com>: ---------- keywords: +easy type: -> enhancement versions: +Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue30516> _______________________________________

1 0

[issue32743] Typo in hamt.c comments
by Dmitry Alimov 02 Feb '18

02 Feb '18

New submission from Dmitry Alimov <dvalimov(a)gmail.com>: In the comments to `hamt_node_collision_without` function in hamt.c module, I think should be `so convert` instead of `co convert`: ``` if (new_count == 1) { /* The node has two keys, and after deletion the new Collision node would have one. Collision nodes - with one key shouldn't exist, co convert it to a + with one key shouldn't exist, so convert it to a Bitmap node. */ ``` ---------- assignee: docs@python components: Documentation messages: 311452 nosy: delimitry, docs@python, yselivanov priority: normal severity: normal status: open title: Typo in hamt.c comments type: enhancement versions: Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32743> _______________________________________

2 3

[issue32674] minor documentation fix for '__import__'
by Qian Yun 02 Feb '18

02 Feb '18

New submission from Qian Yun <oldk1331(a)gmail.com>: This is a minor documentation for builtin function '__import__'. ---------- assignee: docs@python components: Documentation messages: 310741 nosy: Qian Yun, docs@python priority: normal severity: normal status: open title: minor documentation fix for '__import__' versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32674> _______________________________________

4 12

[issue20285] Improve object.__doc__ and help(object) output
by R. David Murray 02 Feb '18

02 Feb '18

R. David Murray <rdmurray(a)bitdance.com> added the comment: If you want to be precise you could say "The last class in every __mro__ list." ---------- nosy: +r.david.murray _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue20285> _______________________________________

1 0

Re: [docs] include the "object" type in the lists of documented types (issue 16508)
by vadmium+py＠gmail.com 02 Feb '18

02 Feb '18

I wrote some of this a long time ago, but never sent it. I agree with most of Ezio’s comments, but I won’t be updating my patch any time soon. https://bugs.python.org/review/16508/diff/15301/Doc/library/functions.rst File Doc/library/functions.rst (right): https://bugs.python.org/review/16508/diff/15301/Doc/library/functions.rst#n… Doc/library/functions.rst:855: The constructor does not accept any arguments. On 2016/01/02 01:05:54, ezio.melotti wrote: > What about: > `object` is a type used as base class for all other classes. > When called, it accepts no arguments and returns a new unique and featureless > object. I like to start sentences and paragraphs with a capital letter. Also, in Python 3, I understand “type” and “class” are the same thing, so let’s be consistent within the one sentence. Rewriting your first sentence again, how about: class object This is a base class for all other classes. When called, it accepts no arguments and returns a new unique and featureless object. https://bugs.python.org/review/16508/diff/15301/Doc/library/stdtypes.rst File Doc/library/stdtypes.rst (right): https://bugs.python.org/review/16508/diff/15301/Doc/library/stdtypes.rst#ne… Doc/library/stdtypes.rst:4326: instances of :class:`object`, the universal type. Most of these support On 2016/01/02 01:05:54, ezio.melotti wrote: > I'm not sure I would use universal here. I don’t know what I was thinking when I wrote that. Let’s drop it. https://bugs.python.org/review/16508/

1 0

[issue32747] remove trailing spaces in docstring
by Qian Yun 02 Feb '18

02 Feb '18

New submission from Qian Yun <oldk1331(a)gmail.com>: This is a simple PR that removes trailing spaces in docstring, which are found by: grep -R ' \\n\\$' . ---------- assignee: docs@python components: Documentation messages: 311484 nosy: Qian Yun, docs@python priority: normal severity: normal status: open title: remove trailing spaces in docstring versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32747> _______________________________________

2 3

[issue20285] Improve object.__doc__ and help(object) output
by Terry J. Reedy 02 Feb '18

02 Feb '18

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: I posted "Is object the most base type? (bpo-20285)" on pydev. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue20285> _______________________________________

1 0

[issue20285] Improve object.__doc__ and help(object) output
by Terry J. Reedy 02 Feb '18

02 Feb '18

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: Since this modifies the output of a library module function for a specific input, I will not backport unless and until there is agreement on doing so. ---------- versions: -Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue20285> _______________________________________

1 0

[issue20285] Improve object.__doc__ and help(object) output
by Serhiy Storchaka 02 Feb '18

02 Feb '18

Serhiy Storchaka <storchaka+cpython(a)gmail.com> added the comment: It is better to ask Guido or other language expert. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue20285> _______________________________________

1 0

[issue20285] Improve object.__doc__ and help(object) output
by Terry J. Reedy 02 Feb '18

02 Feb '18

Change by Terry J. Reedy <tjreedy(a)udel.edu>: ---------- assignee: docs@python -> terry.reedy components: +Library (Lib) stage: patch review -> commit review versions: +Python 3.6, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue20285> _______________________________________

1 0