To: Josh Kupershmidt <schmiddy@gmail.com>
cc: Peter Eisentraut <peter_e@gmx.net>, pgsql-docs@postgresql.org
Subject: Re: Large SGML Cleanup 
In-reply-to: <AANLkTikG5A7Ma9yrDAn4xEVOkVzx1pBDUQyTAu-AAn0S@mail.gmail.com> 
References: <AANLkTi=1Sm9N3Khiued9UiMfdd_TKLimMiO9mCfHtL39@mail.gmail.com>
	<1288794278.20884.2.camel@vanquo.pezone.net>
	<AANLkTikG5A7Ma9yrDAn4xEVOkVzx1pBDUQyTAu-AAn0S@mail.gmail.com>
Comments: In-reply-to Josh Kupershmidt <schmiddy@gmail.com>
	message dated "Sun, 14 Nov 2010 14:45:10 -0400"
Date: Sun, 14 Nov 2010 14:46:29 -0500
Message-ID: <7535.1289763989@sss.pgh.pa.us>
From: Tom Lane <tgl@sss.pgh.pa.us>

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