X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/5aa0707135983883434c13627dd1adad3eade648..9c0ae9ef71784f2d41e8ffe8a4400177227b85fb:/doc/Makefile.am diff --git a/doc/Makefile.am b/doc/Makefile.am index c5c2d43966..da55c7d8ec 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -1,20 +1,104 @@ -DOCSOURCES = $(shell find @top_srcdir@/src @top_srcdir@/include -name "*.[chl]") $(shell find @top_srcdir@/src @top_srcdir@/include -name "*.doc") - -EXTRA_DIST = html Doxyfile.API Doxyfile.Examples Doxyfile.main - -html: $(DOCSOURCES) Doxyfile.API Doxyfile.Examples Doxyfile.main - @touch @top_srcdir@/doc/api_index.doc - @doxygen Doxyfile.main - @doxygen Doxyfile.API - @doxygen Doxyfile.Examples - @@top_srcdir@/tools/doxygen/index_create.pl html/API/API.tag @top_srcdir@/doc/api_index.doc - @cp simgrid_logo.png simgrid_modules.jpg html/ - @doxygen Doxyfile.API - @doxygen Doxyfile.Examples - @doxygen Doxyfile.main -# @cd html ; @top_srcdir@/tools/fix_doxygen2.pl `find . -name '*.html'` -# @rm -rf html/API html/examples -# for i in `find doc/html -name "*.html" -exec grep -l "group_[^_]" {} \;` ; do tools/fix_doxygen.pl $$i; rm $$i.bak; done - -clean: - @rm -rf html/ +DOCSOURCES = $(shell find @top_srcdir@/tools/gras @top_srcdir@/src @top_srcdir@/include -name "*.[chl]") \ + $(shell find @srcdir@ -name "*.doc") +FIGS=simgrid_modules.fig amok_bw_test.fig amok_bw_sat.fig +PNGS=$(patsubst %.fig,%.png,$(FIGS)) simgrid_logo.png simgrid_logo_small.png + +EXTRA_DIST = html Doxyfile \ + modules.doc FAQ.doc contrib.doc index.doc publis.doc footer.html \ + $(foreach file,$(FIGS),fig/$(file)) $(PNGS) + + +CLEANFILES = .*.toc +DISTCLEANFILES = index-API.doc simgrid.tag +MAINTAINERCLEANFILES = html + +if MAINTAINER_MODE +simgrid_modules.map: fig/simgrid_modules.fig + fig2dev -Lmap fig/simgrid_modules.fig | grep -e IMG -e MAP -e AREA | \ + sed 's/imagemap/simgrid_modules/g' | sed 's/\.gif/.png/' | \ + sed 's/ simgrid_modules.map + +%.png: fig/%.fig + fig2dev -Lpng $^ > $@ + +html: Doxyfile ./logcategories.doc simgrid_modules.map $(PNGS) $(DOCSOURCES) + : # Setting up + touch index-API.doc .FAQ.doc.toc .index.doc.toc .contrib.doc.toc + test -e html || mkdir html + cp $(foreach file,$(PNGS),@srcdir@/$(file)) html/ + cp @srcdir@/Paje_MSG_screenshot_thn.jpg @srcdir@/Paje_MSG_screenshot.jpg html/ + cp @srcdir@/simgrid.css html/ + : # First pass + doxygen Doxyfile >/dev/null + @top_srcdir@/tools/doxygen/index_create.pl simgrid.tag index-API.doc + @top_srcdir@/tools/doxygen/toc_create.pl \ + @srcdir@/FAQ.doc @srcdir@/index.doc @srcdir@/contrib.doc \ + @srcdir@/gtut-introduction.doc + : # Second pass + doxygen Doxyfile >/dev/null + : # Post-processing + rm -f html/dir* + @top_srcdir@/tools/doxygen/index_php.pl @srcdir@/index.php.in html/index.html index.php + @top_srcdir@/tools/doxygen/doxygen_postprocesser.pl + +publish: + $(MAKE) -C .. sync-gforge +endif + +./logcategories.doc: $(DOCSOURCES) + pwd=`pwd`; rm $$pwd/logcategories.doc; set -e; \ + echo "/* Generated file, do not edit */" > $$pwd/logcategories.doc; \ + echo "/** \addtogroup XBT_log_cats" >> $$pwd/logcategories.doc; \ + echo " @{" >> $$pwd/logcategories.doc; \ + cd @top_srcdir@/src; ./xbt_log_extract_hierarchy >> $$pwd/logcategories.doc; \ + echo "@}*/" >> $$pwd/logcategories.doc; + +install-data-local: + @for file in `find html/ -type d` ; do \ + echo "test -z \"$(prefix)/doc/simgrid/$$file\" || $(mkdir_p) \"$(prefix)/doc/simgrid/$$file\"";\ + test -z "$(prefix)/doc/simgrid/$$file" || $(mkdir_p) "$(prefix)/doc/simgrid/$$file";\ + done + @for file in `find html/ -type f` ; do \ + echo " $(INSTALL_DATA) '$$file' '$(prefix)/doc/simgrid/$$file'";\ + $(INSTALL_DATA) $$file $(prefix)/doc/simgrid/$$file ;\ + done + +uninstall-local: + for file in `find html/ -type f` ; do \ + echo " rm -f '$(prefix)/doc/simgrid/$$file'";\ + rm -f $(prefix)/doc/simgrid/$$file ;\ + done + + +check-gtut-tocs: + @echo Check individual TOCs + @for n in gtut-tour-*.doc ; do \ + sed -n '/Table of Contents/,/hr/p' $$n|grep ref > tmp.curtoc; \ + \ + grep '\\section' $$n | grep -v _toc| \ + sed -e 's/\\section //' -e 's/ .*//' |sed 's/^/ - \\ref /' > tmp.realtoc; \ + \ + if ! diff -q tmp.curtoc tmp.realtoc >/dev/null; then \ + echo Wrong toc for $$n. Should be ; \ + cat tmp.realtoc; \ + fi ; \ + done + @rm tmp.realtoc tmp.curtoc + @echo "Check main TOC" + @for n in gtut-tour-*doc; do \ + grep @page $$n |sed -e 's/@page //' -e 's/ .*//' -e 's/^/ - \\ref /' >>tmp.realtoc;\ + sed -n -e '/Table of Contents/,/hr/p' $$n|sed -e 's/^/ /'|\ + grep -v toc|grep -v '
'|grep [^[:blank:]] >>tmp.realtoc;\ + done + @grep ' *- \\ref' gtut-tour.doc > tmp.curtoc + @if ! diff -b -q tmp.curtoc tmp.realtoc >/dev/null; then \ + echo Wrong toc for gtut-tour.doc. Should be ; \ + cat tmp.realtoc; \ + fi ; + @rm tmp.realtoc tmp.curtoc + + +.PHONY: html + +include $(top_srcdir)/acmacro/dist-files.mk