← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to tools/doc_generate/autodoc_man.py

Fix test_upgrade defects related to non local or absent working trees.

Show diffs side-by-side

added added

removed removed

Lines of Context:
tools/doc_generate/autodoc_man.py
1
 
# Copyright (C) 2005-2010 Canonical Ltd
 
1
# Copyright 2005 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
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
 
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
16
 
17
17
"""man.py - create man page from built-in bzr help and static text
18
18
 
28
28
 
29
29
import bzrlib
30
30
import bzrlib.help
31
 
import bzrlib.help_topics
32
31
import bzrlib.commands
33
32
 
34
33
 
81
80
        cmd_help = cmd_object.help()
82
81
        if cmd_help:
83
82
            firstline = cmd_help.split('\n', 1)[0]
84
 
            usage = cmd_object._usage()
 
83
            usage = bzrlib.help.command_usage(cmd_object)
85
84
            tmp = '.TP\n.B "%s"\n%s\n' % (usage, firstline)
86
85
            output = output + tmp
87
86
        else:
92
91
def getcommand_help(params):
93
92
    """Shows individual options for a bzr command"""
94
93
    output='.SH "COMMAND REFERENCE"\n'
95
 
    formatted = {}
96
94
    for cmd_name in command_name_list():
97
95
        cmd_object = bzrlib.commands.get_cmd_object(cmd_name)
98
96
        if cmd_object.hidden:
99
97
            continue
100
 
        formatted[cmd_name] = format_command(params, cmd_object)
101
 
        for alias in cmd_object.aliases:
102
 
            formatted[alias] = format_alias(params, alias, cmd_name)
103
 
    for cmd_name in sorted(formatted):
104
 
        output += formatted[cmd_name]
 
98
        output = output + format_command(params, cmd_object)
105
99
    return output
106
100
 
107
101
 
108
102
def format_command (params, cmd):
109
103
    """Provides long help for each public command"""
110
 
    subsection_header = '.SS "%s"\n' % (cmd._usage())
 
104
    subsection_header = '.SS "%s"\n' % (bzrlib.help.command_usage(cmd))
111
105
    doc = "%s\n" % (cmd.__doc__)
112
 
    doc = bzrlib.help_topics.help_as_plain_text(cmd.help())
 
106
    doc = cmd.help()
113
107
 
114
108
    option_str = ""
115
109
    options = cmd.options()
117
111
        option_str = "\nOptions:\n"
118
112
        for option_name, option in sorted(options.items()):
119
113
            for name, short_name, argname, help in option.iter_switches():
120
 
                if option.is_hidden(name):
121
 
                    continue
122
114
                l = '    --' + name
123
115
                if argname is not None:
124
116
                    l += ' ' + argname
125
117
                if short_name:
 
118
                    assert len(short_name) == 1
126
119
                    l += ', -' + short_name
127
 
                l += (30 - len(l)) * ' ' + (help or '')
 
120
                l += (30 - len(l)) * ' ' + help
 
121
                # TODO: Split help over multiple lines with
 
122
                # correct indenting and wrapping.
128
123
                wrapped = textwrap.fill(l, initial_indent='',
129
 
                    subsequent_indent=30*' ',
130
 
                    break_long_words=False,
131
 
                    )
 
124
                                        subsequent_indent=30*' ')
132
125
                option_str = option_str + wrapped + '\n'       
133
126
 
134
127
    aliases_str = ""
140
133
        aliases_str += ', '.join(cmd.aliases)
141
134
        aliases_str += '\n'
142
135
 
143
 
    see_also_str = ""
144
 
    see_also = cmd.get_see_also()
145
 
    if see_also:
146
 
        see_also_str += '\nSee also: '
147
 
        see_also_str += ', '.join(see_also)
148
 
        see_also_str += '\n'
149
 
 
150
 
    return subsection_header + option_str + aliases_str + see_also_str + "\n" + doc + "\n"
151
 
 
152
 
 
153
 
def format_alias(params, alias, cmd_name):
154
 
    help = '.SS "bzr %s"\n' % alias
155
 
    help += 'Alias for "%s", see "bzr %s".\n' % (cmd_name, cmd_name)
156
 
    return help
 
136
    return subsection_header + option_str + aliases_str + "\n" + doc + "\n"
157
137
 
158
138
 
159
139
man_preamble = """\
160
 
.\\\"Man page for Bazaar (%(bzrcmd)s)
 
140
Man page for Bazaar (%(bzrcmd)s)
161
141
.\\\"
162
142
.\\\" Large parts of this file are autogenerated from the output of
163
143
.\\\"     \"%(bzrcmd)s help commands\"
171
151
man_head = """\
172
152
.TH bzr 1 "%(datestamp)s" "%(version)s" "Bazaar"
173
153
.SH "NAME"
174
 
%(bzrcmd)s - Bazaar next-generation distributed version control
 
154
Bazaar (%(bzrcmd)s) - next-generation distributed version control
175
155
.SH "SYNOPSIS"
176
156
.B "%(bzrcmd)s"
177
157
.I "command"
186
166
.B "help"
187
167
.I "command"
188
168
.SH "DESCRIPTION"
189
 
 
190
 
Bazaar (or %(bzrcmd)s) is a distributed version control system that is powerful, 
191
 
friendly, and scalable.  Bazaar is a project of Canonical Ltd and part of 
192
 
the GNU Project to develop a free operating system.
193
 
 
194
 
Bazaar keeps track of changes to software source code (or similar information);
195
 
lets you explore who changed it, when, and why; merges concurrent changes; and
196
 
helps people work together in a team.
 
169
Bazaar (or %(bzrcmd)s) is a project of Canonical to develop an open source
 
170
distributed version control system that is powerful, friendly, and scalable.
 
171
Version control means a system that keeps track of previous revisions
 
172
of software source code or similar information and helps people work on it in teams.
197
173
"""
198
174
 
199
175
man_foot = """\
202
178
.I "BZRPATH"
203
179
Path where
204
180
.B "%(bzrcmd)s"
205
 
is to look for shell plugin external commands.
 
181
is to look for external command.
206
182
.TP
207
183
.I "BZR_EMAIL"
208
184
E-Mail address of the user. Overrides default user config.
224
200
.SH "FILES"
225
201
.TP
226
202
.I "~/.bazaar/bazaar.conf"
227
 
Contains the user's default configuration. The section
 
203
Contains the users default configuration. The section
228
204
.B [DEFAULT]
229
205
is used to define general configuration that will be applied everywhere.
230
206
The section
245
221
.br
246
222
log10 = log --short -r -10..-1
247
223
.SH "SEE ALSO"
248
 
.UR http://bazaar.canonical.com/
249
 
.BR http://bazaar.canonical.com/
 
224
.UR http://www.bazaar-vcs.org/
 
225
.BR http://www.bazaar-vcs.org/
250
226
"""
251
227