Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1vxChR-002x7V-15 for pgsql-general@arkaria.postgresql.org; Mon, 02 Mar 2026 23:29:17 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.96) (envelope-from ) id 1vxCgQ-003VEG-1m for pgsql-general@arkaria.postgresql.org; Mon, 02 Mar 2026 23:28:15 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1vxCgQ-003VE8-0K for pgsql-general@lists.postgresql.org; Mon, 02 Mar 2026 23:28:14 +0000 Received: from mail-oa1-x35.google.com ([2001:4860:4864:20::35]) by makus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.98.2) (envelope-from ) id 1vxCgO-000000005bt-067L for pgsql-general@lists.postgresql.org; Mon, 02 Mar 2026 23:28:13 +0000 Received: by mail-oa1-x35.google.com with SMTP id 586e51a60fabf-4042905015cso152131fac.0 for ; Mon, 02 Mar 2026 15:28:11 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1772494091; cv=none; d=google.com; s=arc-20240605; b=LYTZe40nRpTUu3Pddi/EfViemlrxJq4YtUKUOHlX9cLqYdhkzr9yOOwPCis7pNgBmh ZKpmY36GTiCnJV1wcYVWryO0EhRuydA2aFnClgO8YmYlkSiKLRCGLP0p4k8GkjPpbmoO bsL4oQEBD3SgJo/gJ+DCTHTBokGGdJUujxYMf0MbM3+uobRK1qplZHFu9yajQzGtCvFe 1rd1ZglBFVqnfLjPHyV9YwKbS8NLdp0MDcq/km4kCLSeAXzwLTv2DGRpL9wNbUnEjwAR iZ/vfrBpBfbgSKruo5I5KX3BH43SfcHBoWGh9653pFSSZoh5m/1xg9HnljFpPi8kRA1T Vebw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:dkim-signature; bh=G6sSxGo9QK4L8EJvm62l/cxliEM+o1bowUqMIEmuPi4=; fh=FO1+mytD5H8fUu5rwadZEatlIeA0Fb4iW5fGpHaYtwM=; b=jdxGmByK6MdsmUaLO96HGV8INxeONvfPyI7XEPiDwmTaZ3WVYNkb6giCtTR/iYWPHv dli39UKU5ay03POAUuet+4WdpP/DWFcaA91ZZ7jgJEEAblQz587HtvmGFj94TKxQLpbI 9LogdyPTHU9qmYfs9zZLe1v71/81BsTWbd11wAwNo3+oQvB9qMGv8cYPCbcSJiF9Q6du W4N5yKDmyUaXRzEZRMCq7hLtth48t7+MaByzSjG4DkRJvUsjvg9MEX80O293F2V32sUu MJ6ITGhKsmXYbTfvIm4VbiiV9/z7olDZh+m5P8N1lSgtPKfwPTSvMoe1bU3waQBNJAVv xgXQ==; darn=lists.postgresql.org ARC-Authentication-Results: i=1; mx.google.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1772494091; x=1773098891; darn=lists.postgresql.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=G6sSxGo9QK4L8EJvm62l/cxliEM+o1bowUqMIEmuPi4=; b=HSh8YZaFWyUMJ/pxKv0ZN7jXLl3owQcdn4NTbPLLKOeTHpIh+C7e/Oel1lA71/mvoG 09ZXKlIjQWxyLhwx2qg6YgX7SyoUq0GJF4PFXe19k6GfxuA7FYUUG8tSDtXulU+Fq0B/ jV8r/ChMiY8ixFvJEn6O2eGChcsFm4yn2NHIFfSttB1n/rw5nqFBFo6p1iLfebjHT5Bf YyUeh6u+tdizyIhvGmPDgnMcUqfe/WqrJ6jc8eaHMFNfYSDnVsiK2QmEDMX+jFV5yuvH UBSnnmIelM4BoLad75PDEHyacKbH/E7LYFqCLjHEFRUhJJDFDzPty+Hh7fnaeVFq7Cl2 seVQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1772494091; x=1773098891; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=G6sSxGo9QK4L8EJvm62l/cxliEM+o1bowUqMIEmuPi4=; b=oSGvaWFfMzVCDq4e9ucy/fjgtx0/QL80dFUuy/Euw108EBuA3q7RrbJNt9tXEd/Ovt L74gfxw6+BkfB8Tsw9T4X9he4mfhhVVMKZRB/hiW8VT6ErdW21qKmH/cW/c+r6FvPwQR m7FJV6KcxUwjA4PQZWcmNQT+0Qf3cwN1SnnuPouJFA9sERhX/mLdn70hJX59L8YceVLy BFnDjKZ1yv+hin70//tbTvSix8WpQNKbKYrfCd5ddezS71XP578bfA9i1bF1J6zsv66X Y0op9h82ZrJH2xX/4NS6aJWTff7M3w6HDpfD7O+Y1aejdZY9S4XoNp8COeIKNukzBsj5 e57Q== X-Gm-Message-State: AOJu0YwyxZD31w+/tk9bhkWkIN9yaoT0QtJEVm/w3TJOMgoyC69iQLey Hp/kCnjLGHjrFXsyexolgeiP9y2Ns6eO9mD0cBa/uKnxDmdzzNsVuvrBrI37CfkAp10DHnExqHN TdewaTpkdB8U2txwn/J2C/8HpIGyY2E8= X-Gm-Gg: ATEYQzzEY7w8S4U6A+URsX6GZ4mSe359qkK9tLABwPBSmyxYDF7QweFy/FAnRx0nmCC CLRK0APEkbX9rGpmKo14LqYWNTS/Rc1/aVUQ/g3B0rvjsnKRw16g+1jCUs/5/0HsRlc5qsxw6Vp pbbC+qy8x34WJxi14qnIbzBfBEX14VeTmJFS945K32N0IBWls/nC71R0oAF5Hg1MYNnRAidDiSf QgyxEjuWMlTx0NskmUWqCZEFXnb3/ui+r5OrxChXOeHhgRcEE6gAj6a1gnr6lfa/hQmyEC8DTkT qHdEo0w= X-Received: by 2002:a05:6870:328d:b0:415:ea02:9632 with SMTP id 586e51a60fabf-41626e17c73mr8117606fac.20.1772494091482; Mon, 02 Mar 2026 15:28:11 -0800 (PST) MIME-Version: 1.0 References: <4mdo74l7xtv7yezgtpn3okojofyf6ihqttjm67cwngyiadgjf2@c6aqv4ruxrqp> <862277.1772476946@sss.pgh.pa.us> In-Reply-To: <862277.1772476946@sss.pgh.pa.us> From: "David G. Johnston" Date: Mon, 2 Mar 2026 16:27:35 -0700 X-Gm-Features: AaiRm51nrP7Zi0m_irjhiL41Z2VIhV3qVliHkZai2j9Fyf9qfQo3yBpQU6yGtV4 Message-ID: Subject: Re: Documentation weirdness To: Tom Lane Cc: "pgsql-general@lists.postgresql.org" Content-Type: multipart/alternative; boundary="000000000000b079db064c12f0f3" List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk --000000000000b079db064c12f0f3 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Mon, Mar 2, 2026 at 11:42=E2=80=AFAM Tom Lane wrote: > "David G. Johnston" writes: > > On Monday, March 2, 2026, Peter J. Holzer wrote: > >> Would it be possible to set (column constraint) and (table constraint) > >> in the normal body font instead of monospace? That would make it clear= er > >> that these phrases aren't part of the syntax but descriptive. > > > Not sure, but I don=E2=80=99t like that as the sole solution anyway. T= oo 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 element inside a . We'd probably have to put something around the 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. PRIMARY KEY (column constraint) PRIMARY KEY...(table constraint) Can't just move the before the (... constraint) labels. David J. --000000000000b079db064c12f0f3 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
On Mon, Mar 2, 2026 at 11:42=E2=80=AFAM Tom Lane <tgl@sss.pgh.pa.us> wrote:
"David G. Johnston" <david.g.johnston@g= mail.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 constra= int)
>> in the normal body font instead of monospace? That would make it c= learer
>> that these phrases aren't part of the syntax but descriptive.<= br>
> Not sure, but I don=E2=80=99t like that as the sole solution anyway.= =C2=A0 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 i= t's all within a <term> element inside a <varlistentry>.=C2= =A0 We'd probably have to put something around the <term> to make= this work - I have no clue what if anything that might be.=C2=A0 If someon= e knows the solution here, ok, but the wording change is more than enough t= o solve the problem (and this probably the only instance of this "prob= lem" in the docs) so I don't intend to go diving down that rabbit = hole.

<varlistentry id=3D"sql-createtable-parm= s-primary-key">
<term><literal>PRIMARY KEY</liter= al> (column constraint)</term>
<term><literal>= PRIMARY KEY...(table constraint)</term>

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


--000000000000b079db064c12f0f3--