From d3f5222270f3c4c3e90533198b199cbc21fb31c8 Mon Sep 17 00:00:00 2001 From: Dirk Hohndel Date: Sat, 20 Dec 2014 11:37:49 -0800 Subject: Add Makefile to create ReleaseNotes HTML Add the first couple of entries for the next version of the ReleaseNotes. Signed-off-by: Dirk Hohndel --- ReleaseNotes/Makefile | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 ReleaseNotes/Makefile (limited to 'ReleaseNotes/Makefile') diff --git a/ReleaseNotes/Makefile b/ReleaseNotes/Makefile new file mode 100644 index 000000000..bba376022 --- /dev/null +++ b/ReleaseNotes/Makefile @@ -0,0 +1,45 @@ +# +# in order for "normal" developers not to have to install asciidoc (which +# brings in a couple hundred MB of dependencies) we now include both the +# user-manual.txt and a copy of the generated .html file in git +# +# in order to avoid unnecessary thrash with minor version differences, when +# submitting patches to the user manual, only submit the changes to the .txt +# file - the maintainer will recreate the .html.git file + +DOCNAMES = ReleaseNotes + +HTMLDOCS = $(patsubst %,$(OUT)%.html,$(DOCNAMES)) +TEXTDOCS = $(patsubst %,$(OUT)%.text,$(DOCNAMES)) +PDFDOCS = $(patsubst %,$(OUT)%.pdf,$(DOCNAMES)) + +ASCIIDOC = asciidoc +A2X = a2x +BROWSER = firefox +THEME = ../Documentation/compact_subsurface +PWD = $(realpath .) + +all: $(HTMLEDOCS) $(TEXTDOCS) $(PDFDOCS) + +doc: $(HTMLDOCS) + +$(OUT)%.text: %.txt + $(A2X) -f text $< + +$(OUT)%.pdf: %.txt + -$(A2X) --dblatex-opts "-P latex.output.revhistory=0" -f pdf $< + +$(OUT)%.html: %.txt + @echo "if asciidoc isn't found the html file included in the sources is copied" + $(ASCIIDOC) -a toc -a toclevels=3 -a themedir=$(PWD) -a theme=$(THEME) -a stylesdir=$(PWD) \ + -o $@ $< || cp $(<:%.txt=%.html.git) $@ + +# Alternatively:: +$(OUT)$(DOCNAME).xhtml: $(DOCSOURCE) + $(A2X) --icons -f xhtml $< + +show: $(HTMLDOC) + $(BROWSER) $< + +clean: + rm -f *~ *.xml docbook-xsl.css $(HTMLDOCS) $(TEXTDOCS) $(PDFDOCS) -- cgit v1.2.3-70-g09d2