pg.ddx.io pgsql-docs@postgresql.org mailing list archivehelp / color / mirror / Atom feed
Section 4.1.2.3 repeats information presented in section 4.1.1 2+ messages / 2 participants [nested] [flat]
* Section 4.1.2.3 repeats information presented in section 4.1.1 @ 2023-12-11 20:09 PG Doc comments form <noreply@postgresql.org> 2023-12-12 16:25 ` Re: Section 4.1.2.3 repeats information presented in section 4.1.1 Tom Lane <tgl@sss.pgh.pa.us> 0 siblings, 1 reply; 2+ messages in thread From: PG Doc comments form @ 2023-12-11 20:09 UTC (permalink / raw) To: pgsql-docs@lists.postgresql.org; +Cc: listeria@disroot.org The following documentation comment has been logged on the website: Page: https://www.postgresql.org/docs/16/sql-syntax-lexical.html Description: it just threw me off to read the exact same thing twice in quick succession, I'd suggest linking to section 4.1.2.3 in section 4.1.1 instead. ^ permalink raw reply [nested|flat] 2+ messages in thread
* Re: Section 4.1.2.3 repeats information presented in section 4.1.1 2023-12-11 20:09 Section 4.1.2.3 repeats information presented in section 4.1.1 PG Doc comments form <noreply@postgresql.org> @ 2023-12-12 16:25 ` Tom Lane <tgl@sss.pgh.pa.us> 0 siblings, 0 replies; 2+ messages in thread From: Tom Lane @ 2023-12-12 16:25 UTC (permalink / raw) To: listeria@disroot.org; +Cc: pgsql-docs@lists.postgresql.org PG Doc comments form <noreply@postgresql.org> writes: > The following documentation comment has been logged on the website: > Page: https://www.postgresql.org/docs/16/sql-syntax-lexical.html > Description: > it just threw me off to read the exact same thing twice in quick succession, > I'd suggest linking to section 4.1.2.3 in section 4.1.1 instead. They are *not* the same. The quoting is different and the meaning is quite different, just as "slon" and 'slon' are not equivalent in SQL. Moreover, there's little reason to assume that somebody coming to 4.1.2.3 necessarily just read 4.1.1. Perhaps it'd be better to use different example strings though? regards, tom lane ^ permalink raw reply [nested|flat] 2+ messages in thread
end of thread, other threads:[~2023-12-12 16:25 UTC | newest] Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed) -- links below jump to the message on this page -- 2023-12-11 20:09 Section 4.1.2.3 repeats information presented in section 4.1.1 PG Doc comments form <noreply@postgresql.org> 2023-12-12 16:25 ` Tom Lane <tgl@sss.pgh.pa.us>
This inbox is served by DDX for PostgreSQL; see mirroring instructions for how to clone and mirror all data and code used for this inbox