Re: Most-common value docs in PG 12

On 2019-Sep-26, Bruce Momjian wrote:

> On Wed, Sep 11, 2019 at 06:15:22PM -0300, Alvaro Herrera wrote:
> > On 2019-Aug-30, Bruce Momjian wrote:
> >
> > > OK, how is this patch? I didn't mention psql since I think everyone
> > > expects psql to show all information about tables and indexes.
> >
> > Why would you change perform.sgml? It seems unnecessary; the commands
> > shown work fine.
>
> I realize they work fine, but the ordering in the examples not matching
> the defined order suggests that ordering matters, but it does not.

Well, I mean exactly the other way around: the fact that the orders
don't match illustrates that the order is not important. And that is
reinforced by the explanation indicating explicitly that it does not
matter:

> > > <para>
> > > The name of a table column to be covered by the computed statistics.
> > > - At least two column names must be given.
> > > + At least two column names must be given; the order of the column names
> > > + is insignificant.
> > > </para>

--
Álvaro Herrera https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services