1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
# Copyright (C) 2005, 2006, 2007 Canonical Ltd
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
# A relatively simple Makefile to assist in building parts of bzr. Mostly for
# building documentation, etc.
.PHONY: all clean pyflakes api-docs pydoctor-api-docs
all:
check:
python -Werror ./bzr selftest -v $(tests)
@echo "Running all tests with no locale."
LC_CTYPE= LANG=C LC_ALL= ./bzr selftest -v $(tests)
python -O -Werror ./bzr selftest -v $(tests)
check-msgeditor:
./bzr --no-plugins selftest -v msgeditor
# Run Python style checker (apt-get install pyflakes)
pyflakes:
pyflakes bzrlib
pyflakes-nounused:
# There are many of these warnings at the moment and they're not a
# high priority to fix
pyflakes bzrlib | grep -v ' imported but unused'
clean:
./setup.py clean
-find . -name "*.pyc" -o -name "*.pyo" | xargs rm -f
rm -rf test????.tmp
pydoctor-api-docs:
mkdir -p api/pydoctor
pydoctor -c pydoctor_bzrlib.cfg --make-html
docfiles = bzr bzrlib
api-docs:
mkdir -p api/epydoc
PYTHONPATH=$(PWD) python tools/bzr_epydoc --html -o api/epydoc --docformat 'restructuredtext en' $(docfiles)
# build emacs cross-reference
tag_files=./bzr ./bzrlib/*py ./bzrlib/selftest/*.py
TAGS: $(tag_files)
ctags-exuberant -e $(tag_files)
# Produce HTML docs to upload on Canonical server
HTMLDIR := html_docs
PRETTYDIR := pretty_docs
html-docs: docs
python tools/win32/ostools.py copytodir $(htm_files) doc/default.css $(HTMLDIR)
# translate txt docs to html
doc_dir := doc
txt_files := $(wildcard $(addsuffix /*.txt, $(doc_dir))) doc/bzr_man.txt
htm_files := $(patsubst %.txt, %.htm, $(txt_files))
pretty-html-docs: pretty_files
pretty_docs:
python -c "import os; os.mkdir('$(PRETTYDIR)')"
pretty_files: $(patsubst doc/%.txt, $(PRETTYDIR)/%.htm, $(txt_files))
doc/%.htm: doc/%.txt
python tools/rst2html.py --link-stylesheet --stylesheet=default.css doc/$*.txt doc/$*.htm
$(PRETTYDIR)/%.htm: pretty_docs doc/%.txt
python tools/rst2prettyhtml.py doc/bazaar-vcs.org.kid doc/$*.txt \
$(PRETTYDIR)/$*.htm
doc/bzr_man.txt: bzrlib/builtins.py \
bzrlib/bundle/commands.py \
bzrlib/conflicts.py \
bzrlib/sign_my_commits.py \
generate_docs.py \
tools/doc_generate/__init__.py \
tools/doc_generate/autodoc_rstx.py
python generate_docs.py -o doc/bzr_man.txt rstx
docs: $(htm_files)
copy-docs: docs
python tools/win32/ostools.py copytodir $(htm_files) doc/default.css NEWS README win32_bzr.exe/doc
# clean produced docs
clean-docs:
python tools/win32/ostools.py remove doc/bzr_man.txt $(htm_files) \
$(HTMLDIR) $(PRETTYDIR)
# make bzr.exe for win32 with py2exe
exe:
@echo *** Make bzr.exe
python setup.py py2exe > py2exe.log
python tools/win32/ostools.py copytodir tools/win32/start_bzr.bat win32_bzr.exe
python tools/win32/ostools.py copytodir tools/win32/bazaar.url win32_bzr.exe
# win32 installer for bzr.exe
installer: exe copy-docs
@echo *** Make windows installer
cog.py -d -o tools/win32/bzr.iss tools/win32/bzr.iss.cog
iscc /Q tools/win32/bzr.iss
# win32 python's distutils-based installer
# require to have python interpreter installed on win32
python-installer: docs
python setup.py bdist_wininst --install-script="bzr-win32-bdist-postinstall.py" -d .
# clean on win32 all installer-related files and directories
clean-win32:
python tools/win32/ostools.py remove build
python tools/win32/ostools.py remove win32_bzr.exe
python tools/win32/ostools.py remove py2exe.log
python tools/win32/ostools.py remove doc/*.htm
python tools/win32/ostools.py remove doc/bzr_man.txt
python tools/win32/ostools.py remove tools/win32/bzr.iss
python tools/win32/ostools.py remove bzr-setup*.exe
python tools/win32/ostools.py remove bzr-*win32.exe
python tools/win32/ostools.py remove dist
|