48
49
outfile.write(rstx_preamble % params)
49
50
outfile.write(rstx_head % params)
50
outfile.write(getcommand_list(params))
51
outfile.write(getcommand_help(params))
51
outfile.write(_get_body(params))
52
52
outfile.write(rstx_foot % params)
55
def command_name_list():
56
"""Builds a list of command names from bzrlib"""
57
command_names = bzrlib.commands.builtin_command_names()
62
def getcommand_list (params):
63
"""Builds summary help for command names in RSTX format"""
64
bzrcmd = params["bzrcmd"]
69
for cmd_name in command_name_list():
70
cmd_object = bzrlib.commands.get_cmd_object(cmd_name)
73
cmd_help = cmd_object.help()
75
firstline = cmd_help.split('\n', 1)[0]
76
usage = cmd_object._usage()
77
tmp = '**%s**\n\t%s\n\n' % (usage, firstline)
80
raise RuntimeError, "Command '%s' has no help text" % (cmd_name)
84
def getcommand_help(params):
85
"""Shows individual options for a bzr command"""
90
for cmd_name in command_name_list():
91
cmd_object = bzrlib.commands.get_cmd_object(cmd_name)
94
output = output + format_command(params, cmd_object, cmd_name)
98
def format_command (params, cmd, name):
99
"""Provides long help for each public command"""
101
subsection_header = """
105
""" % (usage, '-'*len(usage))
107
docsplit = cmd.help().split('\n')
108
doc = '\n'.join([' '*4+line for line in docsplit])
111
options = cmd.options()
113
option_str = "\n Options:\n"
114
for option_name, option in sorted(options.items()):
115
for name, short_name, argname, help in option.iter_switches():
117
if argname is not None:
120
assert len(short_name) == 1
121
l += ', -' + short_name
122
l += (30 - len(l)) * ' ' + (help or '')
123
# TODO: Split help over multiple lines with
124
# correct indenting and wrapping.
125
wrapped = textwrap.fill(l, initial_indent='',
126
subsequent_indent=30*' ')
127
option_str = option_str + wrapped + '\n'
131
if len(cmd.aliases) > 1:
132
aliases_str += '\n Aliases: '
134
aliases_str += '\n Alias: '
135
aliases_str += ', '.join(cmd.aliases)
139
see_also = cmd.get_see_also()
141
see_also_str += '\n See also: '
142
see_also_str += ', '.join(see_also)
145
return subsection_header + option_str + aliases_str + see_also_str + "\n" + doc + "\n"
55
def _get_body(params):
56
"""Build the manual content."""
57
from bzrlib.help_topics import SECT_CONCEPT, SECT_LIST, SECT_PLUGIN
58
registry = bzrlib.help_topics.topic_registry
60
result.append(_get_section(registry, SECT_CONCEPT, "Concepts"))
61
result.append(_get_section(registry, SECT_LIST, "Lists"))
62
result.append(_get_commands_section(registry))
63
#result.append(_get_section(registry, SECT_PLUGIN, "Core Plug-ins"))
64
return "\n".join(result)
67
def _get_section(registry, section, title, hdg_level1="=", hdg_level2="-"):
68
"""Build the manual part from topics matching that section."""
69
topics = sorted(registry.get_topics_for_section(section))
70
lines = [title, hdg_level1 * len(title), ""]
72
help = registry.get_detail(topic)
73
heading,text = help.split("\n", 1)
75
lines.append(hdg_level2 * len(heading))
78
return "\n" + "\n".join(lines) + "\n"
81
def _get_commands_section(registry, title="Commands", hdg_level1="=",
83
"""Build the comands reference section of the manual."""
84
lines = [title, hdg_level1 * len(title), ""]
85
cmds = sorted(bzrlib.commands.builtin_command_names())
87
cmd_object = bzrlib.commands.get_cmd_object(cmd_name)
91
text = cmd_object.get_help_text(plain=False)
93
lines.append(hdg_level2 * len(heading))
96
return "\n" + "\n".join(lines) + "\n"
151
rstx_preamble = """.. Large parts of this file are autogenerated from the output of
102
rstx_preamble = """.. This file is autogenerated from the output of
103
.. %(bzrcmd)s help topics
152
104
.. %(bzrcmd)s help commands
153
105
.. %(bzrcmd)s help <cmd>
155
107
.. Generation time: %(timestamp)s
157
=============================================
158
Man page for Bazaar (%(bzrcmd)s)
159
=============================================
113
=====================
114
Bazaar User Reference
115
=====================
117
:Version: %(version)s
118
:Generated: %(datestamp)s
173
Bazaar (%(bzrcmd)s) - next-generation distributed version control
177
**%(bzrcmd)s** *command* [ *command_options* ]
181
**%(bzrcmd)s help** *command*
186
Bazaar (or **%(bzrcmd)s**) is a project of Canonical to develop
187
an open source distributed version control system that is powerful,
188
friendly, and scalable. Version control means a system
189
that keeps track of previous revisions of software source code
190
or similar information and helps people work on it in teams.
127
This manual is generated from Bazaar's online help. To use
128
the online help system, try the following commands.
130
Introduction including a list of commonly used commands::
134
List of topics and a summary of each::
138
List of commands and a summary of each::
142
More information about a particular topic or command::
144
bzr help topic-or-command-name
146
The following web sites provide further information on Bazaar:
148
:Home page: http://www.bazaar-vcs.org/
149
:Official docs: http://doc.bazaar-vcs.org/
150
:Launchpad: https://launchpad.net/bzr/
198
Path where **%(bzrcmd)s** is to look for shell plugin external commands.
201
E-Mail address of the user. Overrides default user config.
204
E-Mail address of the user. Overrides default user config.
207
Editor for editing commit messages
210
Editor for editing commit messages
213
Paths where bzr should look for plugins
216
Home directory for bzr
222
**On Linux**: ``~/.bazaar/bazaar.conf``
224
**On Windows**: ``C:\\Documents and Settings\\username\\Application Data\\bazaar\\2.0\\bazaar.conf``
226
Contains the user's default configuration. The section ``[DEFAULT]`` is
227
used to define general configuration that will be applied everywhere.
228
The section ``[ALIASES]`` can be used to create command aliases for
229
commonly used options.
231
A typical config file might look something like::
234
email=John Doe <jdoe@isp.com>
237
commit = commit --strict
238
log10 = log --short -r -10..-1
243
http://www.bazaar-vcs.org/
added
removed
tools/doc_generate/autodoc_rstx.py
