Skip site navigation (1) Skip section navigation (2)

Re: Large SGML Cleanup

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 (view raw or flat)
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

In response to

pgsql-docs by date

Next:From: Tom LaneDate: 2010-11-15 20:25:23
Subject: Re: [PATCH] Fix documentation about PL/Python exception handling
Previous:From: Josh KupershmidtDate: 2010-11-14 18:45:10
Subject: Re: Large SGML Cleanup

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group