Subject: Re: An XSLT example script
To: Bruce Momjian <bruce@momjian.us>
References: <709d7809-d7f4-8175-47f3-4d131341bba8@purtz.de>
 <087ce24a-196d-901a-db78-a6c4bbded224@2ndquadrant.com>
 <20200421190455.GI19613@momjian.us>
Cc: =?UTF-8?Q?J=c3=bcrgen_Purtz?= <juergen@purtz.de>,
 pgsql-docs@lists.postgresql.org
From: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
Organization: 2ndQuadrant
Message-ID: <9440a5fd-e5cb-1d19-3790-ee93d1a3a7be@2ndquadrant.com>
Date: Thu, 23 Apr 2020 11:40:22 +0200
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:52.0)
 Gecko/20100101 Thunderbird/52.9.1
MIME-Version: 1.0
In-Reply-To: <20200421190455.GI19613@momjian.us>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 8bit
Precedence: bulk

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