Doc updates for version 1.8.4
[fw/altos] / doc / Makefile
index 7a4e0fa3abbc354683264bbd480db99e0c600a9c..7d33149dc8642af5c9ec9dc53a90a1a218e98a66 100644 (file)
@@ -3,24 +3,35 @@
 #
 
 RELNOTES_INC=\
-       release-notes-0.7.1.inc \
-       release-notes-0.8.inc \
-       release-notes-0.9.inc \
-       release-notes-0.9.2.inc \
-       release-notes-1.0.1.inc \
-       release-notes-1.1.inc \
-       release-notes-1.1.1.inc \
-       release-notes-1.2.inc \
-       release-notes-1.2.1.inc \
-       release-notes-1.3.inc \
-       release-notes-1.3.1.inc \
-       release-notes-1.3.2.inc \
-       release-notes-1.4.inc \
-       release-notes-1.4.1.inc \
-       release-notes-1.4.2.inc \
-       release-notes-1.5.inc \
+       release-notes-1.8.4.inc \
+       release-notes-1.8.3.inc \
+       release-notes-1.8.2.inc \
+       release-notes-1.8.1.inc \
+       release-notes-1.8.inc \
+       release-notes-1.7.inc \
+       release-notes-1.6.8.inc \
+       release-notes-1.6.5.inc \
+       release-notes-1.6.4.inc \
+       release-notes-1.6.3.inc \
+       release-notes-1.6.2.inc \
+       release-notes-1.6.1.inc \
        release-notes-1.6.inc \
-       release-notes-1.6.1.inc
+       release-notes-1.5.inc \
+       release-notes-1.4.2.inc \
+       release-notes-1.4.1.inc \
+       release-notes-1.4.inc \
+       release-notes-1.3.2.inc \
+       release-notes-1.3.1.inc \
+       release-notes-1.3.inc \
+       release-notes-1.2.1.inc \
+       release-notes-1.2.inc \
+       release-notes-1.1.1.inc \
+       release-notes-1.1.inc \
+       release-notes-1.0.1.inc \
+       release-notes-0.9.2.inc \
+       release-notes-0.9.inc \
+       release-notes-0.8.inc \
+       release-notes-0.7.1.inc
 
 IMAGES=\
        altosui.png \
@@ -81,9 +92,11 @@ IMAGES=\
        telemetrum.svg \
        telemetrum-v1.1-thside.jpg \
        telemetrum-v2.0-th.jpg \
-       telemini.svg \
+       telemini-v1.svg \
        telemini-v1-top.jpg \
-       telemini-v2-top.jpg \
+       telemini-v3.svg \
+       telemini-v3.0-top.jpg \
+       telemini-v3.0-bottom.jpg \
        altusmetrum-oneline.svg \
        telegps-oneline.svg \
        micropeak-oneline.svg
@@ -103,8 +116,7 @@ INC_FILES=\
        getting-started.inc \
        usage.inc \
        telemetrum.inc \
-       telemini-v1.0.inc \
-       telemini-v2.0.inc \
+       telemini.inc \
        easymini-device.inc \
        telemega.inc \
        easymega.inc \
@@ -159,7 +171,9 @@ OUTLINE_TXT_FILES=\
        easymini-outline.txt \
        telemega-outline.txt \
        telemetrum-outline.txt \
-       telemini-outline.txt
+       telemini-v1-outline.txt \
+       telemini-v3-outline.txt \
+       telegps-outline.txt
 
 OUTLINE_RAW_FILES=$(OUTLINE_TXT_FILES:.txt=.raw)
 
@@ -169,10 +183,10 @@ SVG=\
        easymini.svg \
        telemega.svg \
        telemetrum.svg \
-       telemini.svg \
+       telemini-v1.svg \
+       telemini-v3.svg \
        easymega.svg
 
-RELNOTES_PDF=$(RELNOTES_INC:.inc=.pdf)
 RELNOTES_HTML=$(RELNOTES_INC:.inc=.html)
 
 ONEFILE_TXT_FILES=\
