Re: Poll: are people okay with function/operator table redesign?

Tom Lane <tgl@sss.pgh.pa.us>

From: Tom Lane <tgl@sss.pgh.pa.us>
To: Victor Yegorov <vyegorov@gmail.com>
Cc: PostgreSQL Developers <pgsql-hackers@lists.postgresql.org>
Date: 2020-04-20T14:21:14Z
Lists: pgsql-hackers
Victor Yegorov <vyegorov@gmail.com> writes:
> While table 9.5 with functions looks quite nice, I quite dislike 9.4 with
> operators.
> Previously, I could lookup operator in the leftmost column and read on.
> Right now I have to look through the whole table (well, not really, but
> still) to find the operator.

Aside from the alternatives already discussed, the only other idea
that's come to my mind is to write operator entries in a style like

	|| as in: text || text → text
		Concatenates the two strings.
		'Post' || 'greSQL' → PostgreSQL

Not sure that that's any better, but it is another alternative.

			regards, tom lane



Commits

  1. Doc: re-re-revise markup for tables of functions.

  2. Doc: revise formatting of function/operator tables.