Re: Large SGML Cleanup - Mailing list pgsql-docs

From Tom Lane
Subject Re: Large SGML Cleanup
Date
Msg-id 7535.1289763989@sss.pgh.pa.us
Whole thread Raw
In response to Re: Large SGML Cleanup  (Josh Kupershmidt <schmiddy@gmail.com>)
List pgsql-docs
Josh Kupershmidt <schmiddy@gmail.com> writes:
> I think it would be a good idea to add a step in ./sgml/Makefile to
> run tidy on all the .html files produced. Anyone interested in doing
> this?

I'm a bit concerned about starting to depend on tidy as part of our
build process, because the upstream project seems in, um, rather un-tidy
shape.  I see that it's packaged for Fedora so it wouldn't be any skin
off my own nose to get it on the machine I build the docs on.  But
people who have to install it from source will be quite unhappy, because
there doesn't appear to have been an actual release in some time, maybe
not ever (the Fedora package is based on a random CVS pull, not a
published release tarball).  Note the negative comments here:

http://sourceforge.net/projects/tidy/

IOW, I don't mind if you run the html files through tidy on your own
accord, but I don't think I want it done in the Makefiles.

            regards, tom lane

pgsql-docs by date:

Previous
From: Josh Kupershmidt
Date:
Subject: Re: Large SGML Cleanup
Next
From: Tom Lane
Date:
Subject: Re: [PATCH] Fix documentation about PL/Python exception handling