public inbox for [email protected]  
help / color / mirror / Atom feed
From: Tom Lane <[email protected]>
To: Daniel Gustafsson <[email protected]>
Cc: Laurenz Albe <[email protected]>
Cc: jian he <[email protected]>
Cc: David G. Johnston <[email protected]>
Cc: Peter Eisentraut <[email protected]>
Cc: PostgreSQL Hackers <[email protected]>
Subject: Re: doc: create table improvements
Date: Thu, 16 Oct 2025 11:01:13 -0400
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <CAKFQuwYfMV-2SdrP-umr5SVNSqTn378BUvHsebetp5=DhT494w@mail.gmail.com>
	<[email protected]>
	<CAKFQuwYk7NsEAEsPEUdbc_gXB0OR+gZzmBjDcUSe5JZuE+d_iw@mail.gmail.com>
	<[email protected]>
	<CACJufxFgZtLENzJkZZssKdWEfHo1hk9uyC0h3JcGJJb19XRJQQ@mail.gmail.com>
	<[email protected]>
	<[email protected]>

Daniel Gustafsson <[email protected]> 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 visual
> difference in our rendering, someone might be rendering the docs in another way
> where it does show a difference (like using a different font or decoration 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





view thread (15+ messages)  latest in thread

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], [email protected], [email protected], [email protected], [email protected]
  Subject: Re: doc: create table improvements
  In-Reply-To: <[email protected]>

* 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