To get this branch, use:
bzr branch
http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar
« back to all changes in this revision
Viewing changes to Makefile
- browse files at revision 7199
- compare with another revision
- compare with revision 1663
- download diff
- download tarball
- view history from revision 7199
- Committer: Breezy landing bot
- Author(s): Jelmer Vernooij
- Date: 2018-11-18 21:24:22 UTC
- mfrom: (5255.6.5 sphinx-only)
- Revision ID: breezy.the.bot@gmail.com-20181118212422-qru79jkh68xvc3yf
Require sphinx for docs building, remove docutils.
Merged from https://code.launchpad.net/~jelmer/brz/sphinx-only/+merge/358957
Merged from https://code.launchpad.net/~jelmer/brz/sphinx-only/+merge/358957
- files modified:
- .travis.yml
added
removed
Makefile
118
118
119
119
### Documentation ###
120
120
121
# Default to plain documentation for maximum backwards compatibility.
122
# (Post 2.0, the defaults will most likely be Sphinx-style instead.)
123
124
docs: docs-plain
125
126
clean-docs: clean-plain
127
128
html-docs: html-plain
121
docs: docs-sphinx
122
123
clean-docs: clean-sphinx
124
125
html-docs: html-sphinx
129
126
130
127
131
128
### Man-page Documentation ###
216
213
$(PYTHON) tools/package_docs.py doc/developers $(DOC_WEBSITE_BUILD)
217
214
218
215
219
### Plain Documentation ###
220
221
# While Sphinx is the preferred tool for building documentation, we still
222
# support our "plain" html documentation so that Sphinx is not a hard
223
# dependency for packagers on older platforms.
224
225
rst2html = $(PYTHON) tools/rst2html.py --link-stylesheet --footnote-references=superscript --halt=warning
226
227
# translate txt docs to html
228
derived_txt_files = \
229
doc/en/release-notes/NEWS.txt
230
txt_all = \
231
doc/en/tutorials/tutorial.txt \
232
doc/en/tutorials/using_breezy_with_launchpad.txt \
233
doc/en/tutorials/centralized_workflow.txt \
234
$(call sw,doc/*/mini-tutorial/index.txt) \
235
$(call sw,doc/*/user-guide/index-plain.txt) \
236
doc/en/admin-guide/index-plain.txt \
237
$(call sw,doc/es/guia-usario/*.txt) \
238
$(derived_txt_files) \
239
doc/en/upgrade-guide/index.txt \
240
doc/index.txt \
241
$(call sw,doc/index.*.txt)
242
txt_nohtml = \
243
doc/en/user-guide/index.txt \
244
doc/en/admin-guide/index.txt
245
txt_files = $(filter-out $(txt_nohtml), $(txt_all))
246
htm_files = $(patsubst %.txt, %.html, $(txt_files))
247
248
non_txt_files = \
249
doc/default.css \
250
$(call sw,doc/*/brz-en-quick-reference.svg) \
251
$(call sw,doc/*/brz-en-quick-reference.png) \
252
$(call sw,doc/*/brz-en-quick-reference.pdf) \
253
$(call sw,doc/*/bzr-es-quick-reference.svg) \
254
$(call sw,doc/*/bzr-es-quick-reference.png) \
255
$(call sw,doc/*/bzr-es-quick-reference.pdf) \
256
$(call sw,doc/*/bzr-ru-quick-reference.svg) \
257
$(call sw,doc/*/bzr-ru-quick-reference.png) \
258
$(call sw,doc/*/bzr-ru-quick-reference.pdf) \
259
$(call sw,doc/*/user-guide/images/*.png)
260
261
# doc/developers/*.txt files that should *not* be individually
262
# converted to HTML
263
dev_txt_nohtml = \
264
doc/developers/add.txt \
265
doc/developers/annotate.txt \
266
doc/developers/bundle-creation.txt \
267
doc/developers/commit.txt \
268
doc/developers/diff.txt \
269
doc/developers/directory-fingerprints.txt \
270
doc/developers/gc.txt \
271
doc/developers/implementation-notes.txt \
272
doc/developers/incremental-push-pull.txt \
273
doc/developers/index.txt \
274
doc/developers/initial-push-pull.txt \
275
doc/developers/merge-scaling.txt \
276
doc/developers/miscellaneous-notes.txt \
277
doc/developers/missing.txt \
278
doc/developers/performance-roadmap-rationale.txt \
279
doc/developers/performance-use-case-analysis.txt \
280
doc/developers/planned-change-integration.txt \
281
doc/developers/planned-performance-changes.txt \
282
doc/developers/plans.txt \
283
doc/developers/process.txt \
284
doc/developers/revert.txt \
285
doc/developers/specifications.txt \
286
doc/developers/status.txt \
287
doc/developers/uncommit.txt
288
289
dev_txt_all = $(call sw,$(addsuffix /*.txt, doc/developers))
290
dev_txt_files = $(filter-out $(dev_txt_nohtml), $(dev_txt_all))
291
dev_htm_files = $(patsubst %.txt, %.html, $(dev_txt_files))
292
293
doc/en/user-guide/index-plain.html: $(call sw,$(addsuffix /*.txt, doc/en/user-guide))
294
$(rst2html) --stylesheet=../../default.css $(dir $@)index-plain.txt $@
295
296
#doc/es/user-guide/index.html: $(call sw,$(addsuffix /*.txt, doc/es/user-guide))
297
# $(rst2html) --stylesheet=../../default.css $(dir $@)index.txt $@
298
#
299
#doc/ru/user-guide/index.html: $(call sw,$(addsuffix /*.txt, doc/ru/user-guide))
300
# $(rst2html) --stylesheet=../../default.css $(dir $@)index.txt $@
301
#
302
doc/en/admin-guide/index-plain.html: $(call sw,$(addsuffix /*.txt, doc/en/admin-guide))
303
$(rst2html) --stylesheet=../../default.css $(dir $@)index-plain.txt $@
304
305
doc/developers/%.html: doc/developers/%.txt
306
$(rst2html) --stylesheet=../default.css $< $@
307
308
doc/index.html: doc/index.txt
309
$(rst2html) --stylesheet=default.css $< $@
310
311
doc/index.%.html: doc/index.%.txt
312
$(rst2html) --stylesheet=default.css $< $@
313
314
%.html: %.txt
315
$(rst2html) --stylesheet=../../default.css $< "$@"
316
317
doc/en/release-notes/NEWS.txt: $(NEWS_FILES) tools/generate_release_notes.py
318
$(PYTHON) tools/generate_release_notes.py "$@" $(NEWS_FILES)
319
320
upgrade_guide_dependencies = $(call sw,$(addsuffix /*.txt, doc/en/upgrade-guide))
321
322
doc/en/upgrade-guide/index.html: $(upgrade_guide_dependencies)
323
$(rst2html) --stylesheet=../../default.css $(dir $@)index.txt $@
324
325
derived_web_docs = $(htm_files) $(dev_htm_files)
326
WEB_DOCS = $(derived_web_docs) $(non_txt_files)
327
ALL_DOCS = $(derived_web_docs) $(MAN_PAGES)
328
329
# the main target to build all the docs
330
docs-plain: $(ALL_DOCS)
331
332
# produce a tree containing just the final docs, ready for uploading to the web
333
HTMLDIR = html_docs
334
html-plain: docs-plain
335
$(PYTHON) tools/win32/ostools.py copytree $(WEB_DOCS) $(HTMLDIR)
336
337
# clean produced docs
338
clean-plain:
339
$(PYTHON) tools/win32/ostools.py remove $(ALL_DOCS) \
340
$(HTMLDIR) $(derived_txt_files)
341
342
343
216
### Miscellaneous Documentation Targets ###
344
217
345
218
# build a png of our performance task list
Loggerhead is a web-based interface for Breezy
Version: 2.0.2.dev0