@@ -182,8 +196,13 @@ ONEFILE_TXT_FILES=\
 
 ONEFILE_RAW_FILES=$(ONEFILE_TXT_FILES:.txt=.raw)
 ONEFILE_PDF_FILES=$(ONEFILE_TXT_FILES:.txt=.pdf)
+ONEFILE_HTML_FILES=$(ONEFILE_TXT_FILES:.txt=.html)
 
-HTML=altusmetrum.html micropeak.html telegps.html easymini.html $(RELNOTES_HTML) $(ONEFILE_HTML_FILES)
+AM_HTML=am.html
+
+PUBLISH_HTML=altusmetrum.html micropeak.html telegps.html easymini.html $(ONEFILE_HTML_FILES)
+
+HTML=$(PUBLISH_HTML) $(RELNOTES_HTML)
 
 HTML_REVHISTORY=\
        altusmetrum-revhistory.html \
@@ -191,7 +210,7 @@ HTML_REVHISTORY=\
        telegps-revhistory.html \
        easymini-revhistory.html
 
-PDF=altusmetrum.pdf micropeak.pdf telegps.pdf easymini.pdf $(RELNOTES_PDF) $(ONEFILE_PDF_FILES) \
+PDF=altusmetrum.pdf micropeak.pdf telegps.pdf easymini.pdf $(ONEFILE_PDF_FILES) \
        $(OUTLINE_PDF_FILES)
 
 FOP_STYLE=am-fo.xsl
@@ -219,6 +238,8 @@ TEMPLATES_XSL=$(TEMPLATES_TMPL:.tmpl=.xsl)
 PDF_CONFIG_FILES=$(FOP_STYLE) $(COMMON_STYLE) $(FOP_XCONF) $(TEMPLATES_XSL)
 HTML_CONFIG_FILES=$(HTML_STYLE) $(COMMON_STYLE) $(TEMPLATES_XSL)
 
+PUBLISH_DOC=$(PUBLISH_HTML) $(HTML_REVHISTORY) $(PDF) $(IMAGES) $(STYLESHEET)
+
 DOC=$(HTML) $(HTML_REVHISTORY) $(PDF) $(IMAGES) $(STYLESHEET)
 
 .SUFFIXES: .tmpl .xsl .inc .txt .raw .pdf .html
@@ -229,26 +250,26 @@ DOC=$(HTML) $(HTML_REVHISTORY) $(PDF) $(IMAGES) $(STYLESHEET)
 .inc.raw:
        sed -e 's/^[    ]*//' -e 's/^\\//' $*.inc > $@
 
-.raw.pdf:
-       a2x --verbose -a icons -a docinfo -f pdf --xsltproc-opts "--stringparam toc.section.depth 2" --xsl-file $(FOP_STYLE) --fop --fop-opts="-c $(FOP_XCONF)" $*.raw
-
 .raw.html:
-       a2x --verbose -a icons -a docinfo -f xhtml --xsltproc-opts "--stringparam toc.section.depth 2" --xsl-file $(HTML_STYLE) --stylesheet=$(STYLESHEET) $*.raw
+       a2x --verbose -a docinfo -f pdf --xsltproc-opts "--stringparam toc.section.depth 2" --xsl-file $(FOP_STYLE) --fop --fop-opts="-c $(FOP_XCONF)" $*.raw
+       a2x --verbose -a docinfo -f xhtml --xsltproc-opts "--stringparam toc.section.depth 2" --xsl-file $(HTML_STYLE) --stylesheet=$(STYLESHEET) $*.raw
+       case $* in release-notes*) ./fix-html $*.html ;; esac
+
+.html.pdf:
+       @touch $@
 
 .tmpl.xsl:
        xsltproc --output $@ /usr/share/xml/docbook/stylesheet/docbook-xsl/template/titlepage.xsl $*.tmpl
 
 all:   $(HTML) $(PDF)
 
