X-Git-Url: https://git.saurik.com/bison.git/blobdiff_plain/70986d84bc674b0fbd9a4dcf5ee192e2cec364bf..50977317cd10df482c3b35f61e9ee4522eee3c3b:/doc/local.mk?ds=sidebyside diff --git a/doc/local.mk b/doc/local.mk index 09c387a7..cac9f544 100644 --- a/doc/local.mk +++ b/doc/local.mk @@ -14,14 +14,21 @@ ## along with this program. If not, see . AM_MAKEINFOFLAGS = --no-split -info_TEXINFOS = doc/bison.texinfo +info_TEXINFOS = doc/bison.texi doc_bison_TEXINFOS = \ $(CROSS_OPTIONS_TEXI) \ doc/fdl.texi \ doc/gpl-3.0.texi -CLEANFILES = doc/bison.fns -CLEANDIRS = doc/*.t2d +# Cannot express dependencies directly on file names because of Automake. +# Obfuscate with a variable. +doc_bison = doc/bison +$(doc_bison).dvi: $(FIGS_DOT:.dot=.eps) +$(doc_bison).pdf: $(FIGS_DOT:.dot=.pdf) +$(doc_bison).html: $(FIGS_DOT:.dot=.html) + +TEXI2DVI = texi2dvi --build-dir=doc/bison.t2d -I doc +CLEANDIRS = doc/bison.t2d clean-local: rm -rf $(CLEANDIRS) @@ -36,7 +43,7 @@ $(CROSS_OPTIONS_TEXI): doc/bison.help $(CROSS_OPTIONS_PL) $(AM_V_GEN){ test ! -f $@ || cat $@; } >$@~ $(AM_V_at)test ! -f $@.tmp || rm -f $@.tmp $(AM_V_at)src/bison$(EXEEXT) --help | \ - perl $(CROSS_OPTIONS_PL) $(top_srcdir)/src/scan-gram.l >$@.tmp + $(PERL) $(CROSS_OPTIONS_PL) $(top_srcdir)/src/scan-gram.l >$@.tmp $(AM_V_at)diff -u $@~ $@.tmp || true $(AM_V_at)mv $@.tmp $@ MAINTAINERCLEANFILES = $(CROSS_OPTIONS_TEXI) @@ -46,12 +53,11 @@ MAINTAINERCLEANFILES = $(CROSS_OPTIONS_TEXI) ## ---------- ## EXTRA_DIST += doc/refcard.tex -CLEANFILES += doc/refcard.dvi doc/refcard.log doc/refcard.ps +CLEANFILES += doc/refcard.pdf -doc/refcard.dvi: doc/refcard.tex - $(AM_V_GEN)cd doc && tex refcard.tex +doc/refcard.pdf: doc/refcard.tex + $(AM_V_GEN) cd doc && pdftex $(abs_top_srcdir)/doc/refcard.tex -doc/refcard.ps: doc/refcard.dvi ## ---------------- ## @@ -80,9 +86,9 @@ doc/refcard.ps: doc/refcard.dvi EXTRA_DIST += $(top_srcdir)/doc/bison.help MAINTAINERCLEANFILES += $(top_srcdir)/doc/bison.help $(top_srcdir)/doc/bison.help: src/bison$(EXEEXT) - $(AM_V_GEN)$< --version >doc/bison.help.t - $(AM_V_at)$< --help >>doc/bison.help.t - $(AM_V_at)$(top_srcdir)/build-aux/move-if-change doc/bison.help.t $@ + $(AM_V_GEN)src/bison$(EXEEXT) --version >doc/bison.help.tmp + $(AM_V_at) src/bison$(EXEEXT) --help >>doc/bison.help.tmp + $(AM_V_at)$(top_srcdir)/build-aux/move-if-change doc/bison.help.tmp $@ ## ----------- ## @@ -113,6 +119,34 @@ $(top_srcdir)/doc/bison.1: doc/bison.help doc/bison.x $(top_srcdir)/configure nodist_man_MANS = doc/yacc.1 +## ----------------------------- ## +## Graphviz examples generation. ## +## ----------------------------- ## + +CLEANDIRS += doc/figs +FIGS_DOT = \ + doc/figs/example.dot \ + doc/figs/example-reduce.dot doc/figs/example-shift.dot +EXTRA_DIST += \ + $(FIGS_DOT) \ + $(FIGS_DOT:.dot=.eps) $(FIGS_DOT:.dot=.pdf) $(FIGS_DOT:.dot=.png) +SUFFIXES += .dot .eps .pdf .png + +.dot.eps: + $(AM_V_GEN) $(MKDIR_P) `echo "./$@" | sed -e 's,/[^/]*$$,,'` + $(AM_V_at) $(DOT) -Gmargin=0 -Teps $< >$@.tmp + $(AM_V_at) mv $@.tmp $@ + +.dot.pdf: + $(AM_V_GEN) $(MKDIR_P) `echo "./$@" | sed -e 's,/[^/]*$$,,'` + $(AM_V_at) $(DOT) -Gmargin=0 -Tpdf $< >$@.tmp + $(AM_V_at) mv $@.tmp $@ + +.dot.png: + $(AM_V_GEN) $(MKDIR_P) `echo "./$@" | sed -e 's,/[^/]*$$,,'` + $(AM_V_at) $(DOT) -Gmargin=0 -Tpng $< >$@.tmp + $(AM_V_at) mv $@.tmp $@ + ## -------------- ## ## Doxygenation. ## ## -------------- ## @@ -124,10 +158,11 @@ DOXYGEN = doxygen doc: html html-local: doc/Doxyfile - $(AM_V_GEN) cd doc && $(DOXYGEN) + $(AM_V_GEN) $(DOXYGEN) doc/Doxyfile edit = sed -e 's,@PACKAGE_NAME\@,$(PACKAGE_NAME),g' \ -e 's,@PACKAGE_VERSION\@,$(PACKAGE_VERSION),g' \ + -e 's,@PERL\@,$(PERL),g' \ -e 's,@top_builddir\@,$(top_builddir),g' \ -e 's,@top_srcdir\@,$(top_srcdir),g' @@ -138,4 +173,4 @@ CLEANFILES += doc/Doxyfile doc/Doxyfile: $(top_srcdir)/doc/Doxyfile.in $(AM_V_GEN) $(edit) $(top_srcdir)/doc/Doxyfile.in >doc/Doxyfile -CLEANDIRS += html latex +CLEANDIRS += doc/html