From: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
---|---|
To: | Josh Kupershmidt <schmiddy(at)gmail(dot)com> |
Cc: | Peter Eisentraut <peter_e(at)gmx(dot)net>, pgsql-docs(at)postgresql(dot)org |
Subject: | Re: Large SGML Cleanup |
Date: | 2010-11-14 19:46:29 |
Message-ID: | 7535.1289763989@sss.pgh.pa.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
Josh Kupershmidt <schmiddy(at)gmail(dot)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
From | Date | Subject | |
---|---|---|---|
Next Message | Tom Lane | 2010-11-15 20:25:23 | Re: [PATCH] Fix documentation about PL/Python exception handling |
Previous Message | Josh Kupershmidt | 2010-11-14 18:45:10 | Re: Large SGML Cleanup |