Re: psql's commit df9f599b is not documented - Mailing list pgsql-docs

From Tom Lane
Subject Re: psql's commit df9f599b is not documented
Date
Msg-id 1703967.1627999513@sss.pgh.pa.us
Whole thread Raw
In response to Re: psql's commit df9f599b is not documented  (Dave Cramer <davecramer@postgres.rocks>)
Responses Re: psql's commit df9f599b is not documented
List pgsql-docs
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



pgsql-docs by date:

Previous
From: "David G. Johnston"
Date:
Subject: Re: psql's commit df9f599b is not documented
Next
From: Stephen Frost
Date:
Subject: Re: psql's commit df9f599b is not documented