Re: Poll: are people okay with function/operator table redesign? - Mailing list pgsql-hackers

From Robert Haas
Subject Re: Poll: are people okay with function/operator table redesign?
Date
Msg-id CA+TgmoZk9QXBRsi3BNgSp4iLkK0_BPe606bWfJ=xqyDqncsusA@mail.gmail.com
Whole thread Raw
In response to Poll: are people okay with function/operator table redesign?  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-hackers
On Mon, Apr 13, 2020 at 1:13 PM Tom Lane <tgl@sss.pgh.pa.us> wrote:
> As discussed in the thread at [1], I've been working on redesigning
> the tables we use to present SQL functions and operators.  The
> first installment of that is now up; see tables 9.30 and 9.31 at
>
> https://www.postgresql.org/docs/devel/functions-datetime.html
>
> and table 9.33 at
>
> https://www.postgresql.org/docs/devel/functions-enum.html
>
> Before I spend more time on this, I want to make sure that people
> are happy with this line of attack.  Comparing these tables to
> the way they look in v12, they clearly take more vertical space;
> but at least to my eye they're less cluttered and more readable.
> They definitely scale a lot better for cases where a long function
> description is needed, or where we'd like to have more than one
> example.  Does anyone prefer the old way, or have a better idea?

I find the new way quite hard to read. I prefer the old way.

-- 
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company



pgsql-hackers by date:

Previous
From: Jesse Zhang
Date:
Subject: Re: Properly mark NULL returns in numeric aggregates
Next
From: Robert Haas
Date:
Subject: documenting the backup manifest file format