pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  

help / color / mirror / Atom feed
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Dave Cramer <davecramer@postgres.rocks>
Cc: Bruce Momjian <bruce@momjian.us>
Cc: David G. Johnston <david.g.johnston@gmail.com>
Cc: mali_86@outlook.com, Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: psql's commit df9f599b is not documented
Date: Tue, 03 Aug 2021 10:05:13 -0400
Message-ID: <1703967.1627999513@sss.pgh.pa.us> (raw)
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>

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





view thread (11+ messages)  latest in thread

Message-ID: <1703967.1627999513@sss.pgh.pa.us>
Permalink:  ../1703967.1627999513@sss.pgh.pa.us/
Also on:    postgresql.org/message-id/1703967.1627999513@sss.pgh.pa.us

 · 

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: tgl@sss.pgh.pa.us, davecramer@postgres.rocks, bruce@momjian.us, david.g.johnston@gmail.com, pgsql-docs@lists.postgresql.org
  Subject: Re: psql's commit df9f599b is not documented
  In-Reply-To: <1703967.1627999513@sss.pgh.pa.us>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox