public inbox for [email protected]  

help / color / mirror / Atom feed

From: David G. Johnston <[email protected]>
To: Tom Lane <[email protected]>
Cc: [email protected] <[email protected]>
Subject: Re: Documentation weirdness
Date: Mon, 2 Mar 2026 16:27:35 -0700
Message-ID: <CAKFQuwZ3VqKNsYRSsn9XO5MMHN=gc7qqUCcGQfhAAqBC4kC8Qw@mail.gmail.com> (raw)
In-Reply-To: <[email protected]>
References: <CA+FnnTzeE30E4kfK4=+MLe4DBORu4CdYvPQgWUYakRxfwsbEtg@mail.gmail.com>
	<CAKFQuwbefYYr-e=jS6gLJbdo9nG47_tS-inbsCCFEFYpxV+U2w@mail.gmail.com>
	<4mdo74l7xtv7yezgtpn3okojofyf6ihqttjm67cwngyiadgjf2@c6aqv4ruxrqp>
	<CAKFQuwaSFGv6dyC4Ka0o72Mb9MrqHn=3LdN-8C2qpsyidxwKhQ@mail.gmail.com>
	<[email protected]>

On Mon, Mar 2, 2026 at 11:42 AM Tom Lane <[email protected]> wrote:

> "David G. Johnston" <[email protected]> writes:
> > On Monday, March 2, 2026, Peter J. Holzer <[email protected]> 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.
>
>
The apparent reason the entire row is monospace is because it's all within
a <term> element inside a <varlistentry>.  We'd probably have to put
something around the <term> to make this work - I have no clue what if
anything that might be.  If someone knows the solution here, ok, but the
wording change is more than enough to solve the problem (and this probably
the only instance of this "problem" in the docs) so I don't intend to go
diving down that rabbit hole.

<varlistentry id="sql-createtable-parms-primary-key">
<term><literal>PRIMARY KEY</literal> (column constraint)</term>
<term><literal>PRIMARY KEY...(table constraint)</term>

Can't just move the </term> before the (... constraint) labels.

David J.

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected]
  Subject: Re: Documentation weirdness
  In-Reply-To: <CAKFQuwZ3VqKNsYRSsn9XO5MMHN=gc7qqUCcGQfhAAqBC4kC8Qw@mail.gmail.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox