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

Add a Make rule faking the regeneration of the documentation.

	* doc/Makefile.am,
	* doc/ref_guide/Makefile.am,
	* doc/tutorial/Makefile.am,
	* doc/white_paper/Makefile.am (fake-doc, void-doc):
	New (phony) targets.

git-svn-id: https://svn.lrde.epita.fr/svn/oln/trunk@4194 4aad255d-cdde-0310-9447-f3009e2ae8c0
parent 68aa2367
2009-06-25 Roland Levillain <roland@lrde.epita.fr>
Add a Make rule faking the regeneration of the documentation.
* doc/Makefile.am,
* doc/ref_guide/Makefile.am,
* doc/tutorial/Makefile.am,
* doc/white_paper/Makefile.am (fake-doc, void-doc):
New (phony) targets.
2009-06-25 Roland Levillain <roland@lrde.epita.fr>
 
Improve build dependencies in doc/.
......@@ -253,3 +253,53 @@ Doxyfile_devel: $(srcdir)/Doxyfile.in
Doxyfile_devel_pdf: Doxyfile_devel
$(edit_pdf) $< >$@
#<<lrde
# Pretend the documentation is up-to-date. This is really useful for
# developers who want to check the distribution mechanism, for
# generating the Doxygen documentation make take up to 1 hour.
#
# A few remarks. Refreshing the contents of EXTRA_DIST using
#
# touch $(EXTRA_DIST)
#
# just does not work, as EXTRA_DIST lists source and built files
# (resp. in srcdir and buidldir). Cheat: go to srcdir and strip the
# srcdir prefix from path of every file listed in EXTRA_DIST. And we
# have to prune the built files (e.g. `Doxyfile_user_pdf').
#
# We also selectively refresh files by hand in a certain order (some
# of them being already listed in EXTRA_DIST), to satisfy the
# dependencies.
.PHONY: fake-doc
fake-doc:
cd $(srcdir) \
&& touch `echo $(EXTRA_DIST) \
| sed -e 's!$(srcdir)/!!g' \
-e 's/Doxyfile_user_pdf//g' \
-e 's/Doxyfile_user//g' `
cd ref_guide && $(MAKE) $(AM_MAKEFLAGS) $@
cd tutorial && $(MAKE) $(AM_MAKEFLAGS) $@
cd white_paper && $(MAKE) $(AM_MAKEFLAGS) $@
touch $(EXTRA_DEPS)
touch Doxyfile_devel
touch Doxyfile_devel_pdf
touch Doxyfile_user
touch Doxyfile_user_pdf
test -d user || mkdir user
if test -d $(USER_REFMAN_HTML); then \
touch $(USER_REFMAN_HTML); \
else \
mkdir $(USER_REFMAN_HTML); \
fi
touch $(USER_REFMAN_PDF)
# The converse of the previous rule, voiding the timestamps.
.PHONY: void-doc
void-doc:
touch $(srcdir)/Doxyfile.in
cd ref_guide && $(MAKE) $(AM_MAKEFLAGS) $@
cd tutorial && $(MAKE) $(AM_MAKEFLAGS) $@
cd white_paper && $(MAKE) $(AM_MAKEFLAGS) $@
#>>
......@@ -61,3 +61,17 @@ CLEANFILES = \
*.haux *.hh *.html *.htoc \
ref_guide.html \
$(REF_GUIDE_HH)
#<<lrde
# Pretend the documentation is up-to-date.
.PHONY: fake-doc
fake-doc:
touch $(REF_GUIDE_HH)
touch $(REF_GUIDE_PDF)
# The converse of the previous rule, voiding the timestamps.
.PHONY: void-doc
void-doc:
touch $(srcdir)/ref_guide.tex
#>>
......@@ -59,3 +59,17 @@ CLEANFILES = \
tutorial.haux \
tutorial.html \
$(TUTORIAL_HH)
#<<lrde
# Pretend the documentation is up-to-date.
.PHONY: fake-doc
fake-doc:
touch $(TUTORIAL_HH)
touch $(TUTORIAL_PDF)
# The converse of the previous rule, voiding the timestamps.
.PHONY: void-doc
void-doc:
touch $(srcdir)/tutorial.tex
#>>
......@@ -69,3 +69,18 @@ CLEANFILES = \
white_paper.pdf \
*.log *.idx *.out *.aux \
figures
#<<lrde
# Pretend the documentation is up-to-date.
.PHONY: fake-doc
fake-doc:
touch $(EPSS)
touch $(WHITE_PAPER_HTML)
touch $(WHITE_PAPER_PDF)
# The converse of the previous rule, voiding the timestamps.
.PHONY: void-doc
void-doc:
touch $(srcdir)/white_paper.tex
#>>
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