Re: nchar is undocumented

2024-05-04 Thread David Rowley
On Sun, 5 May 2024 at 12:41, Erik Wienhold wrote: > So, I think we should either remove that one nchar instance (because it > doesn't add any real value) or document it properly. The attached patch > does the latter. It seems easier to do the former, that way we don't need to reconsider Peter's

nchar is undocumented

2024-05-04 Thread Erik Wienhold
While studying the parser, I noticed that we support nchar and the n'' literal. But both concepts are undocumented. That may be intentional because nchar is just an alias for char and because all our string types are multibyte and therefore essentially national character strings. I was looking t

Missing examples for hash partitioning

2024-05-04 Thread PG Doc comments form
The following documentation comment has been logged on the website: Page: https://www.postgresql.org/docs/16/ddl-partitioning.html Description: There is no example showing the syntax of Hash Partitioning in this section of the documentation, it's missing.

Re: RETURNING order guarantees documentation

2024-05-04 Thread Tom Lane
"David G. Johnston" writes: > On Sat, May 4, 2024, 10:13 Dan Wainwright wrote: >> 'Similar to' doesn't provide anything concrete to the reader. There was a >> thread >> on [Hackers] >> >> back in 2015 proposing some docs

Re: RETURNING order guarantees documentation

2024-05-04 Thread David G. Johnston
On Sat, May 4, 2024, 10:13 Dan Wainwright wrote: > > 'Similar to' doesn't provide anything concrete to the reader. There was a > thread > on [Hackers] > > back in 2015 proposing some docs to clearly explain that ordering

RETURNING order guarantees documentation

2024-05-04 Thread Dan Wainwright
Hi, I was looking for documentation on the ordering guarantees of RETURNING statements relative to the input data and found that there is nothing explicit. The insert docs state > If the INSERT command contains a RETURNING clause, the result will be similar to that of a SELECT statement containing