/brz/remove-bazaar

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 breezy/doc_generate/autodoc_rstx.py

  • Committer: Jelmer Vernooij
  • Date: 2018-07-08 14:45:27 UTC
  • mto: This revision was merged to the branch mainline in revision 7036.
  • Revision ID: jelmer@jelmer.uk-20180708144527-codhlvdcdg9y0nji
Fix a bunch of merge tests.

Show diffs side-by-side

added added

removed removed

Lines of Context:
breezy/doc_generate/autodoc_rstx.py
20
20
Written by the Bazaar community.
21
21
"""
22
22
 
23
 
import os
24
 
import sys
 
23
from __future__ import absolute_import
 
24
 
25
25
import time
26
26
 
27
 
import bzrlib
28
 
import bzrlib.help
29
 
import bzrlib.help_topics
30
 
import bzrlib.commands
31
 
import bzrlib.osutils
 
27
import breezy
 
28
import breezy.help
 
29
import breezy.help_topics
 
30
import breezy.commands
 
31
import breezy.osutils
32
32
 
33
33
 
34
34
def get_filename(options):
35
35
    """Provides name of manual"""
36
 
    return "%s_man.txt" % (options.bzr_name)
 
36
    return "%s_man.txt" % (options.brz_name)
37
37
 
38
38
 
39
39
def infogen(options, outfile):
41
41
    t = time.time()
42
42
    tt = time.gmtime(t)
43
43
    params = \
44
 
           { "bzrcmd": options.bzr_name,
45
 
             "datestamp": time.strftime("%Y-%m-%d",tt),
46
 
             "timestamp": time.strftime("%Y-%m-%d %H:%M:%S +0000",tt),
47
 
             "version": bzrlib.__version__,
 
44
           { "brzcmd": options.brz_name,
 
45
             "datestamp": time.strftime("%Y-%m-%d", tt),
 
46
             "timestamp": time.strftime("%Y-%m-%d %H:%M:%S +0000", tt),
 
47
             "version": breezy.__version__,
48
48
             }
49
49
    nominated_filename = getattr(options, 'filename', None)
50
50
    if nominated_filename is None:
51
51
        topic_dir = None
52
52
    else:
53
 
        topic_dir = bzrlib.osutils.dirname(nominated_filename)
 
53
        topic_dir = breezy.osutils.dirname(nominated_filename)
54
54
    outfile.write(rstx_preamble % params)
55
55
    outfile.write(rstx_head % params)
56
56
    outfile.write(_get_body(params, topic_dir))
59
59
 
60
60
def _get_body(params, topic_dir):
61
61
    """Build the manual content."""
62
 
    from bzrlib.help_topics import SECT_CONCEPT, SECT_LIST, SECT_PLUGIN
63
 
    registry = bzrlib.help_topics.topic_registry
 
62
    from breezy.help_topics import SECT_CONCEPT, SECT_LIST, SECT_PLUGIN
 
63
    registry = breezy.help_topics.topic_registry
64
64
    result = []
65
65
    result.append(_get_section(registry, SECT_CONCEPT, "Concepts",
66
66
        output_dir=topic_dir))
108
108
    if file_per_topic:
109
109
        lines.extend([".. toctree::", "   :maxdepth: 1", ""])
110
110
 
111
 
    cmds = sorted(bzrlib.commands.builtin_command_names())
 
111
    cmds = sorted(breezy.commands.builtin_command_names())
112
112
    for cmd_name in cmds:
113
 
        cmd_object = bzrlib.commands.get_cmd_object(cmd_name)
 
113
        cmd_object = breezy.commands.get_cmd_object(cmd_name)
114
114
        if cmd_object.hidden:
115
115
            continue
116
116
        heading = cmd_name
129
129
def _dump_text(output_dir, topic, text):
130
130
    """Dump text for a topic to a file."""
131
131
    topic_id = "%s-%s" % (topic, "help")
132
 
    filename = bzrlib.osutils.pathjoin(output_dir, topic_id + ".txt")
133
 
    f =  open(filename, "w")
134
 
    f.writelines(text)
135
 
    f.close()
 
132
    filename = breezy.osutils.pathjoin(output_dir, topic_id + ".txt")
 
133
    with open(filename, "w") as f:
 
134
        f.write(text.encode('utf-8'))
136
135
    return topic_id
137
136
 
138
137
 
140
139
# TEMPLATES
141
140
 
142
141
rstx_preamble = """.. This file is autogenerated from the output of
143
 
..     %(bzrcmd)s help topics
144
 
..     %(bzrcmd)s help commands
145
 
..     %(bzrcmd)s help <cmd>
 
142
..     %(brzcmd)s help topics
 
143
..     %(brzcmd)s help commands
 
144
..     %(brzcmd)s help <cmd>
146
145
..
147
 
.. Generation time: %(timestamp)s
148
146
 
149
147
"""
150
148
 
162
160
 
163
161
    Introduction including a list of commonly used commands::
164
162
 
165
 
        bzr help
 
163
        brz help
166
164
 
167
165
    List of topics and a summary of each::
168
166
 
169
 
        bzr help topics
 
167
        brz help topics
170
168
 
171
169
    List of commands and a summary of each::
172
170
 
173
 
        bzr help commands
 
171
        brz help commands
174
172
 
175
173
    More information about a particular topic or command::
176
174
 
177
 
        bzr help topic-or-command-name
 
175
        brz help topic-or-command-name
178
176
 
179
177
The following web sites provide further information on Bazaar:
180
178
 
181
 
:Home page:                     http://bazaar.canonical.com/
182
 
:Official docs:                 http://doc.bazaar.canonical.com/
183
 
:Launchpad:                     https://launchpad.net/bzr/
 
179
:Home page:                     http://www.breezy-vcs.org/
 
180
:Bazaar docs:                   http://doc.bazaar.canonical.com/
 
181
:Launchpad:                     https://launchpad.net/brz/
184
182
"""
185
183
 
186
184