Section 4.1.2.3 repeats information presented in section 4.1.1

Started by PG Bug reporting formover 2 years ago2 messagesdocs
Jump to latest
#1PG Bug reporting form
noreply@postgresql.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.

#2Tom Lane
tgl@sss.pgh.pa.us
In reply to: PG Bug reporting form (#1)
Re: Section 4.1.2.3 repeats information presented in section 4.1.1

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