[docs] include the "object" type in the lists of documented types (issue 16508)

vadmium+py at gmail.com vadmium+py at gmail.com
Fri Feb 2 05:54:31 EST 2018


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#newcode855
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#newcode4326
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/


More information about the docs mailing list