On Mon, Aug 2, 2021 at 04:27:01PM -0700, David G. Johnston wrote:
> On Mon, Aug 2, 2021 at 4:10 PM Bruce Momjian <bruce@momjian.us> wrote:
>
> On Mon, Aug 2, 2021 at 03:31:15PM -0700, David G. Johnston wrote:
> > On Mon, Aug 2, 2021 at 2:58 PM PG Doc comments form <
> noreply@postgresql.org>
> > wrote:
> >
> > quit and exit commands have been added to psql starting from psql 11
> > through
> > this commit df9f599b
> > https://git.postgresql.org/gitweb/?p=postgresql.git;a=commit;h=
> > df9f599bc6f14307252ac75ea1dc997310da5ba6
> > but it is not documented in psql documentation
> >
> >
> > All documented commands begin with a backslash - and indeed \help and \
> quit are
> > the official ways to get help and to quit psql. While the others exist
> as a
> > courtesy they are "unofficial" and thus we've chosen to not document
> them.
>
> FYI, this was mentioned in the PG 11 release notes:
>
>
>
> Yes, the OP pointed that out. It seems inconsistent...either we should
> document the addition both in the release notes and the psql page proper, or
> neither. Documenting it only in the release notes seems like the worst possible
> combination (forgetting the release notes and adding it to the documentation
> proper at least makes it "official").
I think we put it in the PG 11 release notes so people who used Postgres
previously would know this item is improved, but for new folks, it will
just work if they try it, but we don't want to encourage them to try it.
--
Bruce Momjian <bruce@momjian.us> https://momjian.us
EDB https://enterprisedb.com
If only the physical world exists, free will is an illusion.