From: Tom Lane <tgl@sss.pgh.pa.us>
To: Isaac Morland <isaac.morland@gmail.com>
Cc: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
Cc: Alvaro Herrera <alvherre@2ndquadrant.com>
Cc: Robert Haas <robertmhaas@gmail.com>
Cc: Steven Pousty <steve.pousty@gmail.com>
Cc: Pavel Stehule <pavel.stehule@gmail.com>
Cc: Pierre Giraud <pierre.giraud@dalibo.com>
Cc: PostgreSQL Developers <pgsql-hackers@lists.postgresql.org>
Subject: Re: Poll: are people okay with function/operator table redesign?
Date: Sun, 19 Apr 2020 12:59:52 -0400
Message-ID: <10100.1587315592@sss.pgh.pa.us> (raw)
In-Reply-To: <CAMsGm5fAayGVzq1wy62A27LH-NL4tbdBfbHibjRuqGoMPZEL8g@mail.gmail.com>
References: <20200416230304.GA28390@alvherre.pgsql>
<17560.1587083109@sss.pgh.pa.us>
<f17a1d71-e8bf-3571-bcda-081289eccb31@2ndquadrant.com>
<26009.1587302581@sss.pgh.pa.us>
<CAMsGm5fAayGVzq1wy62A27LH-NL4tbdBfbHibjRuqGoMPZEL8g@mail.gmail.com>
Isaac Morland <isaac.morland@gmail.com> writes:
> If we were only concerned with HTML output then based on the desired
> semantics and appearance I would recommend <dl> without hesitation. Because
> of the need to produce PDF as well and my lack of knowledge of the Postgres
> documentation build process, I can't be so certain but I still suspect <dl>
> to be the best approach.
Yeah ... so a part of this problem is to persuade DocBook to generate
that.
As I mentioned upthread, I did experiment with putting a single-item
<variablelist> in each table cell. That works out to an annoying amount
of markup overhead, since variablelist is a rather overengineered
construct, but I imagine we could live with it. The real problem was
the amount of whitespace it wanted to add. We could probably hack our
way out of that with CSS for HTML output, but it was quite unclear whether
the PDF toolchain could be made to render it reasonably.
A desirable solution, perhaps, would be a <variablelist> corresponding to
the entire table with rendering customization that produces table-like
dividing lines around <varlistentry>s. I'm not volunteering to figure
out how to do that though, especially not for PDF.
In the meantime I plan to push forward with the markup approach we've
got. The editorial content should still work if we find a better
markup answer, and I'm willing to do the work of replacing the markup
as long as somebody else figures out what it should be.
regards, tom lane
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-hackers@postgresql.org
Cc: tgl@sss.pgh.pa.us, isaac.morland@gmail.com, peter.eisentraut@2ndquadrant.com, alvherre@2ndquadrant.com, robertmhaas@gmail.com, steve.pousty@gmail.com, pavel.stehule@gmail.com, pierre.giraud@dalibo.com, pgsql-hackers@lists.postgresql.org
Subject: Re: Poll: are people okay with function/operator table redesign?
In-Reply-To: <10100.1587315592@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