← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to Makefile

  • Committer: John Arbash Meinel
  • Date: 2010-02-17 17:11:16 UTC
  • mfrom: (4797.2.17 2.1)
  • mto: (4797.2.18 2.1)
  • mto: This revision was merged to the branch mainline in revision 5055.
  • Revision ID: john@arbash-meinel.com-20100217171116-h7t9223ystbnx5h8
merge bzr.2.1 in preparation for NEWS entry.

Show diffs side-by-side

added added

removed removed

Lines of Context:
Makefile
1
 
# Copyright (C) 2005, 2006, 2007, 2008, 2009 Canonical Ltd
 
1
# Copyright (C) 2005-2010 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
39
39
check: docs check-nodocs
40
40
 
41
41
check-nodocs: extensions
42
 
        $(PYTHON) -Werror -O ./bzr selftest -1 --subunit $(tests)
 
42
        $(PYTHON) -Werror -O ./bzr selftest -1v $(tests)
43
43
 
44
44
# Run Python style checker (apt-get install pyflakes)
45
45
#
114
114
clean-sphinx:
115
115
        cd doc/en && make clean
116
116
        cd doc/es && make clean
 
117
        cd doc/ja && make clean
117
118
        cd doc/ru && make clean
118
119
        cd doc/developers && make clean
119
120
 
122
123
        doc/en/user-reference/index.txt \
123
124
        doc/es/Makefile \
124
125
        doc/es/make.bat \
 
126
        doc/ja/Makefile \
 
127
        doc/ja/make.bat \
125
128
        doc/ru/Makefile \
126
129
        doc/ru/make.bat \
127
130
        doc/developers/Makefile \
144
147
        cd doc/en && make html
145
148
        cd doc/es && make html
146
149
        cd doc/ru && make html
 
150
        cd doc/ja && make html
147
151
        cd doc/developers && make html
148
152
 
149
153
# Build the PDF docs using Sphinx. This requires numerous LaTeX
154
158
pdf-sphinx: $(SPHINX_DEPENDENCIES)
155
159
        cd doc/en && make latex
156
160
        cd doc/es && make latex
 
161
        cd doc/ja && make latex
157
162
        cd doc/developers && make latex
158
163
        cd doc/en/_build/latex && make all-pdf
159
164
        cd doc/es/_build/latex && make all-pdf
166
171
        cd doc/en && make htmlhelp
167
172
        cd doc/es && make htmlhelp
168
173
        cd doc/ru && make htmlhelp
 
174
        cd doc/ja && make htmlhelp
169
175
        cd doc/developers && make htmlhelp
170
176
 
171
177
 
172
178
### Documentation Website ###
173
179
 
174
180
# Where to build the website
175
 
DOC_WEBSITE_BUILD := build_doc_website
 
181
DOC_WEBSITE_BUILD = build_doc_website
176
182
 
177
183
# Build and package docs into a website, complete with downloads.
178
184
doc-website: html-sphinx pdf-sphinx
179
185
        $(PYTHON) tools/package_docs.py doc/en $(DOC_WEBSITE_BUILD)
180
186
        $(PYTHON) tools/package_docs.py doc/es $(DOC_WEBSITE_BUILD)
181
187
        $(PYTHON) tools/package_docs.py doc/ru $(DOC_WEBSITE_BUILD)
 
188
        $(PYTHON) tools/package_docs.py doc/ja $(DOC_WEBSITE_BUILD)
182
189
        $(PYTHON) tools/package_docs.py doc/developers $(DOC_WEBSITE_BUILD)
183
190
 
184
191
 
188
195
# support our "plain" html documentation so that Sphinx is not a hard
189
196
# dependency for packagers on older platforms.
190
197
 
191
 
rst2html := $(PYTHON) tools/rst2html.py --link-stylesheet --footnote-references=superscript --halt=warning
 
198
rst2html = $(PYTHON) tools/rst2html.py --link-stylesheet --footnote-references=superscript --halt=warning
192
199
 
193
200
# translate txt docs to html
194
 
derived_txt_files := \
195
 
        doc/en/user-reference/bzr_man.txt \
 
201
derived_txt_files = \
196
202
        doc/en/release-notes/NEWS.txt
197
 
txt_all := \
 
203
txt_all = \
198
204
        doc/en/tutorials/tutorial.txt \
199
205
        doc/en/tutorials/using_bazaar_with_launchpad.txt \
200
206
        doc/en/tutorials/centralized_workflow.txt \
201
207
        $(wildcard doc/es/tutorials/*.txt) \
202
 
        $(wildcard doc/ru/tutorials/*.txt) \
 
208
                $(wildcard doc/ru/tutorials/*.txt) \
 
209
        doc/ja/tutorials/tutorial.txt \
 
210
        doc/ja/tutorials/using_bazaar_with_launchpad.txt \
 
211
        doc/ja/tutorials/centralized_workflow.txt \
203
212
        $(wildcard doc/*/mini-tutorial/index.txt) \
