Re: Large SGML Cleanup

From: Alvaro Herrera <alvherre(at)commandprompt(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Josh Kupershmidt <schmiddy(at)gmail(dot)com>, pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Large SGML Cleanup
Date: 2010-11-03 04:12:24
Message-ID: 1288757512-sup-3380@alvh.no-ip.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Excerpts from Tom Lane's message of mié nov 03 00:15:26 -0300 2010:
> Josh Kupershmidt <schmiddy(at)gmail(dot)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.

Maybe we could have additional commands in the "check" rule to invoke
some HTML validator.

--
Álvaro Herrera <alvherre(at)commandprompt(dot)com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Josh Kupershmidt 2010-11-03 13:09:13 Re: Large SGML Cleanup
Previous Message Tom Lane 2010-11-03 03:15:26 Re: Large SGML Cleanup