Commit d510e3e5 authored by Roland Levillain's avatar Roland Levillain
Browse files

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.
parent 92124b54
2010-03-08 Roland Levillain <roland@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@lrde.epita.fr> 2010-03-08 Roland Levillain <roland@lrde.epita.fr>
   
Reorganize doc/Makefile.am. Reorganize doc/Makefile.am.
/Doxyfile_devel /Doxyfile_devel
/Doxyfile_user /Doxyfile_user
/devel
/devel-refman /devel-refman
/devel-refman.pdf /devel-refman.pdf
/user
/user-refman /user-refman
/user-refman.pdf /user-refman.pdf
/figures/*.png /figures/*.png
......
...@@ -22,7 +22,7 @@ ...@@ -22,7 +22,7 @@
#--------------------------------------------------------------------------- #---------------------------------------------------------------------------
PROJECT_NAME = "Milena (@PACKAGE_NAME@)" PROJECT_NAME = "Milena (@PACKAGE_NAME@)"
PROJECT_NUMBER = "User documentation @PACKAGE_VERSION@ @ID@" PROJECT_NUMBER = "User documentation @PACKAGE_VERSION@ @ID@"
OUTPUT_DIRECTORY = @srcdir@/user/ OUTPUT_DIRECTORY = @builddir@/user-refman.tmp
CREATE_SUBDIRS = YES CREATE_SUBDIRS = YES
OUTPUT_LANGUAGE = English OUTPUT_LANGUAGE = English
BRIEF_MEMBER_DESC = YES BRIEF_MEMBER_DESC = YES
...@@ -101,9 +101,7 @@ EXCLUDE = @top_srcdir@/milena/sandbox \ ...@@ -101,9 +101,7 @@ EXCLUDE = @top_srcdir@/milena/sandbox \
@top_srcdir@/milena/trash \ @top_srcdir@/milena/trash \
@top_srcdir@/milena/mln/core/concept/proxy.hxx \ @top_srcdir@/milena/mln/core/concept/proxy.hxx \
@top_srcdir@/milena/doc/examples/trash \ @top_srcdir@/milena/doc/examples/trash \
@top_srcdir@/milena/doc/user \
@top_srcdir@/milena/doc/user-refman @top_srcdir@/milena/doc/user-refman
@top_srcdir@/milena/doc/devel \
@top_srcdir@/milena/doc/devel-refman @top_srcdir@/milena/doc/devel-refman
@top_srcdir@/milena/tests/unit_test @top_srcdir@/milena/tests/unit_test
EXCLUDE_SYMLINKS = YES EXCLUDE_SYMLINKS = YES
......
...@@ -113,8 +113,6 @@ $(srcdir)/$(USER_REFMAN_PDF): $(srcdir)/$(USER_REFMAN) ...@@ -113,8 +113,6 @@ $(srcdir)/$(USER_REFMAN_PDF): $(srcdir)/$(USER_REFMAN)
cd $(srcdir)/$(USER_REFMAN)/latex && $(MAKE) $(AM_MAKEFLAGS) pdf cd $(srcdir)/$(USER_REFMAN)/latex && $(MAKE) $(AM_MAKEFLAGS) pdf
cp -f $(srcdir)/$(USER_REFMAN)/latex/refman.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 ## FIXME: Are dependencies $(srcdir)/figures.stamp $(EXTRA_DEPS) set
## on the right rule? Does Doxygen make a copy of figures, or does it ## 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 ## generate LaTeX inputs relying on the existence of such figures in
...@@ -122,15 +120,15 @@ $(srcdir)/$(USER_REFMAN_PDF): $(srcdir)/$(USER_REFMAN) ...@@ -122,15 +120,15 @@ $(srcdir)/$(USER_REFMAN_PDF): $(srcdir)/$(USER_REFMAN)
$(srcdir)/user-refman.stamp: $(srcdir)/$(DOXYFILE).in $(srcdir)/figures.stamp $(EXTRA_DEPS) $(srcdir)/user-refman.stamp: $(srcdir)/$(DOXYFILE).in $(srcdir)/figures.stamp $(EXTRA_DEPS)
@rm -f $@.tmp @rm -f $@.tmp
@touch $@.tmp @touch $@.tmp
-rm -rf $(srcdir)/user -rm -rf $(USER_REFMAN).tmp
$(MAKE) $(AM_MAKE_FLAGS) $(DOXYFILE_USER) $(MAKE) $(AM_MAKE_FLAGS) $(DOXYFILE_USER)
$(DOXYGEN) $(DOXYFILE_USER) $(DOXYGEN) $(DOXYFILE_USER)
## Doxygen may generate an incomplete output and exit with success! ## Doxygen may generate an incomplete output and exit with success!
## Check some files before deeming the output as acceptable. ## 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) -rm -rf $(srcdir)/$(USER_REFMAN)
## FIXME: Moving directories between file systems is not portable. ## 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 $@ @mv -f $@.tmp $@
$(srcdir)/$(USER_REFMAN): $(srcdir)/user-refman.stamp $(srcdir)/$(USER_REFMAN): $(srcdir)/user-refman.stamp
...@@ -154,7 +152,7 @@ regen-devel-doc: ...@@ -154,7 +152,7 @@ regen-devel-doc:
DOXYFILE_DEVEL = Doxyfile_devel DOXYFILE_DEVEL = Doxyfile_devel
edit_devel = sed \ 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_ALL = NO,EXTRACT_ALL = YES,' \
-e 's,EXTRACT_PRIVATE = NO,EXTRACT_PRIVATE = YES,' \ -e 's,EXTRACT_PRIVATE = NO,EXTRACT_PRIVATE = YES,' \
-e 's,EXTRACT_STATIC = NO,EXTRACT_STATIC = YES,' \ -e 's,EXTRACT_STATIC = NO,EXTRACT_STATIC = YES,' \
...@@ -195,8 +193,6 @@ $(srcdir)/$(DEVEL_REFMAN_PDF): $(srcdir)/$(DEVEL_REFMAN) ...@@ -195,8 +193,6 @@ $(srcdir)/$(DEVEL_REFMAN_PDF): $(srcdir)/$(DEVEL_REFMAN)
cd $(srcdir)/$(DEVEL_REFMAN)/latex && $(MAKE) $(AM_MAKEFLAGS) pdf cd $(srcdir)/$(DEVEL_REFMAN)/latex && $(MAKE) $(AM_MAKEFLAGS) pdf
cp -f $(srcdir)/$(DEVEL_REFMAN)/latex/refman.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 ## FIXME: Are dependencies $(srcdir)/figures.stamp $(EXTRA_DEPS) set
## on the right rule? Does Doxygen make a copy of figures, or does it ## 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 ## generate LaTeX inputs relying on the existence of such figures in
...@@ -204,15 +200,15 @@ $(srcdir)/$(DEVEL_REFMAN_PDF): $(srcdir)/$(DEVEL_REFMAN) ...@@ -204,15 +200,15 @@ $(srcdir)/$(DEVEL_REFMAN_PDF): $(srcdir)/$(DEVEL_REFMAN)
$(srcdir)/devel-refman.stamp: $(srcdir)/$(DOXYFILE).in $(srcdir)/figures.stamp $(EXTRA_DEPS) $(srcdir)/devel-refman.stamp: $(srcdir)/$(DOXYFILE).in $(srcdir)/figures.stamp $(EXTRA_DEPS)
@rm -f $@.tmp @rm -f $@.tmp
@touch $@.tmp @touch $@.tmp
-rm -rf $(srcdir)/devel -rm -rf $(DEVEL_REFMAN).tmp
$(MAKE) $(AM_MAKE_FLAGS) $(DOXYFILE_DEVEL) $(MAKE) $(AM_MAKE_FLAGS) $(DOXYFILE_DEVEL)
$(DOXYGEN) $(DOXYFILE_DEVEL) $(DOXYGEN) $(DOXYFILE_DEVEL)
## Doxygen may generate an incomplete output and exit with success! ## Doxygen may generate an incomplete output and exit with success!
## Check some files before deeming the output as acceptable. ## 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) -rm -rf $(srcdir)/$(DEVEL_REFMAN)
## FIXME: Moving directories between file systems is not portable. ## 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 $@ @mv -f $@.tmp $@
$(srcdir)/$(DEVEL_REFMAN): $(srcdir)/devel-refman.stamp $(srcdir)/$(DEVEL_REFMAN): $(srcdir)/devel-refman.stamp
...@@ -225,8 +221,8 @@ $(srcdir)/$(DEVEL_REFMAN): $(srcdir)/devel-refman.stamp ...@@ -225,8 +221,8 @@ $(srcdir)/$(DEVEL_REFMAN): $(srcdir)/devel-refman.stamp
# Clean Doxygen products. # Clean Doxygen products.
maintainer-clean-local: maintainer-clean-local:
-rm -rf $(srcdir)/user $(srcdir)/$(USER_REFMAN) -rm -rf $(USER_REFMAN).tmp $(srcdir)/$(USER_REFMAN)
-rm -rf $(srcdir)/devel $(srcdir)/$(DEVEL_REFMAN) -rm -rf $(DEVEL_REFMAN).tmp $(srcdir)/$(DEVEL_REFMAN)
## ------------------------- ## ## ------------------------- ##
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment