Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences - Mailing list pgsql-hackers

From Karl O. Pinc
Subject Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences
Date
Msg-id 20230120142225.3d3be8a3@slate.karlpinc.com
Whole thread Raw
In response to Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences  (Alvaro Herrera <alvherre@alvh.no-ip.org>)
Responses Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences
Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences
List pgsql-hackers
On Fri, 20 Jan 2023 20:12:38 +0100
Alvaro Herrera <alvherre@alvh.no-ip.org> wrote:

> Ah, I wanted to attach the two remaining patches and forgot. 

Attached are 2 alternatives:
(They touch separate files so the ordering is meaningless.)


v8-0001-List-trusted-and-obsolete-extensions.patch

Instead of putting [trusted] and [obsolete] in the titles
of the modules, like v7 does, add a list of them into the text.


v8-0002-Page-break-before-sect1-in-contrib-appendix-when-pdf.patch

This frobs the PDF style sheet so that when sect1 is used
in the appendix for the contrib directory, there is a page
break before every sect1.  This puts each module/extension
onto a separate page, but only for the contrib appendix.

Aside from hardcoding the "contrib" id, which I suppose isn't
too bad since it's publicly exposed as a HTML anchor (or URL 
component?) and unlikely to change, this also means that the 
contrib documentation can't use <section> instead of <sect1>.

Sometimes I think I only know enough XSLT to get into trouble.
While v8 is "right", I can't say if it is a good idea/good practice.

Regards,

Karl <kop@karlpinc.com>
Free Software:  "You don't pay back, you pay forward."
                 -- Robert A. Heinlein

Attachment

pgsql-hackers by date:

Previous
From: Nathan Bossart
Date:
Subject: Re: Change xl_hash_vacuum_one_page.ntuples from int to uint16
Next
From: Dmitry Dolgov
Date:
Subject: Re: Schema variables - new implementation for Postgres 15 (typo)