Re: Large SGML Cleanup - Mailing list pgsql-docs

From Tom Lane
Subject Re: Large SGML Cleanup
Date
Msg-id 23257.1288754126@sss.pgh.pa.us
Whole thread Raw
In response to Large SGML Cleanup  (Josh Kupershmidt <schmiddy@gmail.com>)
Responses Re: Large SGML Cleanup  (Alvaro Herrera <alvherre@commandprompt.com>)
Re: Large SGML Cleanup  (Josh Kupershmidt <schmiddy@gmail.com>)
List pgsql-docs
Josh Kupershmidt <schmiddy@gmail.com> writes:
> This HTML fails validation, as one isn't supposed to be stuffing
> tables inside <p> nodes. The attached patch fixes all the instances of
> this I could find, by closing out <para> nodes before beginning lists
> and tables.

I think this isn't even worth thinking about applying, unless you can
provide a way to get future cases of that to fail during "make html".
The chances that it'll stay fixed without such a check are not
distinguishable from zero.

An alternative that might be more workable is to fix the toolchain
so that it generates valid HTML from what is evidently perfectly
acceptable SGML.

            regards, tom lane

pgsql-docs by date:

Previous
From: Josh Kupershmidt
Date:
Subject: Large SGML Cleanup
Next
From: Alvaro Herrera
Date:
Subject: Re: Large SGML Cleanup