[Olena-patches] last-svn-commit-33-gd510e3e Have Doxygen generate its outputs in the build directory.

* doc/Doxyfile.in (OUTPUT_DIRECTORY): s,@srcdir@/user/,@builddir@/user-refman.tmp,. (EXCLUDE): Adjust. * doc/Makefile.am (edit_devel): Adjust. ($(srcdir)/user-refman.stamp) ($(srcdir)/devel-refman.stamp) (maintainer-clean-local): Adjust targets. --- milena/ChangeLog | 13 +++++++++++++ milena/doc/.gitignore | 2 -- milena/doc/Doxyfile.in | 4 +--- milena/doc/Makefile.am | 22 +++++++++------------- 4 files changed, 23 insertions(+), 18 deletions(-) diff --git a/milena/ChangeLog b/milena/ChangeLog index 70f35b2..8ca0adf 100644 --- a/milena/ChangeLog +++ b/milena/ChangeLog @@ -1,5 +1,18 @@ 2010-03-08 Roland Levillain <roland(a)lrde.epita.fr> + Have Doxygen generate its outputs in the build directory. + + * doc/Doxyfile.in (OUTPUT_DIRECTORY): + s,@srcdir@/user/,@builddir@/user-refman.tmp,. + (EXCLUDE): Adjust. + * doc/Makefile.am (edit_devel): Adjust. + ($(srcdir)/user-refman.stamp) + ($(srcdir)/devel-refman.stamp) + (maintainer-clean-local): + Adjust targets. + +2010-03-08 Roland Levillain <roland(a)lrde.epita.fr> + Reorganize doc/Makefile.am. * doc/Makefile.am (edit, $(DOXYFILE_USER)): diff --git a/milena/doc/.gitignore b/milena/doc/.gitignore index 4b96d25..9c55456 100644 --- a/milena/doc/.gitignore +++ b/milena/doc/.gitignore @@ -1,9 +1,7 @@ /Doxyfile_devel /Doxyfile_user -/devel /devel-refman /devel-refman.pdf -/user /user-refman /user-refman.pdf /figures/*.png diff --git a/milena/doc/Doxyfile.in b/milena/doc/Doxyfile.in index a8c3400..5b20a7c 100644 --- a/milena/doc/Doxyfile.in +++ b/milena/doc/Doxyfile.in @@ -22,7 +22,7 @@ #--------------------------------------------------------------------------- PROJECT_NAME = "Milena (@PACKAGE_NAME@)" PROJECT_NUMBER = "User documentation @PACKAGE_VERSION@ @ID@" -OUTPUT_DIRECTORY = @srcdir@/user/ +OUTPUT_DIRECTORY = @builddir@/user-refman.tmp CREATE_SUBDIRS = YES OUTPUT_LANGUAGE = English BRIEF_MEMBER_DESC = YES @@ -101,9 +101,7 @@ EXCLUDE = @top_srcdir@/milena/sandbox \ @top_srcdir@/milena/trash \ @top_srcdir@/milena/mln/core/concept/proxy.hxx \ @top_srcdir@/milena/doc/examples/trash \ - @top_srcdir@/milena/doc/user \ @top_srcdir@/milena/doc/user-refman - @top_srcdir@/milena/doc/devel \ @top_srcdir@/milena/doc/devel-refman @top_srcdir@/milena/tests/unit_test EXCLUDE_SYMLINKS = YES diff --git a/milena/doc/Makefile.am b/milena/doc/Makefile.am index d53c208..49cf5a5 100644 --- a/milena/doc/Makefile.am +++ b/milena/doc/Makefile.am @@ -113,8 +113,6 @@ $(srcdir)/$(USER_REFMAN_PDF): $(srcdir)/$(USER_REFMAN) cd $(srcdir)/$(USER_REFMAN)/latex && $(MAKE) $(AM_MAKEFLAGS) pdf cp -f $(srcdir)/$(USER_REFMAN)/latex/refman.pdf $@ -## FIXME: Use a variable instead of `$(srcdir)/user' directly? -## ## FIXME: Are dependencies $(srcdir)/figures.stamp $(EXTRA_DEPS) set ## on the right rule? Does Doxygen make a copy of figures, or does it ## generate LaTeX inputs relying on the existence of such figures in @@ -122,15 +120,15 @@ $(srcdir)/$(USER_REFMAN_PDF): $(srcdir)/$(USER_REFMAN) $(srcdir)/user-refman.stamp: $(srcdir)/$(DOXYFILE).in $(srcdir)/figures.stamp $(EXTRA_DEPS) @rm -f $@.tmp @touch $@.tmp - -rm -rf $(srcdir)/user + -rm -rf $(USER_REFMAN).tmp $(MAKE) $(AM_MAKE_FLAGS) $(DOXYFILE_USER) $(DOXYGEN) $(DOXYFILE_USER) ## Doxygen may generate an incomplete output and exit with success! ## Check some files before deeming the output as acceptable. - test -f $(srcdir)/user/latex/refman.tex + test -f $(USER_REFMAN).tmp/latex/refman.tex -rm -rf $(srcdir)/$(USER_REFMAN) ## FIXME: Moving directories between file systems is not portable. - mv $(srcdir)/user $(srcdir)/$(USER_REFMAN) + mv $(USER_REFMAN).tmp $(srcdir)/$(USER_REFMAN) @mv -f $@.tmp $@ $(srcdir)/$(USER_REFMAN): $(srcdir)/user-refman.stamp @@ -154,7 +152,7 @@ regen-devel-doc: DOXYFILE_DEVEL = Doxyfile_devel edit_devel = sed \ - -e 's,OUTPUT_DIRECTORY = @srcdir@/user/,OUTPUT_DIRECTORY = @srcdir@/devel/,' \ + -e 's,OUTPUT_DIRECTORY = @builddir@/user-refman.tmp/,OUTPUT_DIRECTORY = @builddir@/devel-refman.tmp/,' \ -e 's,EXTRACT_ALL = NO,EXTRACT_ALL = YES,' \ -e 's,EXTRACT_PRIVATE = NO,EXTRACT_PRIVATE = YES,' \ -e 's,EXTRACT_STATIC = NO,EXTRACT_STATIC = YES,' \ @@ -195,8 +193,6 @@ $(srcdir)/$(DEVEL_REFMAN_PDF): $(srcdir)/$(DEVEL_REFMAN) cd $(srcdir)/$(DEVEL_REFMAN)/latex && $(MAKE) $(AM_MAKEFLAGS) pdf cp -f $(srcdir)/$(DEVEL_REFMAN)/latex/refman.pdf $@ -## FIXME: Use a variable instead of `$(srcdir)/devel' directly? -## ## FIXME: Are dependencies $(srcdir)/figures.stamp $(EXTRA_DEPS) set ## on the right rule? Does Doxygen make a copy of figures, or does it ## generate LaTeX inputs relying on the existence of such figures in @@ -204,15 +200,15 @@ $(srcdir)/$(DEVEL_REFMAN_PDF): $(srcdir)/$(DEVEL_REFMAN) $(srcdir)/devel-refman.stamp: $(srcdir)/$(DOXYFILE).in $(srcdir)/figures.stamp $(EXTRA_DEPS) @rm -f $@.tmp @touch $@.tmp - -rm -rf $(srcdir)/devel + -rm -rf $(DEVEL_REFMAN).tmp $(MAKE) $(AM_MAKE_FLAGS) $(DOXYFILE_DEVEL) $(DOXYGEN) $(DOXYFILE_DEVEL) ## Doxygen may generate an incomplete output and exit with success! ## Check some files before deeming the output as acceptable. - test -f $(srcdir)/devel/latex/refman.tex + test -f $(DEVEL_REFMAN).tmp/latex/refman.tex -rm -rf $(srcdir)/$(DEVEL_REFMAN) ## FIXME: Moving directories between file systems is not portable. - mv $(srcdir)/devel $(srcdir)/$(DEVEL_REFMAN) + mv $(DEVEL_REFMAN).tmp $(srcdir)/$(DEVEL_REFMAN) @mv -f $@.tmp $@ $(srcdir)/$(DEVEL_REFMAN): $(srcdir)/devel-refman.stamp @@ -225,8 +221,8 @@ $(srcdir)/$(DEVEL_REFMAN): $(srcdir)/devel-refman.stamp # Clean Doxygen products. maintainer-clean-local: - -rm -rf $(srcdir)/user $(srcdir)/$(USER_REFMAN) - -rm -rf $(srcdir)/devel $(srcdir)/$(DEVEL_REFMAN) + -rm -rf $(USER_REFMAN).tmp $(srcdir)/$(USER_REFMAN) + -rm -rf $(DEVEL_REFMAN).tmp $(srcdir)/$(DEVEL_REFMAN) ## ------------------------- ## -- 1.5.6.5