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

From: Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Bruce Momjian <bruce(at)momjian(dot)us>, Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>, Robert Haas <robertmhaas(at)gmail(dot)com>, Steven Pousty <steve(dot)pousty(at)gmail(dot)com>, Pavel Stehule <pavel(dot)stehule(at)gmail(dot)com>, Isaac Morland <isaac(dot)morland(at)gmail(dot)com>, Pierre Giraud <pierre(dot)giraud(at)dalibo(dot)com>, PostgreSQL Developers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Poll: are people okay with function/operator table redesign?
Date: 2020-04-23 17:43:43
Message-ID: 20200423174343.GA16996@alvherre.pgsql
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

If we're doing nicer markup+CSS for this, then it might make sense to
find a better solution for this kind of entry with multiple signatures
(which was already an issue in the previous version):

text || anynonarray or anynonarray || text → text
Converts the non-string input to text, then concatenates the two
strings. (The non-string input cannot be of an array type, because that
would create ambiguity with the array || operators. If you want to
concatenate an array's text equivalent, cast it to text explicitly.)
'Value: ' || 42 → Value: 42

I think it would make sense to split the first line to put each of the
two signatures on their own line. So it would look like this:

text || anynonarray
anynonarray || text → text
Converts the non-string input to text, then concatenates the two
strings. (The non-string input cannot be of an array type, because that
would create ambiguity with the array || operators. If you want to
concatenate an array's text equivalent, cast it to text explicitly.)
'Value: ' || 42 → Value: 42

Another example:

to_ascii ( string text [, encoding name or integer ] ) → text

should be (I think):

to_ascii ( string text [, encoding name ] ) → text
to_ascii ( string text [, integer ] ) → text

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

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Tom Lane 2020-04-23 18:10:07 Re: Poll: are people okay with function/operator table redesign?
Previous Message Jehan-Guillaume de Rorthais 2020-04-23 16:59:53 Re: [BUG] non archived WAL removed during production crash recovery