From: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
To: Bruce Momjian <bruce@momjian.us>
Cc: Jürgen Purtz <juergen@purtz.de>
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: An XSLT example script
Date: Thu, 23 Apr 2020 11:40:22 +0200
Message-ID: <9440a5fd-e5cb-1d19-3790-ee93d1a3a7be@2ndquadrant.com> (raw)
In-Reply-To: <20200421190455.GI19613@momjian.us>
References: <709d7809-d7f4-8175-47f3-4d131341bba8@purtz.de>
<087ce24a-196d-901a-db78-a6c4bbded224@2ndquadrant.com>
<20200421190455.GI19613@momjian.us>
On 2020-04-21 21:04, Bruce Momjian wrote:
> On Tue, Apr 21, 2020 at 08:10:09PM +0200, Peter Eisentraut wrote:
>> On 2020-04-14 10:03, Jürgen Purtz wrote:
>>> The example "XSLT Stylesheet for Converting SQL/XML Output to HTML" is
>>> tagged as <figure>, but it isn't a figure, it's an example script.
>>
>> It's not an example, it's an actual script that you are supposed to use.
>
> Uh, the text said "example", and all the other figures we had used SVG
> files, so it didn't see to match our other markup.
>
>>> The
>>> PDF output contains lists for examples, figures and tables and shows it
>>> in the wrong list. We should change the tagging.
>>
>> Why is it wrong to make this a figure?
>
> I thought figure was just images. Was figure really right, or something
> else? This is the only script we use? programlisting maybe?
Maybe it's just easier to remove the wrapping in either <figure> or
<example> if that is confusing.
But I request that the backpatching of this be reverted. This would
renumber all the other examples and/or figures, and then it won't be
clear what future bug reports will refer to. This issue isn't that
drastic to make that worth it.
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
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: peter.eisentraut@2ndquadrant.com, bruce@momjian.us, juergen@purtz.de, pgsql-docs@lists.postgresql.org
Subject: Re: An XSLT example script
In-Reply-To: <9440a5fd-e5cb-1d19-3790-ee93d1a3a7be@2ndquadrant.com>
* 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