Re: doc: create table improvements

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Daniel Gustafsson <daniel(at)yesql(dot)se>
Cc: Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>, jian he <jian(dot)universality(at)gmail(dot)com>, "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>, Peter Eisentraut <peter(at)eisentraut(dot)org>, PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: doc: create table improvements
Date: 2025-10-16 15:01:13
Message-ID: 1437154.1760626873@sss.pgh.pa.us
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Daniel Gustafsson <daniel(at)yesql(dot)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 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

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Aya Iwata (Fujitsu) 2025-10-16 15:04:09 RE: [PROPOSAL] Termination of Background Workers for ALTER/DROP DATABASE
Previous Message Christoph Berg 2025-10-16 14:54:24 Re: failed NUMA pages inquiry status: Operation not permitted