Date: Mon, 2 Mar 2026 19:29:08 +0100
From: "Peter J. Holzer" <hjp-pgsql@hjp.at>
To: pgsql-general@lists.postgresql.org
Subject: Re: Documentation weirdness
Message-ID: <4mdo74l7xtv7yezgtpn3okojofyf6ihqttjm67cwngyiadgjf2@c6aqv4ruxrqp>
Mail-Followup-To: pgsql-general@lists.postgresql.org
References: <CA+FnnTzeE30E4kfK4=+MLe4DBORu4CdYvPQgWUYakRxfwsbEtg@mail.gmail.com>
 <CAKFQuwbefYYr-e=jS6gLJbdo9nG47_tS-inbsCCFEFYpxV+U2w@mail.gmail.com>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
	protocol="application/pgp-signature"; boundary="fc6x3fdc3rzx3xtm"
Content-Disposition: inline
In-Reply-To: <CAKFQuwbefYYr-e=jS6gLJbdo9nG47_tS-inbsCCFEFYpxV+U2w@mail.gmail.com>
Archived-At: <https://www.postgresql.org/message-id/4mdo74l7xtv7yezgtpn3okojofyf6ihqttjm67cwngyiadgjf2%40c6aqv4ruxrqp>
Precedence: bulk


--fc6x3fdc3rzx3xtm
Content-Type: text/plain; protected-headers=v1; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
Subject: Re: Documentation weirdness
MIME-Version: 1.0

On 2026-03-01 19:08:48 -0700, David G. Johnston wrote:
> On Sun, Mar 1, 2026 at 6:38=E2=80=AFPM Igor Korot <ikorot01@gmail.com> wr=
ote:
>=20
>     Hi, ALL,
>     I'm looking at https://www.postgresql.org/docs/current/sql-createtabl=
e.html
>     and see some weird stuff.
>=20
>     When I try to search for "PRIMARY KEY" I eventually hit following:
>=20
>     [quote]
>     PRIMARY KEY (column constraint)
>     PRIMARY KEY ( column_name [, ... ] [, column_name WITHOUT OVERLAPS ] )
>     [ INCLUDE ( column_name [, ...]) ] (table constraint)
>     [/quote]
>=20
>     Now I want to check what "column_constraint" is.
>=20
>=20
> You read in an underscore in the parenthetical that isn't there.=C2=A0 Th=
at said, I
> concur that using a label here that so closely matches something that exi=
sts
> within the page, to mean something else, is just asking for this kind of
> confusion.

Would it be possible to set (column constraint) and (table constraint)
in the normal body font instead of monospace? That would make it clearer
that these phrases aren't part of the syntax but descriptive.

        hjp

--=20
   _  | Peter J. Holzer    | Story must make more sense than reality.
|_|_) |                    |
| |   | hjp@hjp.at         |    -- Charles Stross, "Creative writing
__/   | http://www.hjp.at/ |       challenge!"

--fc6x3fdc3rzx3xtm
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEETtJbRjyPwVTYGJ5k8g5IURL+KF0FAmml1u4ACgkQ8g5IURL+
KF2Aew//aweV3f1ExCNEXLkEprv9zSvDDeovIOvQQDmr0MNFJeczT9HDvBeT8Bu6
iJm15DHxNWxa3tAb6CYyI1wsWh2vXAPnZ8xOQP+Uv+4tfeLy16gVnnqOlxE/J+DP
R2MgzKgUtcoKj67Qn2G1F7f2nQ483fFWE5qROiFX21axd3LSeR4HAy64xBiq3PHA
m6oCln7qb67M9/JZvcmYwwhtimJpFiyO0MdcHFiIZuo9OUd+ZMGqcMavGKunzdQo
A88WMPqfkV+DbC3FDhmEA57n4sUW50+CCZseSnumbTSRp6HtbTkhXikfoZZkRDfK
qw025AKhBFLNNllzFatUzSEi20E7YvysOM/cAuG8QaVEu4Vd/+njqDoP1cgfZTmF
gX5fPWqvP5J8lZB3SiodD1JTfxMuvEvEcwT1nlmYyCEHh6zCZYvCslisD5ZAAjHG
4SatHQyBeiVHlIA7xkkj2Suqxrr6e6avMdRaHJ0N/MFCjVmgJyB2z4Hyf4JUx4uG
E/W6p0jUiRZAqVH7B1ASw3HHCM3jK/1CaFJ+1FzrIiehfiH640BeTcgFqEJ5tnB3
7v8wGmP8jhl0Fkpw7q3Zx4xZC3Z/TScRKZWsDjv5Wgs5Iw70+e8kelZH7qyLqI+E
2NIoEsePOWmuVo+bIxFuM5c9jojGlqn6X437w+HQFGFX6nAlS08=
=Xquo
-----END PGP SIGNATURE-----

--fc6x3fdc3rzx3xtm--