204
213
        $(wildcard doc/*/user-guide/index-plain.txt) \
 
214
        doc/en/admin-guide/index-plain.txt \
205
215
        $(wildcard doc/es/guia-usario/*.txt) \
206
216
        $(derived_txt_files) \
207
217
        doc/en/upgrade-guide/index.txt \
208
218
        doc/index.txt \
209
219
        $(wildcard doc/index.*.txt)
210
 
txt_nohtml := \
 
220
txt_nohtml = \
211
221
        doc/en/user-guide/index.txt \
212
222
        doc/es/user-guide/index.txt \
213
 
        doc/ru/user-guide/index.txt
214
 
txt_files := $(filter-out $(txt_nohtml), $(txt_all))
215
 
htm_files := $(patsubst %.txt, %.html, $(txt_files)) 
 
223
        doc/ja/user-guide/index.txt \
 
224
        doc/ru/user-guide/index.txt \
 
225
        doc/en/admin-guide/index.txt
 
226
txt_files = $(filter-out $(txt_nohtml), $(txt_all))
 
227
htm_files = $(patsubst %.txt, %.html, $(txt_files)) 
216
228
 
217
 
non_txt_files := \
 
229
non_txt_files = \
218
230
       doc/default.css \
219
231
       $(wildcard doc/*/bzr-en-quick-reference.svg) \
220
232
       $(wildcard doc/*/bzr-en-quick-reference.png) \
229
241
 
230
242
# doc/developers/*.txt files that should *not* be individually
231
243
# converted to HTML
232
 
dev_txt_nohtml := \
 
244
dev_txt_nohtml = \
233
245
        doc/developers/add.txt \
234
246
        doc/developers/annotate.txt \
235
247
        doc/developers/bundle-creation.txt \
255
267
        doc/developers/status.txt \
256
268
        doc/developers/uncommit.txt
257
269
 
258
 
dev_txt_all := $(wildcard $(addsuffix /*.txt, doc/developers))
259
 
dev_txt_files := $(filter-out $(dev_txt_nohtml), $(dev_txt_all))
260
 
dev_htm_files := $(patsubst %.txt, %.html, $(dev_txt_files)) 
 
270
dev_txt_all = $(wildcard $(addsuffix /*.txt, doc/developers))
 
271
dev_txt_files = $(filter-out $(dev_txt_nohtml), $(dev_txt_all))
 
272
dev_htm_files = $(patsubst %.txt, %.html, $(dev_txt_files)) 
261
273
 
262
274
doc/en/user-guide/index-plain.html: $(wildcard $(addsuffix /*.txt, doc/en/user-guide)) 
263
275
        $(rst2html) --stylesheet=../../default.css $(dir $@)index-plain.txt $@
268
280
#doc/ru/user-guide/index.html: $(wildcard $(addsuffix /*.txt, doc/ru/user-guide)) 
269
281
#       $(rst2html) --stylesheet=../../default.css $(dir $@)index.txt $@
270
282
#
 
283
doc/en/admin-guide/index-plain.html: $(wildcard $(addsuffix /*.txt, doc/en/admin-guide)) 
 
284
        $(rst2html) --stylesheet=../../default.css $(dir $@)index-plain.txt $@
 
285
 
271
286
doc/developers/%.html: doc/developers/%.txt
272
287
        $(rst2html) --stylesheet=../default.css $< $@
273
288
 
280
295
%.html: %.txt
281
296
        $(rst2html) --stylesheet=../../default.css $< $@
282
297
 
283
 
doc/en/user-reference/bzr_man.txt: $(MAN_DEPENDENCIES)
284
 
        $(PYTHON) tools/generate_docs.py -o $@ rstx
285
 
 
286
298
doc/en/release-notes/NEWS.txt: NEWS
287
299
        $(PYTHON) -c "import shutil; shutil.copyfile('$<', '$@')"
288
300
 
299
311
docs-plain: $(ALL_DOCS)
300
312
 
301
313
# produce a tree containing just the final docs, ready for uploading to the web
302
 
HTMLDIR := html_docs
 
314
HTMLDIR = html_docs
303
315
html-plain: docs-plain
304
316
        $(PYTHON) tools/win32/ostools.py copytree $(WEB_DOCS) $(HTMLDIR)
305
317
 
325
337
# These are files that need to be copied into the build location to boostrap
326
338
# the build process.
327
339
# Note that the path is relative to tools/win32
328
 
BUILDOUT_FILES := buildout.cfg \
 
340
BUILDOUT_FILES = buildout.cfg \
329
341
        buildout-templates/bin/build-installer.bat.in \
330
342
        ostools.py bootstrap.py
331
343