2012.07.29 16:21 "Re: [Tiff] Confused about 4.0 API changes: TIFFField vs TIFFFieldInfo", by Tom Lane

Your changes look good to me. I am also no man format expert but 'man 7 man' has helped in the past. How about you commit these changes to

CVS (since it seems that you can) and we can muddle through any fine tuning of the manual pages afterward?

Done.

It does seem that the HTML version of the manual pages is produced by groff. I have not done this before but it shouldn't be too difficult.

It appears the thing to do is go into html/man and do "make htmldoc".

The libtiff configure script uses --enable-maintainer-mode so if this

> configuration option is supplied, we could add Makefile rules to

automatically update the HTML files if a man page has been edited and the suitable tools are available.

I'm a bit hesitant to suggest that this should happen automatically. The output produced by different versions of groff seems to be different in many details, so we'd wind up with huge CVS churn anytime somebody runs a build on a different machine. (Although it's fair to ask whether these derived files ought to be in CVS at all. Maybe the right answer is for them to be built while producing a release?)

regards, tom lane