I've got a project that includes docs in perldoc format. Those .pod files are in cvs with the project.
We also generate an html version of the docs, but those html files are not part of the project in cvs. There's external tools to generate the html docs. The idea is before we roll a tarball we run the program that generates the HTML docs which places them in the source tree and then we run "make dist". And when the end-user runs "make install" those html docs will be installed. So I have two questions: First, if someone checks out from cvs (which does not include the html docs), I'd like them to still be able to run "make install" and maybe install a default index.html or README saying there's not docs in that version. Currently, running make will generate an error like: make[1]: *** No rule to make target `api.html', needed by `all-am'. Stop. I suppose there could be a configure option --disable-html and then set a variable: AM_CONDITIONAL(BUILDDOCS, test x$docs = xyes) But it would be nice if the existence of the html docs could be detected. Second, when I run make dist I'd either like to force running the command to rebuild the html docs (which is probably best) or verify that every html file is up to date (which is duplicating the work of the html generation program). Is dist-hook the way to go? Or will that happen too late in the process? Seems like that will work if I can avoid the make error above. Thanks, -- Bill Moseley [EMAIL PROTECTED]
