Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences

Karl O. Pinc <kop@karlpinc.com>

From: "Karl O. Pinc" <kop@karlpinc.com>
To: Alvaro Herrera <alvherre@alvh.no-ip.org>
Cc: Greg Stark <stark@mit.edu>, "Gregory Stark (as CFM)" <stark.cfm@gmail.com>, "Jonathan S. Katz" <jkatz@postgresql.org>, Daniel Gustafsson <daniel@yesql.se>, w^3 <pgsql-www@lists.postgresql.org>
Date: 2023-03-20T20:20:38Z
Lists: pgsql-hackers
Hi,

There seems to be a problem with the html generated
for the public-facing Postgresql docs.

I'm looking at the contrib page in the devel docs,
on the pg website:

https://www.postgresql.org/docs/devel/contrib.html

The simplelist holding the list of trusted extensions,
in doc/src/sgml/contrib.sgml, is inside the paragraph.

But when I look at the delivered html, I see the table
outside of the paragraph.  And the vertical spacing
looks poor as a result.

Alvaro moved the simplelist into the paragraph to
fix just this problem.

Building HEAD (of master) on my computer (Debian 11.6)
what I see is the generation of two paragraphs,
one with the leading text and a second that contains
the simplelist table.  (Er, why 2 paragraphs instead
of just one paragraph with both text and table in
it I can't say.)

The html built on my computer has vertical spacing
that looks good.

Could it be that the build system has out-of-date
docbook xslt?  In any case, it looks like what's
produced for the world to see is different from what
Alvaro and I are seeing.

Regards,

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

P.S.  I don't know what html Alvero is generating,
but his looks good and what's on postgresql.org does
not look good.  So I assume that he's getting something
different from what the public sees now.



Commits

  1. Remove new <para id="contrib-obsolete">.

  2. doc/PDF: Add page breaks for <sect1> in contrib appendix

  3. doc: Add lists of modules trusted/obsolete

  4. HTML docs: Add padding to table.simplelist for more readable output

  5. Describe each contrib module in its SGML section title