From: Tom Lane <tgl@sss.pgh.pa.us>
To: Dave Cramer <davecramer@postgres.rocks>
cc: Bruce Momjian <bruce@momjian.us>,
        "David G. Johnston" <david.g.johnston@gmail.com>, mali_86@outlook.com,
        Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: psql's commit df9f599b is not documented
In-reply-to: 
 <CADK3HHLQCAKp+jHM2r5e_wigpyPBE+ineuVNYdj3qdziVMvkGw@mail.gmail.com>
References: <162794046650.25749.16629649309696437240@wrigleys.postgresql.org>
 <CAKFQuwYddkFFAojWojCLjKb8Uq-BEXfX3O6fCPYOAB4SLtn20A@mail.gmail.com>
 <20210802230959.GA7858@momjian.us>
 <CAKFQuwYS2H1Q6wwy33G+aERP5Y58kMeiZ0x9TpCx=qDN=KvROw@mail.gmail.com>
 <20210803000350.GA3639@momjian.us>
 <CAKFQuwZjzhj2THbxKueK6g7V2_1n7xCkSxB2AbUpJTNXFiL1HA@mail.gmail.com>
 <20210803005602.GB3639@momjian.us>
 <CADK3HHLQCAKp+jHM2r5e_wigpyPBE+ineuVNYdj3qdziVMvkGw@mail.gmail.com>
Comments: In-reply-to Dave Cramer <davecramer@postgres.rocks>
	message dated "Tue, 03 Aug 2021 06:39:21 -0400"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <1703966.1627999513.1@sss.pgh.pa.us>
Date: Tue, 03 Aug 2021 10:05:13 -0400
Message-ID: <1703967.1627999513@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/1703967.1627999513%40sss.pgh.pa.us>
Precedence: bulk

Dave Cramer <davecramer@postgres.rocks> writes:
> I would agree. If it's worth coding it's worth documenting. Unless of
> course the intention is that this is temporary.

Documenting it would mean committing to keeping it indefinitely,
which I think was exactly what people didn't want to do.  It's
a kluge and we might find ourselves backed into a situation where
we have to take it out.

> Do we have other undocumented features ?

Yup.  There are plenty of behaviors that are explained in code comments
but not anywhere user-visible.  If we tried to document absolutely
everything that someone might be curious about, the manual would be
three times its current size, but not more useful.

			regards, tom lane