doc: Add release notes for 1.8.5
[fw/altos] / doc / Makefile
1 #
2 #       http://docbook.sourceforge.net/release/xsl/current/README
3 #
4
5 RELNOTES_INC=\
6         release-notes-1.8.5.inc \
7         release-notes-1.8.4.inc \
8         release-notes-1.8.3.inc \
9         release-notes-1.8.2.inc \
10         release-notes-1.8.1.inc \
11         release-notes-1.8.inc \
12         release-notes-1.7.inc \
13         release-notes-1.6.8.inc \
14         release-notes-1.6.5.inc \
15         release-notes-1.6.4.inc \
16         release-notes-1.6.3.inc \
17         release-notes-1.6.2.inc \
18         release-notes-1.6.1.inc \
19         release-notes-1.6.inc \
20         release-notes-1.5.inc \
21         release-notes-1.4.2.inc \
22         release-notes-1.4.1.inc \
23         release-notes-1.4.inc \
24         release-notes-1.3.2.inc \
25         release-notes-1.3.1.inc \
26         release-notes-1.3.inc \
27         release-notes-1.2.1.inc \
28         release-notes-1.2.inc \
29         release-notes-1.1.1.inc \
30         release-notes-1.1.inc \
31         release-notes-1.0.1.inc \
32         release-notes-0.9.2.inc \
33         release-notes-0.9.inc \
34         release-notes-0.8.inc \
35         release-notes-0.7.1.inc
36
37 IMAGES=\
38         altosui.png \
39         ascent.png \
40         configure-altimeter.png \
41         configure-altosui.png \
42         configure-groundstation.png \
43         configure-pyro.png \
44         descent.png \
45         device-selection.png \
46         easymega.svg \
47         easymega-v1.0-bottom.jpg \
48         easymega-v1.0-top.jpg \
49         easymini.svg \
50         easymini-top.jpg \
51         fire-igniter.png \
52         graph-configure.png \
53         graph-map.png \
54         graph.png \
55         graph-stats.png \
56         ignitor.png \
57         landed.png \
58         launch-pad.png \
59         load-maps.png \
60         micropeak-app.png \
61         micropeak-back.jpg \
62         micropeak-device-dialog.png \
63         micropeak-dime.jpg \
64         micropeak-download.png \
65         micropeak-graph-configure.png \
66         micropeak-graph.png \
67         micropeak-nofont.svg \
68         micropeak-preferences.png \
69         micropeak-raw-data.png \
70         micropeak-save-dialog.png \
71         micropeak-statistics.png \
72         MicroPeakUSB-2.0-inuse.jpg \
73         MicroPeakUSB-2.0.jpg \
74         monitor-idle.png \
75         scan-channels.png \
76         site-map.png \
77         table.png \
78         telegps-configure.png \
79         telegps-graph-configure.png \
80         telegps-graph-graph.png \
81         telegps-graph-map.png \
82         telegps-graph-stats.png \
83         telegps-info.png \
84         telegps-location.png \
85         telegps-map.png \
86         telegps-preferences.png \
87         telegps-scan.png \
88         telegps-status.png \
89         telegps-table.png \
90         telegps-v1.0-top.jpg \
91         telemega.svg \
92         telemega-v1.0-top.jpg \
93         telemetrum.svg \
94         telemetrum-v1.1-thside.jpg \
95         telemetrum-v2.0-th.jpg \
96         telemini-v1.svg \
97         telemini-v1-top.jpg \
98         telemini-v3.svg \
99         telemini-v3.0-top.jpg \
100         telemini-v3.0-bottom.jpg \
101         altusmetrum-oneline.svg \
102         telegps-oneline.svg \
103         micropeak-oneline.svg
104
105 TXT_FILES=altusmetrum.txt
106
107 COMMON_INC_FILES=\
108         config-device.inc \
109         config-ui.inc \
110         load-maps.inc \
111         aprs-operation.inc \
112         handling.inc
113
114 INC_FILES=\
115         dedication.inc \
116         intro.inc \
117         getting-started.inc \
118         usage.inc \
119         telemetrum.inc \
120         telemini.inc \
121         easymini-device.inc \
122         telemega.inc \
123         easymega.inc \
124         installation.inc \
125         using-am-products.inc \
126         updating-firmware.inc \
127         altosui.inc \
128         altosdroid.inc \
129         system-operation.inc \
130         pyro-channels.inc \
131         flight-data-recording.inc \
132         specs.inc \
133         $(COMMON_INC_FILES) \
134         release-notes.inc \
135         $(RELNOTES_INC)
136
137 RAW_FILES=$(TXT_FILES:.txt=.raw) $(INC_FILES:.inc=.raw)
138
139 TELEGPS_INC_FILES=\
140         telegps-dedication.inc \
141         telegps-quick-start.inc \
142         telegps-using.inc \
143         telegps-system-operation.inc \
144         telegps-application.inc \
145         telegps-specs.inc \
146         telegps-updating-firmware.inc \
147         telegps-release-notes.inc \
148         $(COMMON_INC_FILES)
149
150 TELEGPS_TXT_FILES=\
151         telegps.txt
152
153 TELEGPS_RAW_FILES=$(TELEGPS_TXT_FILES:.txt=.raw) $(TELEGPS_INC_FILES:.inc=.raw)
154
155 MICROPEAK_TXT_FILES=\
156         micropeak.txt
157
158 MICROPEAK_INC_FILES=
159
160 MICROPEAK_RAW_FILES=$(MICROPEAK_TXT_FILES:.txt=.raw) $(MICROPEAK_INC_FILES:.inc=.raw)
161
162 EASYMINI_TXT_FILES=\
163         easymini.txt
164
165 EASYMINI_INC_FILES=$(INC_FILES) easymini-release-notes.inc
166
167
168 EASYMINI_RAW_FILES=$(EASYMINI_TXT_FILES:.txt=.raw) $(EASYMINI_INC_FILES:.inc=.raw)
169
170 OUTLINE_TXT_FILES=\
171         easymega-outline.txt \
172         easymini-outline.txt \
173         telemega-outline.txt \
174         telemetrum-outline.txt \
175         telemini-v1-outline.txt \
176         telemini-v3-outline.txt \
177         telegps-outline.txt
178
179 OUTLINE_RAW_FILES=$(OUTLINE_TXT_FILES:.txt=.raw)
180
181 OUTLINE_PDF_FILES=$(OUTLINE_TXT_FILES:.txt=.pdf)
182
183 SVG=\
184         easymini.svg \
185         telemega.svg \
186         telemetrum.svg \
187         telemini-v1.svg \
188         telemini-v3.svg \
189         easymega.svg
190
191 RELNOTES_HTML=$(RELNOTES_INC:.inc=.html)
192
193 ONEFILE_TXT_FILES=\
194         altos.txt \
195         companion.txt \
196         telemetry.txt
197
198 ONEFILE_RAW_FILES=$(ONEFILE_TXT_FILES:.txt=.raw)
199 ONEFILE_PDF_FILES=$(ONEFILE_TXT_FILES:.txt=.pdf)
200 ONEFILE_HTML_FILES=$(ONEFILE_TXT_FILES:.txt=.html)
201
202 AM_HTML=am.html
203
204 PUBLISH_HTML=altusmetrum.html micropeak.html telegps.html easymini.html $(ONEFILE_HTML_FILES)
205
206 HTML=$(PUBLISH_HTML) $(RELNOTES_HTML)
207
208 HTML_REVHISTORY=\
209         altusmetrum-revhistory.html \
210         micropeak-revhistory.html \
211         telegps-revhistory.html \
212         easymini-revhistory.html
213
214 PDF=altusmetrum.pdf micropeak.pdf telegps.pdf easymini.pdf $(ONEFILE_PDF_FILES) \
215         $(OUTLINE_PDF_FILES)
216
217 FOP_STYLE=am-fo.xsl
218 HTML_STYLE=am-html.xsl
219 COMMON_STYLE=common.xsl
220 FOP_XCONF=fop.xconf
221 STYLESHEET=am.css
222
223 FONTS=\
224         fonts/DejaVuSansMono-BoldOblique.ttf \
225         fonts/DejaVuSansMono-Bold.ttf \
226         fonts/DejaVuSansMono-Oblique.ttf \
227         fonts/DejaVuSansMono.ttf \
228         fonts/OpenSans-Light.ttf \
229         fonts/OpenSans-LightItalic.ttf \
230         fonts/OpenSans-Regular.ttf \
231         fonts/OpenSans-Italic.ttf \
232         fonts/OpenSans-Semibold.ttf \
233         fonts/OpenSans-SemiboldItalic.ttf
234
235 TEMPLATES_TMPL=titlepage.templates.tmpl
236
237 TEMPLATES_XSL=$(TEMPLATES_TMPL:.tmpl=.xsl)
238
239 PDF_CONFIG_FILES=$(FOP_STYLE) $(COMMON_STYLE) $(FOP_XCONF) $(TEMPLATES_XSL)
240 HTML_CONFIG_FILES=$(HTML_STYLE) $(COMMON_STYLE) $(TEMPLATES_XSL)
241
242 PUBLISH_DOC=$(PUBLISH_HTML) $(HTML_REVHISTORY) $(PDF) $(IMAGES) $(STYLESHEET)
243
244 DOC=$(HTML) $(HTML_REVHISTORY) $(PDF) $(IMAGES) $(STYLESHEET)
245
246 .SUFFIXES: .tmpl .xsl .inc .txt .raw .pdf .html
247
248 .txt.raw:
249         sed -e 's/^[    ]*//' -e 's/^\\//' $*.txt > $@
250
251 .inc.raw:
252         sed -e 's/^[    ]*//' -e 's/^\\//' $*.inc > $@
253
254 .raw.html:
255         a2x --verbose -a docinfo -f pdf --xsltproc-opts "--stringparam toc.section.depth 2" --xsl-file $(FOP_STYLE) --fop --fop-opts="-c $(FOP_XCONF)" $*.raw
256         a2x --verbose -a docinfo -f xhtml --xsltproc-opts "--stringparam toc.section.depth 2" --xsl-file $(HTML_STYLE) --stylesheet=$(STYLESHEET) $*.raw
257         case $* in release-notes*) ./fix-html $*.html ;; esac
258
259 .html.pdf:
260         @touch $@
261
262 .tmpl.xsl:
263         xsltproc --output $@ /usr/share/xml/docbook/stylesheet/docbook-xsl/template/titlepage.xsl $*.tmpl
264
265 all:    $(HTML) $(PDF)
266
267 altusmetrum-revhistory.html: altusmetrum.html
268
269 micropeak-revhistory.html: micropeak.html
270
271 telegps-revhistory.html: telegps.html
272
273 altusmetrum.pdf altusmetrum.html: altusmetrum-docinfo.xml $(RAW_FILES) $(IMAGES)
274
275 telegps.html telegps.pdf: telegps-docinfo.xml $(TELEGPS_RAW_FILES) $(IMAGES)
276
277 micropeak.pdf micropeak.html: micropeak-docinfo.xml $(MICROPEAK_RAW_FILES) $(IMAGES)
278
279 easymini.pdf easymini.html: easymini-docinfo.xml $(EASYMINI_RAW_FILES) $(IMAGES)
280
281 telemini-v1-outline.pdf: telemini-v1-outline.txt telemini-v1.svg
282
283 telemini-v3-outline.pdf: telemini-v3-outline.txt telemini-v3.svg
284
285 install:        all
286
287 WEB_ROOT=/home/bdale/web/
288
289 publish:        $(PUBLISH_DOC) $(FONTS)
290         cp $(PUBLISH_DOC) $(WEB_ROOT)/altusmetrum/AltOS/doc/
291         mkdir -p $(WEB_ROOT)/altusmetrum/AltOS/doc/fonts/
292         cp $(FONTS) $(WEB_ROOT)/altusmetrum/AltOS/doc/fonts/
293         (cd $(WEB_ROOT)/altusmetrum ; \
294          git add $(WEB_ROOT)/altusmetrum/AltOS/doc/* ; \
295          git add $(WEB_ROOT)/altusmetrum/AltOS/doc/fonts/* ; \
296          echo "update docs" | \
297          git commit -F - $(WEB_ROOT)/altusmetrum/AltOS/doc/* $(WEB_ROOT)/altusmetrum/AltOS/doc/fonts/* ; \
298          git push)
299
300 publish-keithp: am.html $(PUBLISH_DOC) $(FONTS)
301         scp -p am.html $(PUBLISH_DOC) keithp.com:~keithp/public_html/altos
302         scp -p $(FONTS) keithp.com:~keithp/public_html/altos/fonts
303
304 clean:
305         rm -f am.html $(HTML) $(HTML_REVHISTORY) $(PDF) $(TEMPLATES_XSL) $(RAW_FILES) $(TELEGPS_RAW_FILES) $(MICROPEAK_RAW_FILES)
306
307 distclean: clean
308         rm -f $(HTML) $(PDF)
309
310 $(PDF): $(PDF_CONFIG_FILES)
311 $(HTML): $(HTML_CONFIG_FILES)
312
313 am.html: Makefile make-am-html $(HTML)
314         sh ./make-am-html $(HTML) > $@