correction suggestion for https://www.postgresql.org/docs/17/auth-username-maps.html

2025-07-09 Thread PG Doc comments form
The following documentation comment has been logged on the website: Page: https://www.postgresql.org/docs/17/auth-username-maps.html Description: Dear all, Pls. let me suggest the correction for the https://www.postgresql.org/docs/17/auth-username-maps.html page. It has the following sentence: '

Re: correction suggestion for https://www.postgresql.org/docs/17/auth-username-maps.html

2025-07-09 Thread Tom Lane
"David G. Johnston" writes: > Its good as far a narrow fix goes. > But how about the attached? More invasive but covers the salient points > better, IMO, and less repetitive than having the two fields have their own > basically copy-pasted paragraphs. Meh... I initially thought that merging the

Re: correction suggestion for https://www.postgresql.org/docs/17/auth-username-maps.html

2025-07-09 Thread Tom Lane
"David G. Johnston" writes: > On Wed, Jul 9, 2025 at 7:56 AM PG Doc comments form > wrote: >> Pls. let me suggest the correction for the >> https://www.postgresql.org/docs/17/auth-username-maps.html page. >> It has the following sentence: >> ' >> If the database-username field starts with a slash

Outdated typedefs in documentation

2025-07-09 Thread Artem Fadeev
Hi, I have noticed a slight mismatch between typedefs in docs and header files. On current master branch: - CustomScanState is missing custom_ps, pscan_len and slotOps fields in docs. - `methods` field of CustomPath, CustomScan and CustomScanState is missing `struct` in type. - BrinOpcInfo.oi_

Re: correction suggestion for https://www.postgresql.org/docs/17/auth-username-maps.html

2025-07-09 Thread David G. Johnston
On Wed, Jul 9, 2025 at 7:56 AM PG Doc comments form wrote: > The following documentation comment has been logged on the website: > > Page: https://www.postgresql.org/docs/17/auth-username-maps.html > Description: > > Dear all, > Pls. let me suggest the correction for the > https://www.postgresql.

Re: correction suggestion for https://www.postgresql.org/docs/17/auth-username-maps.html

2025-07-09 Thread David G. Johnston
On Wed, Jul 9, 2025 at 9:22 AM Tom Lane wrote: > "David G. Johnston" writes: > > On Wed, Jul 9, 2025 at 7:56 AM PG Doc comments form < > nore...@postgresql.org> > > wrote: > >> Pls. let me suggest the correction for the > >> https://www.postgresql.org/docs/17/auth-username-maps.html page. > >> I

Re: correction suggestion for https://www.postgresql.org/docs/17/auth-username-maps.html

2025-07-09 Thread Tom Lane
I wrote: > "David G. Johnston" writes: >> I didn't add an example but felt the point "be referenced a single time >> within" to be needed since, usefulness not withstanding, writing \1\1 for >> database-username works but only the first instance of \1 is replaced. > Hmm, I wonder if that isn't a