- Olena-patches

branch revamp-doc-build updated: last-svn-commit-47-gdc54b19
by git＠lrde.epita.fr 15 Mar '10

15 Mar '10

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Olena, a generic and efficient image processing platform". The branch revamp-doc-build has been updated via dc54b19cb5b39de46f62d04edd7859cb0b35b74a (commit) via 3f607e8f19d0a6d8473d038d502e04edc4b69490 (commit) via 1dde4ec3aa06c7cb628b052bade4d1f41e4c8c5e (commit) via b7b6a7da306ee36e96b3add2bd0843777fbbd003 (commit) via fb992545b50f0d9b5a0ef5db8a31ecc8eb3db625 (commit) via 219aa14bfdc6b234bee00304f5f69cee928db99b (commit) via 45b2ed4e8604b7defe6ba2a56bc5cd859d3c4a7c (commit) via 9693e15791859df0f34eb9781893c768c85777cc (commit) via 735e0af754220c01f0d91a44da748c785a688414 (commit) via b19305ec35a60965caa9f5e059b3ad1ec79ccbb7 (commit) via fbc3cb2efacf69c7b57eb6a68464011ef745eb3a (commit) via 51a165bc18b198c09fbe3dbd89d7a615cb513c35 (commit) via 5fc83d5c255135833e0e5a6a5741bc2f5aa90be0 (commit) via 31c6ffe0c98a9eebcc62ee0a4d06bca2e4182d7b (commit) via 17089da3e2238d2d2097b7f4f48153255c3128c2 (commit) via b370eff1d24c81d6a5267249d1816527c554deb4 (commit) via 0a5e4a1a52c69b45aebd6caad1caf14eea829997 (commit) via 13f1c3cbb14148c33a48aff238a050e96c9d993d (commit) via 1a017e969b927cf1c45c964115d637524a7cea14 (commit) via 840243a55ded80fa6bb4234581cf07aeaca0e320 (commit) from 13af895daaeda0e5c287eb221453bcf1ac5db581 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- dc54b19 Distribute and clean documentation timestamps. 3f607e8 Improve doc/'s cleaning rules. 1dde4ec Prevent todoxygen.sh from generating incomplete outputs. b7b6a7d Adjust todoxygen.sh to TeX4ht outputs. fb99254 Disable the implicit generation of HTML from LaTeX. 219aa14 Adapt HTML generation to TeX4ht. 45b2ed4 Have texi2dvi use TeX4ht instead of HeVeA to produce HTML outputs. 9693e15 Use texi2dvi to produce HTML from LaTeX. 735e0af Support HTML outputs in tex.mk. b19305e Automake configuration. fbc3cb2 Have bootstrap check for HeVeA 1.10. 51a165b Split LaTeX-to-HTML rules to clear things up. 5fc83d5 List non generated documentation outputs separately. 31c6ffe Use texi2dvi to produce PDF from LaTeX. 17089da Add texi2dvi as well as a Make helper to use it. b370eff Merge doc/ Makefile helpers into doc/Makefile.am. 0a5e4a1 Improve dependencies of some documentation products. 13f1c3c Revamp the Makefile machinery in milena/doc/examples/. 1a017e9 configure.ac: Configure milena/doc/tools/data.hh. 840243a Have documentation's examples not depend on hard-coded paths. ----------------------------------------------------------------------- Summary of changes: ChangeLog | 53 + bootstrap | 31 +- build-aux/Makefile.am | 12 +- build-aux/tex.mk | 43 + build-aux/texi2dvi | 1959 ++++++++++++++++++++ configure.ac | 6 +- milena/ChangeLog | 270 +++ milena/doc/.gitignore | 35 +- milena/doc/Makefile.am | 828 ++++++++- milena/doc/doc.mk | 42 - milena/doc/examples-outputs.mk | 296 +++ milena/doc/examples/ima-save.cc | 7 +- milena/doc/examples/make.mk | 279 --- milena/doc/examples/split/ima-save-1.cc.raw | 4 +- .../Makefile.am => doc/gen-examples-outputs-mk} | 29 +- milena/doc/ref_guide/ref_guide.mk | 95 - milena/doc/technical/technical.mk | 95 - milena/{apps => doc/tools}/data.hh.in | 16 +- milena/doc/tools/sample_utils.hh | 15 +- milena/doc/tools/todoxygen.sh | 50 +- milena/doc/tutorial/tutorial.mk | 95 - milena/doc/white_paper/white_paper.mk | 103 - 22 files changed, 3538 insertions(+), 825 deletions(-) create mode 100644 build-aux/tex.mk create mode 100755 build-aux/texi2dvi delete mode 100644 milena/doc/doc.mk create mode 100644 milena/doc/examples-outputs.mk delete mode 100644 milena/doc/examples/make.mk copy milena/{tests/morpho/reconstruction/by_dilation/Makefile.am => doc/gen-examples-outputs-mk} (60%) mode change 100644 => 100755 delete mode 100644 milena/doc/outputs/ima2d-decl-2.txt delete mode 100644 milena/doc/ref_guide/ref_guide.mk delete mode 100644 milena/doc/technical/technical.mk copy milena/{apps => doc/tools}/data.hh.in (78%) delete mode 100644 milena/doc/tutorial/tutorial.mk delete mode 100644 milena/doc/white_paper/white_paper.mk hooks/post-receive -- Olena, a generic and efficient image processing platform

1 0

last-svn-commit-47-gdc54b19 Distribute and clean documentation timestamps.
by Roland Levillain 15 Mar '10

15 Mar '10

