From: Tom Lane <tgl@sss.pgh.pa.us>
To: Daniel Gustafsson <daniel@yesql.se>
cc: Laurenz Albe <laurenz.albe@cybertec.at>,
        jian he <jian.universality@gmail.com>,
        "David G. Johnston" <david.g.johnston@gmail.com>,
        Peter Eisentraut <peter@eisentraut.org>,
        PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Subject: Re: doc: create table improvements
In-reply-to: <074C7D49-996E-4A2E-B66B-80CFF3DF914A@yesql.se>
References: 
 <CAKFQuwYfMV-2SdrP-umr5SVNSqTn378BUvHsebetp5=DhT494w@mail.gmail.com>
 <ec0bd3d2-3e15-4492-b93a-683c04ec345c@eisentraut.org>
 <CAKFQuwYk7NsEAEsPEUdbc_gXB0OR+gZzmBjDcUSe5JZuE+d_iw@mail.gmail.com>
 <ae5203d1f68267b1e67cfd32023ece1367689b83.camel@cybertec.at>
 <CACJufxFgZtLENzJkZZssKdWEfHo1hk9uyC0h3JcGJJb19XRJQQ@mail.gmail.com>
 <cbc03892163dbf67980e2863b784745517a516a5.camel@cybertec.at>
 <074C7D49-996E-4A2E-B66B-80CFF3DF914A@yesql.se>
Comments: In-reply-to Daniel Gustafsson <daniel@yesql.se>
	message dated "Thu, 16 Oct 2025 15:36:18 +0200"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <1437153.1760626873.1@sss.pgh.pa.us>
Content-Transfer-Encoding: quoted-printable
Date: Thu, 16 Oct 2025 11:01:13 -0400
Message-ID: <1437154.1760626873@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/1437154.1760626873%40sss.pgh.pa.us>
Precedence: bulk

Daniel Gustafsson <daniel@yesql.se> writes:
> It's simply markup defined by DocBook to indicate what type the content =
to be
> replaced is, in this case a parameter.  While it might not make any visu=
al
> difference in our rendering, someone might be rendering the docs in anot=
her way
> where it does show a difference (like using a different font or decorati=
on to
> differentiate parameters from functions etc).

That's the theory anyway.  But we've been so massively inconsistent
in whether to use class markup or not (no doubt exactly because it
makes no difference for us) that I would expect a rendering where
it does make a difference to look really awful.

			regards, tom lane