- Olena-patches

last-svn-commit-41-g38d3173 Use texi2dvi to produce PDF from LaTeX.
by Roland Levillain 01 Apr '10

01 Apr '10

* doc/Makefile.am: Include $(top_srcdir)/build-aux/tex.mk. (TEXI2DVI_FLAGS): Append -I $(DOC_SRCDIR), -I $(OUTPUTS_SRCDIR), -I $(SPLIT_OUTPUTS_SRCDIR), -I $(IMG_SRCDIR) and -I $(SPLIT_EXAMPLES_SRCDIR). (technical_TEXINPUTS, tutorial_TEXINPUTS) (white_paper_TEXINPUTS, ref_guide_TEXINPUTS): Remove variables. ($(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-pdf rule do the job. ($(WHITE_PAPER_HTML)): Adjust rule. --- milena/ChangeLog | 17 +++++++++++++ milena/doc/Makefile.am | 60 ++++++++++++++++------------------------------- 2 files changed, 38 insertions(+), 39 deletions(-) diff --git a/milena/ChangeLog b/milena/ChangeLog index dd2857e..48993e2 100644 --- a/milena/ChangeLog +++ b/milena/ChangeLog @@ -1,5 +1,22 @@ 2010-03-12 Roland Levillain <roland(a)lrde.epita.fr> + Use texi2dvi to produce PDF from LaTeX. + + * doc/Makefile.am: Include $(top_srcdir)/build-aux/tex.mk. + (TEXI2DVI_FLAGS): Append -I $(DOC_SRCDIR), -I $(OUTPUTS_SRCDIR), + -I $(SPLIT_OUTPUTS_SRCDIR), -I $(IMG_SRCDIR) and -I + $(SPLIT_EXAMPLES_SRCDIR). + (technical_TEXINPUTS, tutorial_TEXINPUTS) + (white_paper_TEXINPUTS, ref_guide_TEXINPUTS): + Remove variables. + ($(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-pdf rule do the job. + ($(WHITE_PAPER_HTML)): Adjust rule. + +2010-03-12 Roland Levillain <roland(a)lrde.epita.fr> + Merge doc/ Makefile helpers into doc/Makefile.am. * milena/doc/doc.mk, diff --git a/milena/doc/Makefile.am b/milena/doc/Makefile.am index 5f2b9ba..10c8fef 100644 --- a/milena/doc/Makefile.am +++ b/milena/doc/Makefile.am @@ -79,6 +79,17 @@ doc-devel-html: tutorial-html ref-guide-html white-paper-html \ ref-doc-devel +## --------------------- ## +## LaTeX configuration. ## +## --------------------- ## + +include $(top_srcdir)/build-aux/tex.mk + +# FIXME: Check this list. +TEXI2DVI_FLAGS += \ + -I $(DOC_SRCDIR) -I $(OUTPUTS_SRCDIR) -I $(SPLIT_OUTPUTS_SRCDIR) \ + -I $(IMG_SRCDIR) -I $(SPLIT_EXAMPLES_SRCDIR) + ## ----------------------- ## ## Doxygen documentation. ## ## ----------------------- ## @@ -266,10 +277,6 @@ maintainer-clean-local: .PHONY: technical technical-html technical-pdf -technical_TEXINPUTS ="$(DOC_SRCDIR):$(OUTPUTS_SRCDIR):$(srcdir):\ -$(SPLIT_OUTPUTS_SRCDIR):$(IMG_SRCDIR):$(SPLIT_EXAMPLES_SRCDIR):" - - technical: technical-html technical-pdf technical_dir = $(doc_dir)/technical @@ -318,12 +325,8 @@ $(TECHNICAL_HH): $(technical_dir)/technical.tex $(technical_dependencies) # Final product. TECHNICAL_PDF = $(technical_dir)/technical.pdf technical-pdf: $(TECHNICAL_PDF) -$(TECHNICAL_PDF): $(technical_dir)/technical.tex $(technical_dependencies) - TEXINPUTS=$(technical_TEXINPUTS) pdflatex $< - TEXINPUTS=$(technical_TEXINPUTS) pdflatex $< - TEXINPUTS=$(technical_TEXINPUTS) pdflatex $< \ - test "x$(technical_dir)" != x. \ - && mv -f technical.pdf $(technical_dir) +# Extra dependencies. +$(TECHNICAL_PDF): $(technical_dependencies) dist_doc_DATA += $(TECHNICAL_PDF) @@ -353,9 +356,6 @@ CLEANFILES += \ .PHONY: tutorial tutorial-html tutorial-pdf -tutorial_TEXINPUTS = $(DOC_SRCDIR):$(OUTPUTS_SRCDIR):$(IMG_SRCDIR): - - tutorial: tutorial-html tutorial-pdf tutorial_dir = $(doc_dir)/tutorial @@ -407,12 +407,8 @@ $(TUTORIAL_HH): $(tutorial_dir)/tutorial.tex $(tutorial_dependencies) # Final product. TUTORIAL_PDF = $(tutorial_dir)/tutorial.pdf tutorial-pdf: $(TUTORIAL_PDF) -$(TUTORIAL_PDF): $(tutorial_dir)/tutorial.tex $(tutorial_dependencies) - TEXINPUTS=$(tutorial_TEXINPUTS) pdflatex $< - TEXINPUTS=$(tutorial_TEXINPUTS) pdflatex $< - TEXINPUTS=$(tutorial_TEXINPUTS) pdflatex $< \ - test x"$(tutorial_dir)" != x. \ - && mv -f tutorial.pdf $(tutorial_dir) +# Extra dependencies. +$(TUTORIAL_PDF): $(tutorial_dependencies) dist_doc_DATA += $(TUTORIAL_PDF) @@ -444,8 +440,6 @@ CLEANFILES += \ white_paper_dir = $(doc_dir)/white_paper -white_paper_TEXINPUTS = $(DOC_SRCDIR):$(white_paper_dir): - PNGS = \ $(white_paper_dir)/figures/house.png \ $(white_paper_dir)/figures/house_rag.png \ @@ -487,24 +481,20 @@ white-paper: white-paper-pdf white-paper-html # 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 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=$(white_paper_TEXINPUTS) hevea -O -fix $< -o $@ + TEXINPUTS="$(DOC_SRCDIR):$(white_paper_dir):" hevea -O -fix $< -o $@ $(doc_dir)/tools/clearbanner.sh $@ WHITE_PAPER_PDF = $(white_paper_dir)/white_paper.pdf white-paper-pdf: $(WHITE_PAPER_PDF) -$(WHITE_PAPER_PDF): $(white_paper_dir)/white_paper.tex $(PNGS) - TEXINPUTS=$(white_paper_TEXINPUTS) pdflatex $< - TEXINPUTS=$(white_paper_TEXINPUTS) pdflatex $< - TEXINPUTS=$(white_paper_TEXINPUTS) pdflatex $< \ - test "x$(white_paper_dir)" != x. \ - && mv -f white_paper.pdf $(white_paper_dir) - +# Extra dependencies. +$(WHITE_PAPER_PDF): $(PNGS) dist_doc_DATA += \ $(WHITE_PAPER_HTML) \ @@ -532,10 +522,6 @@ clean-local: .PHONY: ref-guide ref-guide-html ref-guide-pdf -ref_guide_TEXINPUTS = "$(DOC_SRCDIR):$(OUTPUTS_SRCDIR):\ -$(SPLIT_OUTPUTS_SRCDIR):$(IMG_SRCDIR):$(SPLIT_EXAMPLES_SRCDIR):" - - ref-guide: ref-guide-html ref-guide-pdf ref_guide_dir = $(doc_dir)/ref_guide @@ -588,12 +574,8 @@ $(REF_GUIDE_HH): $(ref_guide_dir)/ref_guide.tex $(ref_guide_dependencies) # Final product. REF_GUIDE_PDF = $(ref_guide_dir)/ref_guide.pdf ref-guide-pdf: $(REF_GUIDE_PDF) -$(REF_GUIDE_PDF): $(ref_guide_dir)/ref_guide.tex $(ref_guide_dependencies) - TEXINPUTS=$(ref_guide_TEXINPUTS) pdflatex $< - TEXINPUTS=$(ref_guide_TEXINPUTS) pdflatex $< - TEXINPUTS=$(ref_guide_TEXINPUTS) pdflatex $< \ - test x"$(ref_guide_dir)" != x. \ - && mv -f ref_guide.pdf $(ref_guide_dir) +# Extra dependencies. +$(REF_GUIDE_PDF): $(ref_guide_dependencies) dist_doc_DATA += $(REF_GUIDE_PDF) -- 1.5.6.5

1 0

last-svn-commit-42-gf5190ea List non generated documentation outputs separately.
by Roland Levillain 01 Apr '10

01 Apr '10

* doc/Makefile.am (OUTPUTS, EXAMPLES): Sort in lexicographical order. Remove $(srcdir)/outputs/ima2d-decl-2.txt Move $(srcdir)/outputs/graph-output-1.txt, $(srcdir)/outputs/ima2d-display-1.txt, $(srcdir)/outputs/ima2d-display-2.txt, $(srcdir)/outputs/ima2d-display-output-1.txt, $(srcdir)/outputs/ima2d-display-output-2.txt, $(srcdir)/outputs/parray-display-1.txt and $(srcdir)/outputs/win-create-1-display.txt... (MORE_OUTPUTS): ...here (new variable). * doc/outputs/ima2d-decl-2.txt: Remove. --- milena/ChangeLog | 17 +++++++++++++++++ milena/doc/Makefile.am | 29 +++++++++++++++++------------ 2 files changed, 34 insertions(+), 12 deletions(-) delete mode 100644 milena/doc/outputs/ima2d-decl-2.txt diff --git a/milena/ChangeLog b/milena/ChangeLog index 48993e2..3ac7958 100644 --- a/milena/ChangeLog +++ b/milena/ChangeLog @@ -1,5 +1,22 @@ 2010-03-12 Roland Levillain <roland(a)lrde.epita.fr> + List non generated documentation outputs separately. + + * doc/Makefile.am (OUTPUTS, EXAMPLES): + Sort in lexicographical order. + Remove $(srcdir)/outputs/ima2d-decl-2.txt + Move $(srcdir)/outputs/graph-output-1.txt, + $(srcdir)/outputs/ima2d-display-1.txt, + $(srcdir)/outputs/ima2d-display-2.txt, + $(srcdir)/outputs/ima2d-display-output-1.txt, + $(srcdir)/outputs/ima2d-display-output-2.txt, + $(srcdir)/outputs/parray-display-1.txt and + $(srcdir)/outputs/win-create-1-display.txt... + (MORE_OUTPUTS): ...here (new variable). + * doc/outputs/ima2d-decl-2.txt: Remove. + +2010-03-12 Roland Levillain <roland(a)lrde.epita.fr> + Use texi2dvi to produce PDF from LaTeX. * doc/Makefile.am: Include $(top_srcdir)/build-aux/tex.mk. diff --git a/milena/doc/Makefile.am b/milena/doc/Makefile.am index 10c8fef..98e3332 100644 --- a/milena/doc/Makefile.am +++ b/milena/doc/Makefile.am @@ -771,7 +771,9 @@ OUTPUTS = \ $(srcdir)/outputs/fun-p2v-1.txt \ $(srcdir)/outputs/graph-data.txt \ $(srcdir)/outputs/graph-iter.txt \ - $(srcdir)/outputs/graph-output-1.txt \ + $(srcdir)/outputs/ima-has.txt \ + $(srcdir)/outputs/ima-save.txt \ + $(srcdir)/outputs/ima-size.txt \ $(srcdir)/outputs/ima2d-1.txt \ $(srcdir)/outputs/ima2d-2.txt \ $(srcdir)/outputs/ima2d-3.txt \ @@ -779,21 +781,12 @@ OUTPUTS = \ $(srcdir)/outputs/ima2d-5.txt \ $(srcdir)/outputs/ima2d-6-clone.txt \ $(srcdir)/outputs/ima2d-7.txt \ - $(srcdir)/outputs/ima2d-decl-2.txt \ - $(srcdir)/outputs/ima2d-display-1.txt \ - $(srcdir)/outputs/ima2d-display-2.txt \ - $(srcdir)/outputs/ima2d-display-output-1.txt \ - $(srcdir)/outputs/ima2d-display-output-2.txt \ $(srcdir)/outputs/ima2d-rot.txt \ - $(srcdir)/outputs/ima-has.txt \ - $(srcdir)/outputs/ima-save.txt \ - $(srcdir)/outputs/ima-size.txt \ $(srcdir)/outputs/labeling-compute.txt \ $(srcdir)/outputs/logical-not.txt \ $(srcdir)/outputs/mln_var.txt \ $(srcdir)/outputs/parray-append.txt \ $(srcdir)/outputs/parray-bbox.txt \ - $(srcdir)/outputs/parray-display-1.txt \ $(srcdir)/outputs/paste-call-1.txt \ $(srcdir)/outputs/paste.txt \ $(srcdir)/outputs/point-1.txt \ @@ -806,10 +799,22 @@ OUTPUTS = \ $(srcdir)/outputs/tuto4_genericity_and_algorithms.txt \ $(srcdir)/outputs/tuto4_point2d.txt \ $(srcdir)/outputs/tuto4_site_set_create.txt \ - $(srcdir)/outputs/win-create-1-display.txt \ $(srcdir)/outputs/win-create-1.txt \ $(srcdir)/outputs/win-create-2.txt +## FIXME: These outpouts are also required by the (LaTeX) +## documentation. However, they have no corresponding program in +## examples/, hence they cannot be regenerated. Are they hand-made +## outputs? Or maybe outputs of which program has been removed since? +MORE_OUTPUTS = \ + $(srcdir)/outputs/graph-output-1.txt \ + $(srcdir)/outputs/ima2d-display-1.txt \ + $(srcdir)/outputs/ima2d-display-2.txt \ + $(srcdir)/outputs/ima2d-display-output-1.txt \ + $(srcdir)/outputs/ima2d-display-output-2.txt \ + $(srcdir)/outputs/parray-display-1.txt \ + $(srcdir)/outputs/win-create-1-display.txt + $(DOC_SRCDIR)/examples-outputs.mk: $(DOC_SRCDIR)/gen-examples-outputs-mk $(srcdir)/Makefile.am $(DOC_SRCDIR)/gen-examples-outputs-mk $(PROGRAMS_examples) >$@.tmp mv -f $@.tmp $@ @@ -824,7 +829,6 @@ MAINTAINERCLEANFILES += $(OUTPUTS) # FIXME: Try to avoid the use an extensive list: either use Make's # substitution rules or generate it. EXAMPLES = \ - $(srcdir)/examples/ima-save.cc \ $(srcdir)/examples/accu-right-instanciation.cc \ $(srcdir)/examples/borderthickness.cc \ $(srcdir)/examples/box2d-bbox.cc \ @@ -845,6 +849,7 @@ EXAMPLES = \ $(srcdir)/examples/graph-iter.cc \ $(srcdir)/examples/ima-has.cc \ $(srcdir)/examples/ima-load.cc \ + $(srcdir)/examples/ima-save.cc \ $(srcdir)/examples/ima-size.cc \ $(srcdir)/examples/ima2d-1.cc \ $(srcdir)/examples/ima2d-2.cc \ diff --git a/milena/doc/outputs/ima2d-decl-2.txt b/milena/doc/outputs/ima2d-decl-2.txt deleted file mode 100644 index e69de29..0000000 -- 1.5.6.5

1 0

last-svn-commit-43-g0f9327c Split LaTeX-to-HTML rules to clear things up.
by Roland Levillain 01 Apr '10

01 Apr '10

* doc/tools/todoxygen.sh: Take a HTML file as input instead of a LaTeX one. * doc/Makefile.am (DOC_PACKAGES): New variable. (TECHNICAL_HTML, TUTORIAL_HTML, REF_GUIDE_HTML): New variables. ($(TECHNICAL_HTML), $(TUTORIAL_HTML), $(REF_GUIDE_HTML)): New targets. (dist_doc_DATA): Add $(TECHNICAL_HTML), $(TUTORIAL_HTML) and $(REF_GUIDE_HTML). ($(TECHNICAL_HH)): Depend on and process $(TECHNICAL_HTML) instead of $(technical_dir)/technical.tex. ($(TUTORIAL_HH)): Depend on and process $(TUTORIAL_HTML) instead of $(tutorial_dir)/tutorial.tex. ($(REF_GUIDE_HH)): Depend on and process $(REF_GUIDE_HTML) instead of $(ref_guide_dir)/ref_guide.tex. (CLEANFILES): Remove now useless patterns. (clean-local): Likewise. Adjust paths. --- milena/ChangeLog | 23 ++++++++++ milena/doc/Makefile.am | 94 +++++++++++++++++++---------------------- milena/doc/tools/todoxygen.sh | 46 ++++++++++++-------- 3 files changed, 94 insertions(+), 69 deletions(-) diff --git a/milena/ChangeLog b/milena/ChangeLog index 3ac7958..80ea76d 100644 --- a/milena/ChangeLog +++ b/milena/ChangeLog @@ -1,5 +1,28 @@ 2010-03-12 Roland Levillain <roland(a)lrde.epita.fr> + Split LaTeX-to-HTML rules to clear things up. + + * doc/tools/todoxygen.sh: Take a HTML file as input instead of a + LaTeX one. + * doc/Makefile.am (DOC_PACKAGES): New variable. + (TECHNICAL_HTML, TUTORIAL_HTML, REF_GUIDE_HTML): + New variables. + ($(TECHNICAL_HTML), $(TUTORIAL_HTML), $(REF_GUIDE_HTML)): + New targets. + (dist_doc_DATA): Add $(TECHNICAL_HTML), $(TUTORIAL_HTML) and + $(REF_GUIDE_HTML). + ($(TECHNICAL_HH)): Depend on and process $(TECHNICAL_HTML) instead + of $(technical_dir)/technical.tex. + ($(TUTORIAL_HH)): Depend on and process $(TUTORIAL_HTML) instead + of $(tutorial_dir)/tutorial.tex. + ($(REF_GUIDE_HH)): Depend on and process $(REF_GUIDE_HTML) instead + of $(ref_guide_dir)/ref_guide.tex. + (CLEANFILES): Remove now useless patterns. + (clean-local): Likewise. + Adjust paths. + +2010-03-12 Roland Levillain <roland(a)lrde.epita.fr> + List non generated documentation outputs separately. * doc/Makefile.am (OUTPUTS, EXAMPLES): diff --git a/milena/doc/Makefile.am b/milena/doc/Makefile.am index 98e3332..0d74098 100644 --- a/milena/doc/Makefile.am +++ b/milena/doc/Makefile.am @@ -90,6 +90,10 @@ TEXI2DVI_FLAGS += \ -I $(DOC_SRCDIR) -I $(OUTPUTS_SRCDIR) -I $(SPLIT_OUTPUTS_SRCDIR) \ -I $(IMG_SRCDIR) -I $(SPLIT_EXAMPLES_SRCDIR) +# Additional files for HeVeA compilations. +DOC_PACKAGES = $(srcdir)/doxyfuns.sty $(srcdir)/milena.sty + + ## ----------------------- ## ## Doxygen documentation. ## ## ----------------------- ## @@ -310,6 +314,16 @@ technical_dependencies = $(doc_dir)/figures.stamp # product is a directory, also refresh a timestamp (in the source # dir). +## FIXME: technical technical.hh does not seem to be used (by the +## Doyxgen documentation); remove its generation? Careful, +## technical/technical.html *is* probably required, though. + +TECHNICAL_HTML = $(technical_dir)/technical.html +$(TECHNICAL_HTML): $(technical_dir)/technical.tex $(technical_dependencies) + hevea -O -fix $(DOC_PACKAGES) $< -o $@ + +dist_doc_DATA += $(TECHNICAL_HTML) + # Intermediate product for the various doc targets of the parent # directory. # @@ -317,8 +331,10 @@ technical_dependencies = $(doc_dir)/figures.stamp # extension, since it is later parsed by Doxygen, which complains # about `.html' files. TECHNICAL_HH = $(technical_dir)/technical.hh +# FIXME: Careful, technical-html depends on $(TECHNICAL_HH), not +# $(TECHNICAL_HTML). Anyway, this shortcut should vanish soon. technical-html: $(TECHNICAL_HH) -$(TECHNICAL_HH): $(technical_dir)/technical.tex $(technical_dependencies) +$(TECHNICAL_HH): $(TECHNICAL_HTML) $(doc_dir)/tools/todoxygen.sh $(doc_dir)/tools/todoxygen.sh $< $(technical_dir) $(doc_dir) @@ -334,20 +350,7 @@ EXTRA_DIST += \ $(technical_dir)/technical.tex \ $(TECHNICAL_HH) -# FIXME: Remove `tutorial.aux tutorial.toc tutorial.log tutorial.bbl -# tutorial.out *blg *.lot' when texi2dvi is used. -# -# FIXME: Why is $(TUTORIAL_PDF) listed here? It should be -# automatically cleaned. I'm not sure either about the rest of -# CLEANFILES. -CLEANFILES += \ - technical.aux technical.toc technical.log technical.bbl technical.out \ - *blg *.lot \ - $(TECHNICAL_PDF) \ - *.haux *.hh *.html *.htoc \ - technical.html \ - technical.idx \ - $(TECHNICAL_HH) +CLEANFILES += $(technical_dir)/technical.haux ## ---------- ## @@ -393,6 +396,12 @@ tutorial_dependencies = \ # product is a directory, also refresh a timestamp (in the source # dir). +TUTORIAL_HTML = $(tutorial_dir)/tutorial.html +$(TUTORIAL_HTML): $(tutorial_dir)/tutorial.tex $(tutorial_dependencies) + hevea -O -fix $(DOC_PACKAGES) $< -o $@ + +dist_doc_DATA += $(TUTORIAL_HTML) + # Intermediate product for the various doc targets of the parent # directory. # @@ -400,10 +409,13 @@ tutorial_dependencies = \ # since it is later parsed by Doxygen, which complains about `.html' # files. TUTORIAL_HH = $(tutorial_dir)/tutorial.hh +# FIXME: Careful, tutorial-html depends on $(TUTORIAL_HH), not +# $(TUTORIAL_HTML). Anyway, this shortcut should vanish soon. tutorial-html: $(TUTORIAL_HH) -$(TUTORIAL_HH): $(tutorial_dir)/tutorial.tex $(tutorial_dependencies) +$(TUTORIAL_HH): $(TUTORIAL_HTML) $(doc_dir)/tools/todoxygen.sh $(doc_dir)/tools/todoxygen.sh $< $(tutorial_dir) $(doc_dir) + # Final product. TUTORIAL_PDF = $(tutorial_dir)/tutorial.pdf tutorial-pdf: $(TUTORIAL_PDF) @@ -416,20 +428,10 @@ EXTRA_DIST += \ $(tutorial_dir)/tutorial.tex \ $(TUTORIAL_HH) -# FIXME: Remove `tutorial.aux tutorial.toc tutorial.log tutorial.bbl -# tutorial.out *blg *.lot' when texi2dvi is used. -# -# FIXME: Why is $(TUTORIAL_PDF) listed here? It should be +# FIXME: Why is $(TUTORIAL_HH) listed here? It should be # automatically cleaned. I'm not sure either about the rest of # CLEANFILES. -CLEANFILES += \ - tutorial.aux tutorial.toc tutorial.log tutorial.bbl tutorial.out \ - *blg *.lot \ - $(TUTORIAL_PDF) \ - *.haux *.hh *.html *.htoc \ - tutorial.html \ - tutorial.idx \ - $(TUTORIAL_HH) +CLEANFILES += $(tutorial_dir)/tutorial.haux ## ------------- ## @@ -505,15 +507,10 @@ EXTRA_DIST += \ $(PNGS) \ $(EPSS) -# FIXME: Remove unnecessary patterns. -CLEANFILES += \ - white_paper_image.* \ - white_paper.pdf \ - *.log *.idx *.out *.aux +CLEANFILES += $(EPSS) -# FIXME: Likewise. clean-local: - -rm -rf white_paper_html figures + -rm -rf $(white_paper_dir)/white_paper_html ## ----------------- ## @@ -559,6 +556,12 @@ ref_guide_dependencies = \ # product is a directory, also refresh a timestamp (in the source # dir). +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 $@ + +dist_doc_DATA += $(REF_GUIDE_HTML) + # Intermediate product for the various doc targets of the parent # directory. # @@ -566,8 +569,10 @@ ref_guide_dependencies = \ # since it is later parsed by Doxygen, which complains about `.html' # files. REF_GUIDE_HH = $(ref_guide_dir)/ref_guide.hh +# FIXME: Careful, ref-guide-html depends on $(REF_GUIDE_HH), not +# $(REF_GUIDE_HTML). Anyway, this shortcut should vanish soon. ref-guide-html: $(REF_GUIDE_HH) -$(REF_GUIDE_HH): $(ref_guide_dir)/ref_guide.tex $(ref_guide_dependencies) +$(REF_GUIDE_HH): $(REF_GUIDE_HTML) $(doc_dir)/tools/todoxygen.sh $(doc_dir)/tools/todoxygen.sh $< $(ref_guide_dir) $(doc_dir) @@ -583,20 +588,9 @@ EXTRA_DIST += \ $(ref_guide_dir)/ref_guide.tex \ $(REF_GUIDE_HH) -# FIXME: Remove `ref_guide.aux ref_guide.toc ref_guide.log -# ref_guide.bbl ref_guide.out *blg *.lot' when texi2dvi is used. -# -# FIXME: Why is $(REF_GUIDE_PDF) listed here? It should be -# automatically cleaned. I'm not sure either about the rest of -# CLEANFILES. -CLEANFILES += \ - ref_guide.aux ref_guide.toc ref_guide.log ref_guide.bbl ref_guide.out \ - *blg *.lot \ - $(REF_GUIDE_PDF) \ - *.haux *.hh *.html *.htoc \ - ref_guide.html \ - ref_guide.idx \ - $(REF_GUIDE_HH) +CLEANFILES += \ + $(ref_guide_dir)/ref_guide.haux \ + $(ref_guide_dir)/ref_guide.htoc ## --------- ## diff --git a/milena/doc/tools/todoxygen.sh b/milena/doc/tools/todoxygen.sh index c61f5e1..9acab35 100755 --- a/milena/doc/tools/todoxygen.sh +++ b/milena/doc/tools/todoxygen.sh @@ -1,19 +1,28 @@ -#!/bin/sh - -if [ $# -ne 3 ]; then - echo "Usage: $0 <file.tex> <output dir> <path to .sty>"; - exit 1; -fi - -out="$2/`basename $1 .tex`.hh" -html="$2/`basename $1 .tex`.html" - -DOC_PACKAGES=" - $3/doxyfuns.sty \ - $3/milena.sty" - -#Convert .tex to .html -hevea -O -fix $DOC_PACKAGES $1 -o $html +#! /bin/sh + +# todoxygen.sh: Turn HTML files into suitable inputs for doxygen. + +# Copyright (C) 2009, 2010 EPITA Research and Development Laboratory (LRDE). +# +# This file is part of Olena. +# +# Olena is free software: you can redistribute it and/or modify it under +# the terms of the GNU General Public License as published by the Free +# Software Foundation, version 2 of the License. +# +# Olena is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# 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; } + +html="$1" +out="$2/`basename $1 .html`.hh" bodyl=`grep -n "<BODY >" $html | cut -d ':' -f 1` nlines=`wc -l $html | cut -d ' ' -f 1` @@ -32,11 +41,10 @@ sed -i -e 's/&#X201C/\&ldquo/g' $out sed -i -e 's/&#X201D/\&rdquo/g' $out sed -i -e 's/&#X2261/\&equiv/g' $out -#Doxygen wants us to preserve '\n' after commands. -#\ref and \see do not need that extra new line. +# Doxygen wants us to preserve '\n' after commands. +# \ref and \see do not need that extra new line. for keyword in include section page subpage subsection subsubsection image; do sed -i -e "s/\\\\endhtmlonly\\\\$keyword/\\\\endhtmlonly\n\n\\\\$keyword/g" $out sed -i -e "s/\\\\endhtmlonly\*\//\\\\endhtmlonly\n\n\*\/\n\n/g" $out sed -i -e "s/\\\\$keyword $.*$\\\\htmlonly/\\\\$keyword \1\n\n\\\\htmlonly\n/g" $out done - -- 1.5.6.5

1 0

last-svn-commit-44-g512f054 Have bootstrap check for HeVeA 1.10.
by Roland Levillain 01 Apr '10

01 Apr '10

* bootstrap (require): Take a flag as an optional second argument. Use it to check for HeVeA 1.10. --- ChangeLog | 7 +++++++ bootstrap | 13 +++++++++---- 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/ChangeLog b/ChangeLog index 53ba20c..55690d0 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,10 @@ +2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + + Have bootstrap check for HeVeA 1.10. + + * bootstrap (require): Take a flag as an optional second argument. + Use it to check for HeVeA 1.10. + 2010-03-12 Roland Levillain <roland(a)lrde.epita.fr> Add texi2dvi as well as a Make helper to use it. diff --git a/bootstrap b/bootstrap index 62cc724..2bdd761 100755 --- a/bootstrap +++ b/bootstrap @@ -78,14 +78,17 @@ version_compare () esac } -# require TOOL REQUIREMENT -# ------------------------ +# require TOOL REQUIREMENT [OPTION] +# --------------------------------- # Test that TOOL exists, and its version is at least REQUIREMENT. +# If given, use OPTION to query TOOL; use `--version' otherwise. require () { - local version=$($1 --version | sed -n 's/[^0-9.]*$[0-9][0-9.]*$.*/\1/p;q') + local option + if test $# -eq 3; then option=$3; else option=--version; fi + local version=$($1 $option | sed -n 's/[^0-9.]*$[0-9][0-9.]*$.*/\1/p;q') test x"$version" != x || - fatal "$1 is required" + fatal "$1 (version $2 or better) is required" case $(version_compare "$2" "$version") in '>') fatal "$1 $2 or better is required: this is $1 $version";; esac @@ -126,6 +129,8 @@ 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 # Tell what's going on. set -x -- 1.5.6.5

1 0

last-svn-commit-45-g03ae101 Automake configuration.
by Roland Levillain 01 Apr '10

01 Apr '10

* configure.ac: Remove option `foreign'. Pass option `subdir-objects'. --- ChangeLog | 7 +++++++ configure.ac | 2 +- 2 files changed, 8 insertions(+), 1 deletions(-) diff --git a/ChangeLog b/ChangeLog index 55690d0..758f05e 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,12 @@ 2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Automake configuration. + + * configure.ac: Remove option `foreign'. + Pass option `subdir-objects'. + +2010-03-15 Roland Levillain <roland(a)lrde.epita.fr> + Have bootstrap check for HeVeA 1.10. * bootstrap (require): Take a flag as an optional second argument. diff --git a/configure.ac b/configure.ac index a07bec6..9b825a7 100644 --- a/configure.ac +++ b/configure.ac @@ -20,7 +20,7 @@ AC_CONFIG_AUX_DIR([build-aux]) AC_CONFIG_FILES([build-aux/Makefile]) # Automake. -AM_INIT_AUTOMAKE([1.10 foreign check-news dist-bzip2 nostdinc -Wall]) +AM_INIT_AUTOMAKE([1.10 subdir-objects check-news dist-bzip2 nostdinc -Wall]) # Package metadata. AC_CONFIG_FILES([milena/mln/version.hh]) -- 1.5.6.5

1 0

last-svn-commit-46-g5440f59 Support HTML outputs in tex.mk.
by Roland Levillain 01 Apr '10

01 Apr '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 758f05e..4b0583f 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

last-svn-commit-47-ga4af792 Use texi2dvi to produce HTML from LaTeX.
by Roland Levillain 01 Apr '10

01 Apr '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 80ea76d..8802252 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-48-gc8e9fa8 Have texi2dvi use TeX4ht instead of HeVeA to produce HTML outputs.
by Roland Levillain 01 Apr '10

01 Apr '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 4b0583f..f3d1ecb 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-49-g2038fc7 Adapt HTML generation to TeX4ht.
by Roland Levillain 01 Apr '10

01 Apr '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 8802252..38838b4 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-50-g6e6e5b7 Disable the implicit generation of HTML from LaTeX.
by Roland Levillain 01 Apr '10

01 Apr '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 f3d1ecb..a5dbe84 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