* doc/Makefile.am (EXTRA_DIST, MAINTAINERCLEANFILES): Add $(srcdir)/user-refman.stamp, $(srcdir)/devel-refman.stamp, $(srcdir)/figures.stamp, $(srcdir)/split-examples.stamp and $(srcdir)/split-outputs.stamp. --- milena/ChangeLog | 9 +++++++++ milena/doc/Makefile.am | 11 ++++++++++- 2 files changed, 19 insertions(+), 1 deletions(-) diff --git a/milena/ChangeLog b/milena/ChangeLog index 236f155..b0e8778 100644 --- a/milena/ChangeLog +++ b/milena/ChangeLog @@ -1,5 +1,14 @@ 2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Distribute and clean documentation timestamps. + + * doc/Makefile.am (EXTRA_DIST, MAINTAINERCLEANFILES): + Add $(srcdir)/user-refman.stamp, $(srcdir)/devel-refman.stamp, + $(srcdir)/figures.stamp, $(srcdir)/split-examples.stamp and + $(srcdir)/split-outputs.stamp. + +2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Improve doc/'s cleaning rules. * doc/Makefile.am (CLEANFILES): Remove diff --git a/milena/doc/Makefile.am b/milena/doc/Makefile.am index 6bd729e..553a8dd 100644 --- a/milena/doc/Makefile.am +++ b/milena/doc/Makefile.am @@ -157,6 +157,8 @@ $(srcdir)/$(USER_REFMAN_PDF): $(srcdir)/$(USER_REFMAN) cd $(srcdir)/$(USER_REFMAN)/latex && $(MAKE) $(AM_MAKEFLAGS) pdf cp -f $(srcdir)/$(USER_REFMAN)/latex/refman.pdf $@ +EXTRA_DIST += $(srcdir)/user-refman.stamp +MAINTAINERCLEANFILES += $(srcdir)/user-refman.stamp ## FIXME: Are dependencies (`$(refman_dependencies)') 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 the @@ -238,6 +240,8 @@ $(srcdir)/$(DEVEL_REFMAN_PDF): $(srcdir)/$(DEVEL_REFMAN) cd $(srcdir)/$(DEVEL_REFMAN)/latex && $(MAKE) $(AM_MAKEFLAGS) pdf cp -f $(srcdir)/$(DEVEL_REFMAN)/latex/refman.pdf $@ +EXTRA_DIST += $(srcdir)/devel-refman.stamp +MAINTAINERCLEANFILES += $(srcdir)/devel-refman.stamp ## FIXME: Are dependencies (`$(refman_dependencies)') 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 the @@ -693,7 +697,8 @@ MAINTAINERCLEANFILES += $(REF_GUIDE_HH) $(srcdir)/figures/figures.mk: $(srcdir)/headers.stamp include $(srcdir)/figures/figures.mk -EXTRA_DIST += figures.stamp +EXTRA_DIST += $(srcdir)/figures.stamp +MAINTAINERCLEANFILES += $(srcdir)/figures.stamp $(srcdir)/figures.stamp: $(FIGURES_SRCDIR)/*.p*m rm -f $@.tmp touch $@.tmp @@ -1005,6 +1010,8 @@ EXAMPLES = \ # files easier. We probably also nee a stamp file to keep track of # dependencies. +EXTRA_DIST += $(srcdir)/split-examples.stamp +MAINTAINERCLEANFILES += $(srcdir)/split-examples.stamp # FIXME: Loops are bad, as they prevent parallelism. And we prefer # data-driven actions anyway. This would imply that we know in # advance the list out outputs (here, split examples). Maybe we can @@ -1020,6 +1027,8 @@ $(srcdir)/split-examples.stamp: $(EXAMPLES) done @mv -f $@.tmp $@ +EXTRA_DIST += $(srcdir)/split-outputs.stamp +MAINTAINERCLEANFILES += $(srcdir)/split-outputs.stamp # FIXME: Loops are bad, as they prevent parallelism. And we prefer # data-driven actions anyway. This would imply that we know in # advance the list out outputs (here, split outputs). Maybe we can -- 1.5.6.5

1 0

last-svn-commit-43-gfb99254 Disable the implicit generation of HTML from LaTeX.
by Roland Levillain 15 Mar '10

15 Mar '10

* build-aux/tex.mk (.tex.html): Remove this rule, since (TeX4ht) HTML outputs may contain more than one file (e.g., CSS style sheets, images, etc.). (SUFFIXES): Remove .html. --- ChangeLog | 9 +++++++++ build-aux/tex.mk | 5 +---- 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/ChangeLog b/ChangeLog index 567cd69..6195210 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,14 @@ 2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Disable the implicit generation of HTML from LaTeX. + + * build-aux/tex.mk (.tex.html): Remove this rule, since (TeX4ht) + HTML outputs may contain more than one file (e.g., CSS style + sheets, images, etc.). + (SUFFIXES): Remove .html. + +2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Have texi2dvi use TeX4ht instead of HeVeA to produce HTML outputs. * build-aux/tex.mk (TEXI2HTML): Add --tex4ht. diff --git a/build-aux/tex.mk b/build-aux/tex.mk index 79b4644..d93110d 100644 --- a/build-aux/tex.mk +++ b/build-aux/tex.mk @@ -30,14 +30,11 @@ TEXI2PDF_FLAGS = $(TEXI2DVI_FLAGS) TEXI2HTML = $(TEXI2DVI) --html --tex4ht TEXI2HTML_FLAGS = $(TEXI2DVI_FLAGS) -SUFFIXES = .tex .pdf .html +SUFFIXES = .tex .pdf .tex.pdf: $(TEXI2PDF) $(TEXI2PDF_FLAGS) -o $@ $< -.tex.html: - $(TEXI2HTML) $(TEXI2HTML_FLAGS) -o $@ $< - tex-mostlyclean: rm -rf tmp.t2d .PHONY: tex-mostlyclean -- 1.5.6.5

1 0

last-svn-commit-42-g219aa14 Adapt HTML generation to TeX4ht.
by Roland Levillain 15 Mar '10

15 Mar '10

* doc/Makefile.am (TECHNICAL_HTML_OUTPUTS, TUTORIAL_HTML_OUTPUTS) (WHITE_PAPER_HTML_OUTPUTS, REF_GUIDE_HTML_OUTPUTS): New variables. ($(TECHNICAL_HTML), $(TUTORIAL_HTML)) ($(WHITE_PAPER_HTML), $(REF_GUIDE_HTML)): Remove these targets. Superseded by... ($(TECHNICAL_HTML).stamp, $(TECHNICAL_HTML_OUTPUTS)) ($(TUTORIAL_HTML).stamp, $(TUTORIAL_HTML_OUTPUTS)) ($(WHITE_PAPER_HTML).stamp, $(WHITE_PAPER_HTML_OUTPUTS)) ($(REF_GUIDE_HTML).stamp, $(REF_GUIDE_HTML_OUTPUTS)): ...these (new) targets. (EXTRA_DIST, MAINTAINERCLEANFILES): Add $(TECHNICAL_HTML).stamp, ($(TUTORIAL_HTML).stamp, $(WHITE_PAPER_HTML).stamp and $(REF_GUIDE_HTML).stamp. (dist_doc_DATA, MAINTAINERCLEANFILES): Remove $(TECHNICAL_HTML), $(TUTORIAL_HTML), $(WHITE_PAPER_HTML) and $(REF_GUIDE_HTML). Add $(TECHNICAL_HTML_OUTPUTS), $(TUTORIAL_HTML_OUTPUTS), $(WHITE_PAPER_HTML_OUTPUTS) and $(REF_GUIDE_HTML_OUTPUTS). --- milena/ChangeLog | 25 +++++++++++ milena/doc/.gitignore | 14 ++++++- milena/doc/Makefile.am | 105 ++++++++++++++++++++++++++++++++++++++++++----- 3 files changed, 131 insertions(+), 13 deletions(-) diff --git a/milena/ChangeLog b/milena/ChangeLog index 99345b1..9c6df10 100644 --- a/milena/ChangeLog +++ b/milena/ChangeLog @@ -1,5 +1,30 @@ 2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Adapt HTML generation to TeX4ht. + + * doc/Makefile.am + (TECHNICAL_HTML_OUTPUTS, TUTORIAL_HTML_OUTPUTS) + (WHITE_PAPER_HTML_OUTPUTS, REF_GUIDE_HTML_OUTPUTS): + New variables. + ($(TECHNICAL_HTML), $(TUTORIAL_HTML)) + ($(WHITE_PAPER_HTML), $(REF_GUIDE_HTML)): + Remove these targets. + Superseded by... + ($(TECHNICAL_HTML).stamp, $(TECHNICAL_HTML_OUTPUTS)) + ($(TUTORIAL_HTML).stamp, $(TUTORIAL_HTML_OUTPUTS)) + ($(WHITE_PAPER_HTML).stamp, $(WHITE_PAPER_HTML_OUTPUTS)) + ($(REF_GUIDE_HTML).stamp, $(REF_GUIDE_HTML_OUTPUTS)): + ...these (new) targets. + (EXTRA_DIST, MAINTAINERCLEANFILES): Add $(TECHNICAL_HTML).stamp, + ($(TUTORIAL_HTML).stamp, $(WHITE_PAPER_HTML).stamp and + $(REF_GUIDE_HTML).stamp. + (dist_doc_DATA, MAINTAINERCLEANFILES): Remove $(TECHNICAL_HTML), + $(TUTORIAL_HTML), $(WHITE_PAPER_HTML) and $(REF_GUIDE_HTML). + Add $(TECHNICAL_HTML_OUTPUTS), $(TUTORIAL_HTML_OUTPUTS), + $(WHITE_PAPER_HTML_OUTPUTS) and $(REF_GUIDE_HTML_OUTPUTS). + +2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Use texi2dvi to produce HTML from LaTeX. * doc/Makefile.am diff --git a/milena/doc/.gitignore b/milena/doc/.gitignore index b187492..506bfa4 100644 --- a/milena/doc/.gitignore +++ b/milena/doc/.gitignore @@ -8,17 +8,29 @@ /figures/*.png +/ref_guide/ref_guide.css /ref_guide/ref_guide.hh /ref_guide/ref_guide.html /ref_guide/ref_guide.pdf +/ref_guide/ref_guide0x.png +/technical/technical.css /technical/technical.html /technical/technical.pdf +/tutorial/tutorial.css /tutorial/tutorial.hh /tutorial/tutorial.html /tutorial/tutorial.pdf -/white_paper/figures/*.eps +/white_paper/figures/house.eps +/white_paper/figures/house_rag.eps +/white_paper/figures/house_wshed.eps +/white_paper/figures/house_wshed_mean_colors.eps +/white_paper/white_paper.css /white_paper/white_paper.html /white_paper/white_paper.pdf +/white_paper/white_paper0x.png +/white_paper/white_paper1x.png +/white_paper/white_paper2x.png +/white_paper/white_paper3x.png diff --git a/milena/doc/Makefile.am b/milena/doc/Makefile.am index 3dc4bed..17a26bf 100644 --- a/milena/doc/Makefile.am +++ b/milena/doc/Makefile.am @@ -323,10 +323,28 @@ technical_dependencies = $(doc_dir)/figures.stamp # Final product. TECHNICAL_HTML = $(technical_dir)/technical.html -# Extra dependencies. -$(TECHNICAL_HTML): $(technical_dependencies) +TECHNICAL_HTML_OUTPUTS = $(TECHNICAL_HTML) $(technical_dir)/technical.css + +EXTRA_DIST += $(TECHNICAL_HTML).stamp +MAINTAINERCLEANFILES += $(TECHNICAL_HTML).stamp +# HTML outputs contains several files (the HTML file itself, its CSS +# style sheet, possibly some images). Therefore, we cannot rely on a +# simple suffix rule to produce them. +$(TECHNICAL_HTML).stamp: $(technical_dir)/technical.tex $(technical_dependencies) + @rm -f $@.tmp + @touch $@.tmp + $(TEXI2HTML) $(TEXI2HTML_FLAGS) -o $(TECHNICAL_HTML) $< + @mv -f $@.tmp $@ + +$(TECHNICAL_HTML_OUTPUTS): $(TECHNICAL_HTML).stamp +## Recover from the removal of $@ + @if test -d $@; then :; else \ + rm -f $<; \ + $(MAKE) $(AM_MAKEFLAGS) $<; \ + fi -dist_doc_DATA += $(TECHNICAL_HTML) +dist_doc_DATA += $(TECHNICAL_HTML_OUTPUTS) +MAINTAINERCLEANFILES += $(TECHNICAL_HTML_OUTPUTS) # Intermediate product for the various doc targets of the parent # directory. @@ -402,10 +420,28 @@ tutorial_dependencies = \ # Final product. TUTORIAL_HTML = $(tutorial_dir)/tutorial.html -# Extra dependencies. -$(TUTORIAL_HTML): $(tutorial_dependencies) +TUTORIAL_HTML_OUTPUTS = $(TUTORIAL_HTML) $(tutorial_dir)/tutorial.css + +EXTRA_DIST += $(TUTORIAL_HTML).stamp +MAINTAINERCLEANFILES += $(TUTORIAL_HTML).stamp +# HTML outputs contains several files (the HTML file itself, its CSS +# style sheet, possibly some images). Therefore, we cannot rely on a +# simple suffix rule to produce them. +$(TUTORIAL_HTML).stamp: $(tutorial_dir)/tutorial.tex $(tutorial_dependencies) + @rm -f $@.tmp + @touch $@.tmp + $(TEXI2HTML) $(TEXI2HTML_FLAGS) -o $(TUTORIAL_HTML) $< + @mv -f $@.tmp $@ + +$(TUTORIAL_HTML_OUTPUTS): $(TUTORIAL_HTML).stamp +## Recover from the removal of $@ + @if test -d $@; then :; else \ + rm -f $<; \ + $(MAKE) $(AM_MAKEFLAGS) $<; \ + fi -dist_doc_DATA += $(TUTORIAL_HTML) +dist_doc_DATA += $(TUTORIAL_HTML_OUTPUTS) +MAINTAINERCLEANFILES += $(TUTORIAL_HTML_OUTPUTS) # Intermediate product for the various doc targets of the parent # directory. @@ -490,10 +526,34 @@ white-paper: white-paper-pdf white-paper-html # Final product. WHITE_PAPER_HTML = $(white_paper_dir)/white_paper.html white-paper-html: $(WHITE_PAPER_HTML) -$(WHITE_PAPER_HTML): $(EPSS) -# FIXME: Keep this pass? -# $(doc_dir)/tools/clearbanner.sh $@ +WHITE_PAPER_HTML_OUTPUTS = \ + $(WHITE_PAPER_HTML) \ + $(white_paper_dir)/white_paper.css \ + $(white_paper_dir)/white_paper0x.png \ + $(white_paper_dir)/white_paper1x.png \ + $(white_paper_dir)/white_paper2x.png \ + $(white_paper_dir)/white_paper3x.png + +EXTRA_DIST += $(WHITE_PAPER_HTML).stamp +MAINTAINERCLEANFILES += $(WHITE_PAPER_HTML).stamp +# HTML outputs contains several files (the HTML file itself, its CSS +# style sheet, possibly some images). Therefore, we cannot rely on a +# simple suffix rule to produce them. +$(WHITE_PAPER_HTML).stamp: $(white_paper_dir)/white_paper.tex $(EPSS) + @rm -f $@.tmp + @touch $@.tmp + $(TEXI2HTML) $(TEXI2HTML_FLAGS) -o $(WHITE_PAPER_HTML) $< + @mv -f $@.tmp $@ + +$(WHITE_PAPER_HTML_OUTPUTS): $(WHITE_PAPER_HTML).stamp +## Recover from the removal of $@ + @if test -d $@; then :; else \ + rm -f $<; \ + $(MAKE) $(AM_MAKEFLAGS) $<; \ + fi +dist_doc_DATA += $(WHITE_PAPER_HTML_OUTPUTS) +MAINTAINERCLEANFILES += $(WHITE_PAPER_HTML_OUTPUTS) WHITE_PAPER_PDF = $(white_paper_dir)/white_paper.pdf white-paper-pdf: $(WHITE_PAPER_PDF) @@ -560,10 +620,31 @@ ref_guide_dependencies = \ # Final product. REF_GUIDE_HTML = $(ref_guide_dir)/ref_guide.html -# Extra dependencies. -$(REF_GUIDE_HTML): $(ref_guide_dependencies) +REF_GUIDE_HTML_OUTPUTS = \ + $(REF_GUIDE_HTML) \ + $(ref_guide_dir)/ref_guide.css \ + $(ref_guide_dir)/ref_guide0x.png + +EXTRA_DIST += $(REF_GUIDE_HTML).stamp +MAINTAINERCLEANFILES += $(REF_GUIDE_HTML).stamp +# HTML outputs contains several files (the HTML file itself, its CSS +# style sheet, possibly some images). Therefore, we cannot rely on a +# simple suffix rule to produce them. +$(REF_GUIDE_HTML).stamp: $(ref_guide_dir)/ref_guide.tex $(ref_guide_dependencies) + @rm -f $@.tmp + @touch $@.tmp + $(TEXI2HTML) $(TEXI2HTML_FLAGS) -o $(REF_GUIDE_HTML) $< + @mv -f $@.tmp $@ + +$(REF_GUIDE_HTML_OUTPUTS): $(REF_GUIDE_HTML).stamp +## Recover from the removal of $@ + @if test -d $@; then :; else \ + rm -f $<; \ + $(MAKE) $(AM_MAKEFLAGS) $<; \ + fi -dist_doc_DATA += $(REF_GUIDE_HTML) +dist_doc_DATA += $(REF_GUIDE_HTML_OUTPUTS) +MAINTAINERCLEANFILES += $(REF_GUIDE_HTML_OUTPUTS) # Intermediate product for the various doc targets of the parent # directory. -- 1.5.6.5

1 0

last-svn-commit-41-g45b2ed4 Have texi2dvi use TeX4ht instead of HeVeA to produce HTML outputs.
by Roland Levillain 15 Mar '10

15 Mar '10

* build-aux/tex.mk (TEXI2HTML): Add --tex4ht. * bootstrap (tempdir): Check for TeX4HT, dvipng and convert (from ImageMagick). --- ChangeLog | 8 ++++++++ bootstrap | 22 ++++++++++++++++++++-- build-aux/tex.mk | 2 +- 3 files changed, 29 insertions(+), 3 deletions(-) diff --git a/ChangeLog b/ChangeLog index 36bc676..567cd69 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,13 @@ 2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Have texi2dvi use TeX4ht instead of HeVeA to produce HTML outputs. + + * build-aux/tex.mk (TEXI2HTML): Add --tex4ht. + * bootstrap (tempdir): Check for TeX4ht, dvipng and convert (from + ImageMagick). + +2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Support HTML outputs in tex.mk. * build-aux/tex.mk (SUFFIXES): Add .html. diff --git a/bootstrap b/bootstrap index 2bdd761..18a65b1 100755 --- a/bootstrap +++ b/bootstrap @@ -129,8 +129,26 @@ export LIBTOOLIZE=$libtoolize require $libtoolize 1.5.22 require doxygen 1.5.6 -# FIXME: These should no longer be required when TeX4HT is used. -require hevea 1.10 -version +require convert 6.3.7 + +# Check for TeX4ht. htlatex and friends do not have options like +# `--version', `-version', `-v', etc. Hence this ad hoc procedure. +tempdir=`mktemp -d` +cleanup() { rm -rf "$tempdir"; exit; } +trap cleanup 0 1 2 3 6 15 +( + cd "$tempdir" + cat >test.tex <<EOF + \documentclass{article} + \begin{document} + Test + \end{document} +EOF + htlatex >/dev/null 2>&1 test.tex || fatal "TeX4ht is required" +) +rm -rf "$tempdir" +# dvipnh is required by TeX4ht. +require dvipng 1.11 # Tell what's going on. set -x diff --git a/build-aux/tex.mk b/build-aux/tex.mk index 493a687..79b4644 100644 --- a/build-aux/tex.mk +++ b/build-aux/tex.mk @@ -27,7 +27,7 @@ TEXI2DVI_FLAGS = --tidy --build-dir=tmp.t2d --batch TEXI2PDF = $(TEXI2DVI) --pdf TEXI2PDF_FLAGS = $(TEXI2DVI_FLAGS) -TEXI2HTML = $(TEXI2DVI) --html +TEXI2HTML = $(TEXI2DVI) --html --tex4ht TEXI2HTML_FLAGS = $(TEXI2DVI_FLAGS) SUFFIXES = .tex .pdf .html -- 1.5.6.5

1 0

last-svn-commit-46-g3f607e8 Improve doc/'s cleaning rules.
by Roland Levillain 15 Mar '10

15 Mar '10

* doc/Makefile.am (CLEANFILES): Remove $(technical_dir)/technical.haux, $(tutorial_dir)/tutorial.haux, $(ref_guide_dir)/ref_guide.haux and $(ref_guide_dir)/ref_guide.htoc. (clean-local): Remove (phony) target. ($(EPSS)): Move... (MAINTAINERCLEANFILES): ...here. Add $(TECHNICAL_PDF), $(TECHNICAL_HH), $(TUTORIAL_PDF), $(TUTORIAL_HH), $(WHITE_PAPER_PDF) $(REF_GUIDE_PDF) and $(REF_GUIDE_HH). --- milena/ChangeLog | 17 +++++++++++++++++ milena/doc/Makefile.am | 37 ++++++++++++------------------------- 2 files changed, 29 insertions(+), 25 deletions(-) diff --git a/milena/ChangeLog b/milena/ChangeLog index bd96c2e..236f155 100644 --- a/milena/ChangeLog +++ b/milena/ChangeLog @@ -1,5 +1,22 @@ 2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Improve doc/'s cleaning rules. + + * doc/Makefile.am (CLEANFILES): Remove + $(technical_dir)/technical.haux, + $(tutorial_dir)/tutorial.haux, + $(ref_guide_dir)/ref_guide.haux and + $(ref_guide_dir)/ref_guide.htoc. + (clean-local): Remove (phony) target. + ($(EPSS)): Move... + (MAINTAINERCLEANFILES): ...here. + Add $(TECHNICAL_PDF), $(TECHNICAL_HH), + $(TUTORIAL_PDF), $(TUTORIAL_HH), + $(WHITE_PAPER_PDF) + $(REF_GUIDE_PDF) and $(REF_GUIDE_HH). + +2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Prevent todoxygen.sh from generating incomplete outputs. * doc/tools/todoxygen.sh: Take an output file as second argument diff --git a/milena/doc/Makefile.am b/milena/doc/Makefile.am index 6c035ee..6bd729e 100644 --- a/milena/doc/Makefile.am +++ b/milena/doc/Makefile.am @@ -1,4 +1,3 @@ - # Copyright (C) 2007, 2008, 2009, 2010 EPITA Research and Development # Laboratory (LRDE). # @@ -15,7 +14,6 @@ # # You should have received a copy of the GNU General Public License # along with Olena. If not, see <http://www.gnu.org/licenses/>. -# # FIXME: To be overhauled! (See ticket #134). @@ -52,8 +50,6 @@ DOXYFILE = Doxyfile # Initialiaze variables. EXTRA_DIST = dist_doc_DATA = -CLEANFILES = -MAINTAINERCLEANFILES = # FIXME: Simplify all of this. ``Devel'' targets are really # secondary. And we probably don't need so much target aliases! @@ -144,6 +140,7 @@ $(DOXYFILE_USER): $(srcdir)/$(DOXYFILE).in Id=`grep '^\$$Id' $(top_srcdir)/milena/ChangeLog \ | sed -e 's/\\\$$//g'`; \ $(edit) $< >$@ +MAINTAINERCLEANFILES = $(DOXYFILE_USER) ## FIXME: Rename USER_REFMAN_PDF to something else? USER_REFMAN_PDF = user-refman.pdf @@ -220,6 +217,7 @@ $(DOXYFILE_DEVEL): $(srcdir)/$(DOXYFILE).in $(edit) $< >$@.tmp $(edit_devel) $@.tmp >$@ rm -f $@.tmp +MAINTAINERCLEANFILES += $(DOXYFILE_DEVEL) ## FIXME: Rename DEVEL_REFMAN_PDF to something else? DEVEL_REFMAN_PDF = devel-refman-pdf @@ -373,13 +371,13 @@ technical-pdf: $(TECHNICAL_PDF) $(TECHNICAL_PDF): $(technical_dependencies) dist_doc_DATA += $(TECHNICAL_PDF) +MAINTAINERCLEANFILES += $(TECHNICAL_PDF) EXTRA_DIST += \ $(technical_dir)/technical.tex \ $(TECHNICAL_HH) -CLEANFILES += $(technical_dir)/technical.haux - +MAINTAINERCLEANFILES += $(TECHNICAL_HH) ## ---------- ## ## Tutorial. ## @@ -476,15 +474,13 @@ tutorial-pdf: $(TUTORIAL_PDF) $(TUTORIAL_PDF): $(tutorial_dependencies) dist_doc_DATA += $(TUTORIAL_PDF) +MAINTAINERCLEANFILES += $(TUTORIAL_PDF) EXTRA_DIST += \ $(tutorial_dir)/tutorial.tex \ $(TUTORIAL_HH) -# FIXME: Why is $(TUTORIAL_HH) listed here? It should be -# automatically cleaned. I'm not sure either about the rest of -# CLEANFILES. -CLEANFILES += $(tutorial_dir)/tutorial.haux +MAINTAINERCLEANFILES += $(TUTORIAL_HH) ## ------------- ## @@ -572,19 +568,15 @@ white-paper-pdf: $(WHITE_PAPER_PDF) # Extra dependencies. $(WHITE_PAPER_PDF): $(PNGS) -dist_doc_DATA += \ - $(WHITE_PAPER_HTML) \ - $(WHITE_PAPER_PDF) +dist_doc_DATA += $(WHITE_PAPER_PDF) +MAINTAINERCLEANFILES += $(WHITE_PAPER_PDF) EXTRA_DIST += \ $(white_paper_dir)/white_paper.tex \ $(PNGS) \ $(EPSS) -CLEANFILES += $(EPSS) - -clean-local: - -rm -rf $(white_paper_dir)/white_paper_html +MAINTAINERCLEANFILES += $(EPSS) ## ----------------- ## @@ -685,14 +677,13 @@ ref-guide-pdf: $(REF_GUIDE_PDF) $(REF_GUIDE_PDF): $(ref_guide_dependencies) dist_doc_DATA += $(REF_GUIDE_PDF) +MAINTAINERCLEANFILES += $(REF_GUIDE_PDF) EXTRA_DIST += \ $(ref_guide_dir)/ref_guide.tex \ $(REF_GUIDE_HH) -CLEANFILES += \ - $(ref_guide_dir)/ref_guide.haux \ - $(ref_guide_dir)/ref_guide.htoc +MAINTAINERCLEANFILES += $(REF_GUIDE_HH) ## --------- ## @@ -782,7 +773,7 @@ PROGRAMS_examples += \ tuto4_site_set_create EXTRA_PROGRAMS = $(PROGRAMS_examples) -CLEANFILES += $(PROGRAMS_examples) +CLEANFILES = $(PROGRAMS_examples) # FIXME: Careful, this will only work if this file is included by # `milena/doc/Makefile.am', since `examples/' is a subdirectory of @@ -1128,7 +1119,3 @@ EXTRA_DIST += \ tools/sample_utils.hh \ tools/split_sample.sh \ tools/todoxygen.sh - -MAINTAINERCLEANFILES += \ - Doxyfile_user \ - Doxyfile_devel -- 1.5.6.5

1 0

last-svn-commit-45-g1dde4ec Prevent todoxygen.sh from generating incomplete outputs.
by Roland Levillain 15 Mar '10

15 Mar '10

* doc/tools/todoxygen.sh: Take an output file as second argument instead of an output directory. * doc/Makefile.am ($(TECHNICAL_HH), $(TUTORIAL_HH), $(REF_GUIDE_HH)): Adjust. Use a temporary file to prevent todoxygen.sh from generating incomplete outputs. --- milena/ChangeLog | 11 +++++++++++ milena/doc/Makefile.am | 24 +++++++++++++++++++++--- milena/doc/tools/todoxygen.sh | 4 ++-- 3 files changed, 34 insertions(+), 5 deletions(-) diff --git a/milena/ChangeLog b/milena/ChangeLog index ccf8b89..bd96c2e 100644 --- a/milena/ChangeLog +++ b/milena/ChangeLog @@ -1,5 +1,16 @@ 2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Prevent todoxygen.sh from generating incomplete outputs. + + * doc/tools/todoxygen.sh: Take an output file as second argument + instead of an output directory. + * doc/Makefile.am + ($(TECHNICAL_HH), $(TUTORIAL_HH), $(REF_GUIDE_HH)): Adjust. + Use a temporary file to prevent todoxygen.sh from generating + incomplete outputs. + +2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Adjust todoxygen.sh to TeX4ht outputs. * doc/tools/todoxygen.sh: Here. diff --git a/milena/doc/Makefile.am b/milena/doc/Makefile.am index 17a26bf..6c035ee 100644 --- a/milena/doc/Makefile.am +++ b/milena/doc/Makefile.am @@ -357,7 +357,13 @@ TECHNICAL_HH = $(technical_dir)/technical.hh # $(TECHNICAL_HTML). Anyway, this shortcut should vanish soon. technical-html: $(TECHNICAL_HH) $(TECHNICAL_HH): $(TECHNICAL_HTML) $(doc_dir)/tools/todoxygen.sh - $(doc_dir)/tools/todoxygen.sh $< $(technical_dir) $(doc_dir) +# The script `todoxygen.sh' may fail and still create a (partial and +# invalid) file, thus preventing Make from trying to generate it +# again. The solution is to use a temporary file as output and rename +# it if the script succeeds. + rm -f $@.tmp + $(doc_dir)/tools/todoxygen.sh $< $@.tmp $(doc_dir) + mv -f $@.tmp $@ # Final product. @@ -454,7 +460,13 @@ TUTORIAL_HH = $(tutorial_dir)/tutorial.hh # $(TUTORIAL_HTML). Anyway, this shortcut should vanish soon. tutorial-html: $(TUTORIAL_HH) $(TUTORIAL_HH): $(TUTORIAL_HTML) $(doc_dir)/tools/todoxygen.sh - $(doc_dir)/tools/todoxygen.sh $< $(tutorial_dir) $(doc_dir) +# The script `todoxygen.sh' may fail and still create a (partial and +# invalid) file, thus preventing Make from trying to generate it +# again. The solution is to use a temporary file as output and rename +# it if the script succeeds. + rm -f $@.tmp + $(doc_dir)/tools/todoxygen.sh $< $@.tmp $(doc_dir) + mv -f $@.tmp $@ # Final product. @@ -657,7 +669,13 @@ REF_GUIDE_HH = $(ref_guide_dir)/ref_guide.hh # $(REF_GUIDE_HTML). Anyway, this shortcut should vanish soon. ref-guide-html: $(REF_GUIDE_HH) $(REF_GUIDE_HH): $(REF_GUIDE_HTML) $(doc_dir)/tools/todoxygen.sh - $(doc_dir)/tools/todoxygen.sh $< $(ref_guide_dir) $(doc_dir) +# The script `todoxygen.sh' may fail and still create a (partial and +# invalid) file, thus preventing Make from trying to generate it +# again. The solution is to use a temporary file as output and rename +# it if the script succeeds. + rm -f $@.tmp + $(doc_dir)/tools/todoxygen.sh $< $@.tmp $(doc_dir) + mv -f $@.tmp $@ # Final product. diff --git a/milena/doc/tools/todoxygen.sh b/milena/doc/tools/todoxygen.sh index 19a204a..0a85632 100755 --- a/milena/doc/tools/todoxygen.sh +++ b/milena/doc/tools/todoxygen.sh @@ -19,10 +19,10 @@ # along with Olena. If not, see <http://www.gnu.org/licenses/>. test $# -eq 3 \ - || { echo "Usage: $0 <file.html> <output dir> <path to .sty>"; exit 1; } + || { echo "Usage: $0 <input.html> <output.hh> <path to .sty>"; exit 1; } html="$1" -out="$2/`basename $1 .html`.hh" +out="$2" bodyl=`grep -n -i "<BODY" $html | cut -d ':' -f 1` nlines=`wc -l $html | cut -d ' ' -f 1` -- 1.5.6.5

1 0

last-svn-commit-44-gb7b6a7d Adjust todoxygen.sh to TeX4ht outputs.
by Roland Levillain 15 Mar '10

15 Mar '10

* doc/tools/todoxygen.sh: Here. --- milena/ChangeLog | 6 ++++++ milena/doc/tools/todoxygen.sh | 2 +- 2 files changed, 7 insertions(+), 1 deletions(-) diff --git a/milena/ChangeLog b/milena/ChangeLog index 9c6df10..ccf8b89 100644 --- a/milena/ChangeLog +++ b/milena/ChangeLog @@ -1,5 +1,11 @@ 2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Adjust todoxygen.sh to TeX4ht outputs. + + * doc/tools/todoxygen.sh: Here. + +2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Adapt HTML generation to TeX4ht. * doc/Makefile.am diff --git a/milena/doc/tools/todoxygen.sh b/milena/doc/tools/todoxygen.sh index 9acab35..19a204a 100755 --- a/milena/doc/tools/todoxygen.sh +++ b/milena/doc/tools/todoxygen.sh @@ -24,7 +24,7 @@ test $# -eq 3 \ html="$1" out="$2/`basename $1 .html`.hh" -bodyl=`grep -n "<BODY >" $html | cut -d ':' -f 1` +bodyl=`grep -n -i "<BODY" $html | cut -d ':' -f 1` nlines=`wc -l $html | cut -d ' ' -f 1` tail_line=$(($nlines - $bodyl)) -- 1.5.6.5

1 0

last-svn-commit-40-g9693e15 Use texi2dvi to produce HTML from LaTeX.
by Roland Levillain 15 Mar '10

15 Mar '10

* doc/Makefile.am (TEXI2DVI_FLAGS): Add -I $(DOC_SRCDIR)/white_paper. ($(TECHNICAL_PDF), $(TUTORIAL_PDF)) ($(WHITE_PAPER_PDF), $(REF_GUIDE_PDF)): Reduce these rules to a list of extra dependencies and let the generic tex-to-html rule do the job. --- milena/ChangeLog | 11 +++++++++++ milena/doc/.gitignore | 31 +++++++++++-------------------- milena/doc/Makefile.am | 31 +++++++++++++++++-------------- 3 files changed, 39 insertions(+), 34 deletions(-) diff --git a/milena/ChangeLog b/milena/ChangeLog index 35aa08a..99345b1 100644 --- a/milena/ChangeLog +++ b/milena/ChangeLog @@ -1,3 +1,14 @@ +2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + + Use texi2dvi to produce HTML from LaTeX. + + * doc/Makefile.am + (TEXI2DVI_FLAGS): Add -I $(DOC_SRCDIR)/white_paper. + ($(TECHNICAL_PDF), $(TUTORIAL_PDF)) + ($(WHITE_PAPER_PDF), $(REF_GUIDE_PDF)): + Reduce these rules to a list of extra dependencies and let the + generic tex-to-html rule do the job. + 2010-03-12 Roland Levillain <roland(a)lrde.epita.fr> Split LaTeX-to-HTML rules to clear things up. diff --git a/milena/doc/.gitignore b/milena/doc/.gitignore index 9c55456..b187492 100644 --- a/milena/doc/.gitignore +++ b/milena/doc/.gitignore @@ -1,33 +1,24 @@ -/Doxyfile_devel /Doxyfile_user -/devel-refman -/devel-refman.pdf /user-refman /user-refman.pdf + +/Doxyfile_devel +/devel-refman +/devel-refman.pdf + /figures/*.png -/ref_guide/ref_guide.haux + /ref_guide/ref_guide.hh -/ref_guide/ref_guide.hh-e /ref_guide/ref_guide.html -/ref_guide/ref_guide.htoc /ref_guide/ref_guide.pdf -/technical/technical.haux -/technical/technical.hh -/technical/technical.hh-e + /technical/technical.html /technical/technical.pdf -/tutorial/tutorial.haux + /tutorial/tutorial.hh -/tutorial/tutorial.hh-e /tutorial/tutorial.html /tutorial/tutorial.pdf -/white_paper/figures/house.eps -/white_paper/figures/house_rag.eps -/white_paper/figures/house_wshed.eps -/white_paper/figures/house_wshed_mean_colors.eps -/white_paper/white_paper_html/index.haux -/white_paper/white_paper_html/index.html -/white_paper/white_paper_html/index.html-e -/white_paper/white_paper_html/index.htoc -/white_paper/white_paper_html/index.image.tex + +/white_paper/figures/*.eps +/white_paper/white_paper.html /white_paper/white_paper.pdf diff --git a/milena/doc/Makefile.am b/milena/doc/Makefile.am index 0d74098..3dc4bed 100644 --- a/milena/doc/Makefile.am +++ b/milena/doc/Makefile.am @@ -90,6 +90,9 @@ TEXI2DVI_FLAGS += \ -I $(DOC_SRCDIR) -I $(OUTPUTS_SRCDIR) -I $(SPLIT_OUTPUTS_SRCDIR) \ -I $(IMG_SRCDIR) -I $(SPLIT_EXAMPLES_SRCDIR) +# Illustrations of the white paper. +TEXI2DVI_FLAGS += -I $(DOC_SRCDIR)/white_paper + # Additional files for HeVeA compilations. DOC_PACKAGES = $(srcdir)/doxyfuns.sty $(srcdir)/milena.sty @@ -318,9 +321,10 @@ technical_dependencies = $(doc_dir)/figures.stamp ## Doyxgen documentation); remove its generation? Careful, ## technical/technical.html *is* probably required, though. +# Final product. TECHNICAL_HTML = $(technical_dir)/technical.html -$(TECHNICAL_HTML): $(technical_dir)/technical.tex $(technical_dependencies) - hevea -O -fix $(DOC_PACKAGES) $< -o $@ +# Extra dependencies. +$(TECHNICAL_HTML): $(technical_dependencies) dist_doc_DATA += $(TECHNICAL_HTML) @@ -396,9 +400,10 @@ tutorial_dependencies = \ # product is a directory, also refresh a timestamp (in the source # dir). +# Final product. TUTORIAL_HTML = $(tutorial_dir)/tutorial.html -$(TUTORIAL_HTML): $(tutorial_dir)/tutorial.tex $(tutorial_dependencies) - hevea -O -fix $(DOC_PACKAGES) $< -o $@ +# Extra dependencies. +$(TUTORIAL_HTML): $(tutorial_dependencies) dist_doc_DATA += $(TUTORIAL_HTML) @@ -482,15 +487,12 @@ white-paper: white-paper-pdf white-paper-html # product is a directory, also refresh a timestamp (in the source # dir). -# FIXME: Use texi2dvi/TeX4ht instead of plain hevea. -# FIXME: Why is WHITE_PAPER_HTML generated in a subdirectory? -WHITE_PAPER_HTML = $(white_paper_dir)/white_paper_html/index.html +# Final product. +WHITE_PAPER_HTML = $(white_paper_dir)/white_paper.html white-paper-html: $(WHITE_PAPER_HTML) -$(WHITE_PAPER_HTML): $(white_paper_dir)/white_paper.tex $(EPSS) - test -d $(white_paper_dir)/white_paper_html \ - || mkdir $(white_paper_dir)/white_paper_html - TEXINPUTS="$(DOC_SRCDIR):$(white_paper_dir):" hevea -O -fix $< -o $@ - $(doc_dir)/tools/clearbanner.sh $@ +$(WHITE_PAPER_HTML): $(EPSS) +# FIXME: Keep this pass? +# $(doc_dir)/tools/clearbanner.sh $@ WHITE_PAPER_PDF = $(white_paper_dir)/white_paper.pdf @@ -556,9 +558,10 @@ ref_guide_dependencies = \ # product is a directory, also refresh a timestamp (in the source # dir). +# Final product. REF_GUIDE_HTML = $(ref_guide_dir)/ref_guide.html -$(REF_GUIDE_HTML): $(ref_guide_dir)/ref_guide.tex $(ref_guide_dependencies) - hevea -O -fix $(DOC_PACKAGES) $< -o $@ +# Extra dependencies. +$(REF_GUIDE_HTML): $(ref_guide_dependencies) dist_doc_DATA += $(REF_GUIDE_HTML) -- 1.5.6.5

1 0

last-svn-commit-39-g735e0af Support HTML outputs in tex.mk.
by Roland Levillain 15 Mar '10

15 Mar '10

* build-aux/tex.mk (SUFFIXES): Add .html. (.tex.html): New rule. (TEXI2HTML, TEXI2HTML_FLAGS): New variables. --- ChangeLog | 8 ++++++++ build-aux/tex.mk | 8 +++++++- 2 files changed, 15 insertions(+), 1 deletions(-) diff --git a/ChangeLog b/ChangeLog index 91abb6e..36bc676 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,13 @@ 2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Support HTML outputs in tex.mk. + + * build-aux/tex.mk (SUFFIXES): Add .html. + (.tex.html): New rule. + (TEXI2HTML, TEXI2HTML_FLAGS): New variables. + +2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Automake configuration. * configure.ac: Remove option `foreign'. diff --git a/build-aux/tex.mk b/build-aux/tex.mk index 9fa00ff..493a687 100644 --- a/build-aux/tex.mk +++ b/build-aux/tex.mk @@ -27,11 +27,17 @@ TEXI2DVI_FLAGS = --tidy --build-dir=tmp.t2d --batch TEXI2PDF = $(TEXI2DVI) --pdf TEXI2PDF_FLAGS = $(TEXI2DVI_FLAGS) -SUFFIXES = .pdf .tex +TEXI2HTML = $(TEXI2DVI) --html +TEXI2HTML_FLAGS = $(TEXI2DVI_FLAGS) + +SUFFIXES = .tex .pdf .html .tex.pdf: $(TEXI2PDF) $(TEXI2PDF_FLAGS) -o $@ $< +.tex.html: + $(TEXI2HTML) $(TEXI2HTML_FLAGS) -o $@ $< + tex-mostlyclean: rm -rf tmp.t2d .PHONY: tex-mostlyclean -- 1.5.6.5

1 0