From: Tom Lane <tgl@sss.pgh.pa.us>
To: "David G. Johnston" <david.g.johnston@gmail.com>
cc: "pgsql-general@lists.postgresql.org" <pgsql-general@lists.postgresql.org>
Subject: Re: Documentation weirdness
In-reply-to: <CAKFQuwaSFGv6dyC4Ka0o72Mb9MrqHn=3LdN-8C2qpsyidxwKhQ@mail.gmail.com>
References: <CA+FnnTzeE30E4kfK4=+MLe4DBORu4CdYvPQgWUYakRxfwsbEtg@mail.gmail.com> <CAKFQuwbefYYr-e=jS6gLJbdo9nG47_tS-inbsCCFEFYpxV+U2w@mail.gmail.com> <4mdo74l7xtv7yezgtpn3okojofyf6ihqttjm67cwngyiadgjf2@c6aqv4ruxrqp> <CAKFQuwaSFGv6dyC4Ka0o72Mb9MrqHn=3LdN-8C2qpsyidxwKhQ@mail.gmail.com>
Comments: In-reply-to "David G. Johnston" <david.g.johnston@gmail.com>
	message dated "Mon, 02 Mar 2026 11:36:09 -0700"
MIME-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Content-ID: <862276.1772476946.1@sss.pgh.pa.us>
Content-Transfer-Encoding: 8bit
Date: Mon, 02 Mar 2026 13:42:26 -0500
Message-ID: <862277.1772476946@sss.pgh.pa.us>
Archived-At: <https://www.postgresql.org/message-id/862277.1772476946%40sss.pgh.pa.us>
Precedence: bulk

"David G. Johnston" <david.g.johnston@gmail.com> writes:
> On Monday, March 2, 2026, Peter J. Holzer <hjp-pgsql@hjp.at> wrote:
>> 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.

> Not sure, but I don’t like that as the sole solution anyway.  Too subtle.

Agreed, but we could/should do it along with modifying the text.
I thought your addition of "variant" was a good idea.
I didn't look closely at the rest of your diff.

			regards, tom lane