On 04.01.2011, at 20:32, Albrecht Schlosser wrote: > 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.
Let's remove it then. > 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 :-( Ah, that explains the trouble I had. > 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. OK. > 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? Yes, that would be great. You seem to be much more involved than me. Thanks! - Matthias _______________________________________________ fltk-dev mailing list [email protected] http://lists.easysw.com/mailman/listinfo/fltk-dev
