From: Tom Lane <tgl@sss.pgh.pa.us>
To: Fabien COELHO <coelho@cri.ensmp.fr>
Cc: Jonathan S. Katz <jkatz@postgresql.org>
Cc: Alvaro Herrera <alvherre@2ndquadrant.com>
Cc: pgsql-docs@lists.postgresql.org, PostgreSQL Developers <pgsql-hackers@lists.postgresql.org>
Subject: Re: Another modest proposal for docs formatting: catalog descriptions
Date: Sat, 09 May 2020 11:34:24 -0400
Message-ID: <4521.1589038464@sss.pgh.pa.us> (raw)
In-Reply-To: <alpine.DEB.2.22.394.2005090847090.914063@pseudo>
References: <20200506213810.GA29168@alvherre.pgsql>
<14800.1588805800@sss.pgh.pa.us>
<23610.1588978416@sss.pgh.pa.us>
<alpine.DEB.2.22.394.2005090847090.914063@pseudo>
Fabien COELHO <coelho@cri.ensmp.fr> writes:
>> Here's a more fully fleshed out draft for this, with stylesheet
>> markup to get extra space around the column type names.
> I find this added spacing awkward, espacially as attribute names are
> always one word anyway. I prefer the non spaced approach.
It's certainly arguable that that look is too heavy-handed. In the
attached, I knocked down the extra space from 1em to 0.25em, which
makes it quite a bit subtler --- are you any happier with this?
BTW, I don't think it's very accurate that "attribute names are
always one word" --- see the second attachment. Here if anything
I'm wanting a little more space.
> If spacing is discussed, should the layout rather try to align type
> information, eg:
I thought about that, but it seems extremely close to some of the
earlier function-table layouts that were so widely panned. The SGML
source would have to be a lot uglier too, probably with explicit use
of spanspec's on every row. It could be done no doubt, but I think
people would not see it as an improvement.
regards, tom lane
Attachments:pg-aggregate-quarter-em.png (image/png, 196.7K) downloadview imageinfo-schema-quarter-em.png (image/png, 141.5K) downloadview image
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: pgsql-docs@postgresql.org
Cc: tgl@sss.pgh.pa.us, coelho@cri.ensmp.fr, jkatz@postgresql.org, alvherre@2ndquadrant.com, pgsql-hackers@lists.postgresql.org
Subject: Re: Another modest proposal for docs formatting: catalog descriptions
In-Reply-To: <4521.1589038464@sss.pgh.pa.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox