On 04.01.2011 20:06, [email protected] wrote: > Author: AlbrechtS > Date: 2011-01-04 11:06:02 -0800 (Tue, 04 Jan 2011) > New Revision: 8186 > Log: > Fixed a typo and an error. We must not use "make html-dist" for distribution. > This Makefile tag is misleading and should be corrected.
To elaborate on this: We used this special tag to run "strip_tags" on the generated html files to minimize updates (date changes) for svn upload of the web docs. The distributed docs should carry the correct date (see strip_tags). We can probably remove this. We had different Makefile tags because strip_tags would run *too* long for daily use on Cygwin and maybe other older systems. Additionally the html docs should always be generated *after* the pdf docs, because they use the same html/ subdirectory, but use a different doxygen file (Doxyfile with vs. Doxybook w/o frame). If you do it in the wrong order, then the html/ directory may include the non-frame version of the doxygen docs :-( I also believe that we should use "make clean html" to ensure that the html documentation will be cleaned and generated, because of the only dependency on the html/ directory. That's not yet perfect. Yes, I just tested it, and so it is... Now that you removed documentation/fltk.pdf from svn :-) we can change "make pdf" to move documentation/latex/refman.pdf to documentation/fltk.pdf again (and remove pdf-dist). This had been done only in pdf-dist), because the generated file would overwrite the subversion file, and this was problematic for commits. The correct way to generate the docs with current svn ought to be: cd documentation make clean pdf-dist make clean html For now: be careful... Shall I try to clean up this mess? Albrecht _______________________________________________ fltk-dev mailing list [email protected] http://lists.easysw.com/mailman/listinfo/fltk-dev