-$(HTML): $(PDF)
-
 altusmetrum-revhistory.html: altusmetrum.html
 
 micropeak-revhistory.html: micropeak.html
 
 telegps-revhistory.html: telegps.html
 
-altusmetrum.pdf altusmetrum.html: altusmetrum-docinfo.xml $(RAW_FILES) $(RAW_INC) $(IMAGES)
+altusmetrum.pdf altusmetrum.html: altusmetrum-docinfo.xml $(RAW_FILES) $(IMAGES)
 
 telegps.html telegps.pdf: telegps-docinfo.xml $(TELEGPS_RAW_FILES) $(IMAGES)
 
@@ -256,28 +277,37 @@ micropeak.pdf micropeak.html: micropeak-docinfo.xml $(MICROPEAK_RAW_FILES) $(IMA
 
 easymini.pdf easymini.html: easymini-docinfo.xml $(EASYMINI_RAW_FILES) $(IMAGES)
 
+telemini-v1-outline.pdf: telemini-v1-outline.txt telemini-v1.svg
+
+telemini-v3-outline.pdf: telemini-v3-outline.txt telemini-v3.svg
+
 install:       all
 
-publish:       $(DOC) $(FONTS)
-       cp $(DOC) /home/bdale/web/altusmetrum/AltOS/doc/
-       mkdir -p /home/bdale/web/altusmetrum/AltOS/doc/fonts/
-       cp $(FONTS) /home/bdale/web/altusmetrum/AltOS/doc/fonts/
-       (cd /home/bdale/web/altusmetrum ; \
-        git add /home/bdale/web/altusmetrum/AltOS/doc/* ; \
-        git add /home/bdale/web/altusmetrum/AltOS/doc/fonts/* ; \
+WEB_ROOT=/home/bdale/web/
+
+publish:       $(PUBLISH_DOC) $(FONTS)
+       cp $(PUBLISH_DOC) $(WEB_ROOT)/altusmetrum/AltOS/doc/
+       mkdir -p $(WEB_ROOT)/altusmetrum/AltOS/doc/fonts/
+       cp $(FONTS) $(WEB_ROOT)/altusmetrum/AltOS/doc/fonts/
+       (cd $(WEB_ROOT)/altusmetrum ; \
+        git add $(WEB_ROOT)/altusmetrum/AltOS/doc/* ; \
+        git add $(WEB_ROOT)/altusmetrum/AltOS/doc/fonts/* ; \
         echo "update docs" | \
-        git commit -F - /home/bdale/web/altusmetrum/AltOS/doc/* /home/bdale/web/altusmetrum/AltOS/doc/fonts/* ; \
+        git commit -F - $(WEB_ROOT)/altusmetrum/AltOS/doc/* $(WEB_ROOT)/altusmetrum/AltOS/doc/fonts/* ; \
         git push)
 
-publish-keithp:        $(DOC) $(FONTS)
-       scp -p $(DOC) keithp.com:~keithp/public_html/altos
+publish-keithp:        am.html $(PUBLISH_DOC) $(FONTS)
+       scp -p am.html $(PUBLISH_DOC) keithp.com:~keithp/public_html/altos
        scp -p $(FONTS) keithp.com:~keithp/public_html/altos/fonts
 
 clean:
-       rm -f $(HTML) $(HTML_REVHISTORY) $(PDF) $(TEMPLATES_XSL) $(RAW_FILES) $(TELEGPS_RAW_FILES) $(MICROPEAK_RAW_FILES)
+       rm -f am.html $(HTML) $(HTML_REVHISTORY) $(PDF) $(TEMPLATES_XSL) $(RAW_FILES) $(TELEGPS_RAW_FILES) $(MICROPEAK_RAW_FILES)
 
 distclean: clean
        rm -f $(HTML) $(PDF)
 
 $(PDF): $(PDF_CONFIG_FILES)
 $(HTML): $(HTML_CONFIG_FILES)
+
+am.html: Makefile make-am-html $(HTML)
+       sh ./make-am-html $(HTML) > $@