agora inbox for pgsql-docs@postgresql.org
help / color / mirror / Atom feedFrom: PG Doc comments form <noreply@postgresql.org>
To: pgsql-docs@lists.postgresql.org
Cc: gri.bogdan.2020@gmail.com
Subject: Some comments on PL/Python documentation
Date: Sun, 29 Dec 2024 00:48:25 +0000
Message-ID: <173543330569.680.6706329879058172623@wrigleys.postgresql.org> (raw)
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/17/plpython-data.html
Description:
Hello,
In my opinion, some phrases on this page are not quite correct.
44.2.4. Composite Types
You say: '...Object (any object providing method __getattr__)...'
Actually, the object class provides the __getattribute__() method but not
the __getattr__() method.
See https://docs.python.org/3/reference/datamodel.html#object.__getattr__
44.2.5. Set-Returning Functions
1. You say: '...Sequence type (tuple, list, set)...'
Being an unordered collection, sets do not record element position or order
of insertion. Accordingly, sets do not support indexing, slicing, or other
sequence-like behavior.
See
https://docs.python.org/3/library/stdtypes.html#set-types-set-frozenset
2. You say: '...Iterator (any object providing __iter__ and next
methods)...'
Actually, the iterator objects must support the __next__() method.
See https://docs.python.org/3/glossary.html#term-iterator
Regards,
Bogdan Grigorenko
view thread (3+ messages) latest in thread
Message-ID: <173543330569.680.6706329879058172623@wrigleys.postgresql.org>
Permalink: ../173543330569.680.6706329879058172623@wrigleys.postgresql.org/
Also on: postgresql.org/message-id/173543330569.680.6706329879058172623@wrigleys.postgresql.org
reply
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: noreply@postgresql.org, pgsql-docs@lists.postgresql.org, gri.bogdan.2020@gmail.com
Subject: Re: Some comments on PL/Python documentation
In-Reply-To: <173543330569.680.6706329879058172623@wrigleys.postgresql.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox