Mercurial > hg
annotate doc/hgmanpage.py @ 48793:6e559391f96e
tracked-key: remove the dual write and rename to tracked-hint
The dual-write approach was mostly useless. As explained in the previous version
of the help, the key had to be read twice before we could cache a value.
However this "read twice" limitation actually also apply to any usage of the
key. If some operation wants to rely of the "same value == same tracked set"
property it would need to read the value before, and after running that
operation (or at least, after, in all cases). So it cannot be sure the operation
it did is "valid" until checking the key after the operation. As a resultat such
operation can only be read-only or rollbackable.
This reduce the utility of the "same value == same tracked set" a lot.
So it seems simpler to drop the double write and to update the documentation to
highlight that this file does not garantee race-free operation. As a result the
"key" is demoted to a "hint".
Documentation is updated accordingly.
Differential Revision: https://phab.mercurial-scm.org/D12201
author | Pierre-Yves David <pierre-yves.david@octobus.net> |
---|---|
date | Thu, 17 Feb 2022 07:34:49 +0100 |
parents | db952cb40f18 |
children | 6000f5b25c9b |
rev | line source |
---|---|
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1 # -*- coding: utf-8 -*- |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
2 # $Id: manpage.py 6110 2009-08-31 14:40:33Z grubert $ |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
3 # Author: Engelbert Gruber <grubert@users.sourceforge.net> |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
4 # Copyright: This module is put into the public domain. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
5 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
6 """ |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
7 Simple man page writer for reStructuredText. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
8 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
9 Man pages (short for "manual pages") contain system documentation on unix-like |
9712
18b134ef294c
kill trailing whitespace
Dirkjan Ochtman <dirkjan@ochtman.nl>
parents:
9628
diff
changeset
|
10 systems. The pages are grouped in numbered sections: |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
11 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
12 1 executable programs and shell commands |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
13 2 system calls |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
14 3 library functions |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
15 4 special files |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
16 5 file formats |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
17 6 games |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
18 7 miscellaneous |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
19 8 system administration |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
20 |
26193 | 21 Man pages are written in *troff*, a text file formatting system. |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
22 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
23 See http://www.tldp.org/HOWTO/Man-Page for a start. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
24 |
26193 | 25 Man pages have no subsections only parts. |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
26 Standard parts |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
27 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
28 NAME , |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
29 SYNOPSIS , |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
30 DESCRIPTION , |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
31 OPTIONS , |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
32 FILES , |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
33 SEE ALSO , |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
34 BUGS , |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
35 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
36 and |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
37 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
38 AUTHOR . |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
39 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
40 A unix-like system keeps an index of the DESCRIPTIONs, which is accesable |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
41 by the command whatis or apropos. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
42 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
43 """ |
28967
cd5e7195e441
py3: make hgmanpage use absolute_import
Pulkit Goyal <7895pulkit@gmail.com>
parents:
26781
diff
changeset
|
44 from __future__ import absolute_import |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
45 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
46 __docformat__ = 'reStructuredText' |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
47 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
48 import re |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
49 |
28967
cd5e7195e441
py3: make hgmanpage use absolute_import
Pulkit Goyal <7895pulkit@gmail.com>
parents:
26781
diff
changeset
|
50 from docutils import ( |
cd5e7195e441
py3: make hgmanpage use absolute_import
Pulkit Goyal <7895pulkit@gmail.com>
parents:
26781
diff
changeset
|
51 languages, |
cd5e7195e441
py3: make hgmanpage use absolute_import
Pulkit Goyal <7895pulkit@gmail.com>
parents:
26781
diff
changeset
|
52 nodes, |
cd5e7195e441
py3: make hgmanpage use absolute_import
Pulkit Goyal <7895pulkit@gmail.com>
parents:
26781
diff
changeset
|
53 writers, |
cd5e7195e441
py3: make hgmanpage use absolute_import
Pulkit Goyal <7895pulkit@gmail.com>
parents:
26781
diff
changeset
|
54 ) |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
55 |
16611
462dd183bd73
build: fix hgrc manpage building with docutils 0.9
Nikolaj Sjujskij <sterkrig@myopera.com>
parents:
14764
diff
changeset
|
56 try: |
462dd183bd73
build: fix hgrc manpage building with docutils 0.9
Nikolaj Sjujskij <sterkrig@myopera.com>
parents:
14764
diff
changeset
|
57 import roman |
462dd183bd73
build: fix hgrc manpage building with docutils 0.9
Nikolaj Sjujskij <sterkrig@myopera.com>
parents:
14764
diff
changeset
|
58 except ImportError: |
462dd183bd73
build: fix hgrc manpage building with docutils 0.9
Nikolaj Sjujskij <sterkrig@myopera.com>
parents:
14764
diff
changeset
|
59 from docutils.utils import roman |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
60 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
61 FIELD_LIST_INDENT = 7 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
62 DEFINITION_LIST_INDENT = 7 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
63 OPTION_LIST_INDENT = 7 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
64 BLOCKQOUTE_INDENT = 3.5 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
65 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
66 # Define two macros so man/roff can calculate the |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
67 # indent/unindent margins by itself |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
68 MACRO_DEF = r""". |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
69 .nr rst2man-indent-level 0 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
70 . |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
71 .de1 rstReportMargin |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
72 \\$1 \\n[an-margin] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
73 level \\n[rst2man-indent-level] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
74 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
75 - |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
76 \\n[rst2man-indent0] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
77 \\n[rst2man-indent1] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
78 \\n[rst2man-indent2] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
79 .. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
80 .de1 INDENT |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
81 .\" .rstReportMargin pre: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
82 . RS \\$1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
83 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
84 . nr rst2man-indent-level +1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
85 .\" .rstReportMargin post: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
86 .. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
87 .de UNINDENT |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
88 . RE |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
89 .\" indent \\n[an-margin] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
90 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
91 .nr rst2man-indent-level -1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
92 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
93 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
94 .. |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
95 """ |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
96 |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
97 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
98 class Writer(writers.Writer): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
99 |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
100 supported = 'manpage' |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
101 """Formats this writer supports.""" |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
102 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
103 output = None |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
104 """Final translated form of `document`.""" |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
105 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
106 def __init__(self): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
107 writers.Writer.__init__(self) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
108 self.translator_class = Translator |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
109 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
110 def translate(self): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
111 visitor = self.translator_class(self.document) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
112 self.document.walkabout(visitor) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
113 self.output = visitor.astext() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
114 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
115 |
14764
a7d5816087a9
classes: fix class style problems found by b071cd58af50
Thomas Arendsen Hein <thomas@intevation.de>
parents:
14633
diff
changeset
|
116 class Table(object): |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
117 def __init__(self): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
118 self._rows = [] |
10413
e433002acb05
fix up a bunch of check-code warnings
Matt Mackall <mpm@selenic.com>
parents:
10282
diff
changeset
|
119 self._options = ['center'] |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
120 self._tab_char = '\t' |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
121 self._coldefs = [] |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
122 |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
123 def new_row(self): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
124 self._rows.append([]) |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
125 |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
126 def append_separator(self, separator): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
127 """Append the separator for table head.""" |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
128 self._rows.append([separator]) |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
129 |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
130 def append_cell(self, cell_lines): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
131 """cell_lines is an array of lines""" |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
132 start = 0 |
10282
08a0f04b56bd
many, many trivial check-code fixups
Matt Mackall <mpm@selenic.com>
parents:
10007
diff
changeset
|
133 if len(cell_lines) > 0 and cell_lines[0] == '.sp\n': |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
134 start = 1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
135 self._rows[-1].append(cell_lines[start:]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
136 if len(self._coldefs) < len(self._rows[-1]): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
137 self._coldefs.append('l') |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
138 |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
139 def _minimize_cell(self, cell_lines): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
140 """Remove leading and trailing blank and ``.sp`` lines""" |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
141 while cell_lines and cell_lines[0] in ('\n', '.sp\n'): |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
142 del cell_lines[0] |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
143 while cell_lines and cell_lines[-1] in ('\n', '.sp\n'): |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
144 del cell_lines[-1] |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
145 |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
146 def as_list(self): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
147 text = ['.TS\n'] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
148 text.append(' '.join(self._options) + ';\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
149 text.append('|%s|.\n' % ('|'.join(self._coldefs))) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
150 for row in self._rows: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
151 # row = array of cells. cell = array of lines. |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
152 text.append('_\n') # line above |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
153 text.append('T{\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
154 for i in range(len(row)): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
155 cell = row[i] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
156 self._minimize_cell(cell) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
157 text.extend(cell) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
158 if not text[-1].endswith('\n'): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
159 text[-1] += '\n' |
18054
b35e3364f94a
check-code: there must also be whitespace between ')' and operator
Mads Kiilerich <madski@unity3d.com>
parents:
17517
diff
changeset
|
160 if i < len(row) - 1: |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
161 text.append('T}' + self._tab_char + 'T{\n') |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
162 else: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
163 text.append('T}\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
164 text.append('_\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
165 text.append('.TE\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
166 return text |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
167 |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
168 |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
169 class Translator(nodes.NodeVisitor): |
47062
f38bf44e077f
black: make codebase compatible with black v21.4b2 and v20.8b1
Kyle Lippincott <spectral@google.com>
parents:
45942
diff
changeset
|
170 """ """ |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
171 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
172 words_and_spaces = re.compile(r'\S+| +|\n') |
17517 | 173 document_start = """Man page generated from reStructuredText.""" |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
174 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
175 def __init__(self, document): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
176 nodes.NodeVisitor.__init__(self, document) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
177 self.settings = settings = document.settings |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
178 lcode = settings.language_code |
48720
db952cb40f18
doc: inspect.getargspec has been removed in Python 3.11
Mads Kiilerich <mads@kiilerich.com>
parents:
47062
diff
changeset
|
179 self.language = languages.get_language(lcode, self.document.reporter) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
180 self.head = [] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
181 self.body = [] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
182 self.foot = [] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
183 self.section_level = 0 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
184 self.context = [] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
185 self.topic_class = '' |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
186 self.colspecs = [] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
187 self.compact_p = 1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
188 self.compact_simple = None |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
189 # the list style "*" bullet or "#" numbered |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
190 self._list_char = [] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
191 # writing the header .TH and .SH NAME is postboned after |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
192 # docinfo. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
193 self._docinfo = { |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
194 "title": "", |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
195 "title_upper": "", |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
196 "subtitle": "", |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
197 "manual_section": "", |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
198 "manual_group": "", |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
199 "author": [], |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
200 "date": "", |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
201 "copyright": "", |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
202 "version": "", |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
203 } |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
204 self._docinfo_keys = [] # a list to keep the sequence as in source. |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
205 self._docinfo_names = {} # to get name from text not normalized. |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
206 self._in_docinfo = None |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
207 self._active_table = None |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
208 self._in_literal = False |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
209 self.header_written = 0 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
210 self._line_block = 0 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
211 self.authors = [] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
212 self.section_level = 0 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
213 self._indent = [0] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
214 # central definition of simple processing rules |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
215 # what to output on : visit, depart |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
216 # Do not use paragraph requests ``.PP`` because these set indentation. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
217 # use ``.sp``. Remove superfluous ``.sp`` in ``astext``. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
218 # |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
219 # Fonts are put on a stack, the top one is used. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
220 # ``.ft P`` or ``\\fP`` pop from stack. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
221 # ``B`` bold, ``I`` italic, ``R`` roman should be available. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
222 # Hopefully ``C`` courier too. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
223 self.defs = { |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
224 'indent': ('.INDENT %.1f\n', '.UNINDENT\n'), |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
225 'definition_list_item': ('.TP', ''), |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
226 'field_name': ('.TP\n.B ', '\n'), |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
227 'literal': ('\\fB', '\\fP'), |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
228 'literal_block': ('.sp\n.nf\n.ft C\n', '\n.ft P\n.fi\n'), |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
229 'option_list_item': ('.TP\n', ''), |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
230 'reference': (r'\%', r'\:'), |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
231 'emphasis': ('\\fI', '\\fP'), |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
232 'strong': ('\\fB', '\\fP'), |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
233 'term': ('\n.B ', '\n'), |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
234 'title_reference': ('\\fI', '\\fP'), |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
235 'topic-title': ('.SS ',), |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
236 'sidebar-title': ('.SS ',), |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
237 'problematic': ('\n.nf\n', '\n.fi\n'), |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
238 } |
10007
9945a39d171f
rst2man: s/dont/don't/ in comment
Christian Ebert <blacktrash@gmx.net>
parents:
10006
diff
changeset
|
239 # NOTE don't specify the newline before a dot-command, but ensure |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
240 # it is there. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
241 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
242 def comment_begin(self, text): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
243 """Return commented version of the passed text WITHOUT end of |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
244 line/comment.""" |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
245 prefix = '.\\" ' |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
246 out_text = ''.join( |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
247 [(prefix + in_line + '\n') for in_line in text.split('\n')] |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
248 ) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
249 return out_text |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
250 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
251 def comment(self, text): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
252 """Return commented version of the passed text.""" |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
253 return self.comment_begin(text) + '.\n' |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
254 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
255 def ensure_eol(self): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
256 """Ensure the last line in body is terminated by new line.""" |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
257 if self.body[-1][-1] != '\n': |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
258 self.body.append('\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
259 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
260 def astext(self): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
261 """Return the final formatted document as a string.""" |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
262 if not self.header_written: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
263 # ensure we get a ".TH" as viewers require it. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
264 self.head.append(self.header()) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
265 # filter body |
42059
51df72655b1a
hgmanpage: use range instead of xrange
Philippe Pepiot <philippe.pepiot@logilab.fr>
parents:
41553
diff
changeset
|
266 for i in range(len(self.body) - 1, 0, -1): |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
267 # remove superfluous vertical gaps. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
268 if self.body[i] == '.sp\n': |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
269 if self.body[i - 1][:4] in ('.BI ', '.IP '): |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
270 self.body[i] = '.\n' |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
271 elif ( |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
272 self.body[i - 1][:3] == '.B ' |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
273 and self.body[i - 2][:4] == '.TP\n' |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
274 ): |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
275 self.body[i] = '.\n' |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
276 elif ( |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
277 self.body[i - 1] == '\n' |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
278 and self.body[i - 2][0] != '.' |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
279 and ( |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
280 self.body[i - 3][:7] == '.TP\n.B ' |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
281 or self.body[i - 3][:4] == '\n.B ' |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
282 ) |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
283 ): |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
284 self.body[i] = '.\n' |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
285 return ''.join(self.head + self.body + self.foot) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
286 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
287 def deunicode(self, text): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
288 text = text.replace(u'\xa0', '\\ ') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
289 text = text.replace(u'\u2020', '\\(dg') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
290 return text |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
291 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
292 def visit_Text(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
293 text = node.astext() |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
294 text = text.replace('\\', '\\e') |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
295 replace_pairs = [ |
30057
a8ba9a23c893
hgmanpage: stop using raw-unicode strings
Augie Fackler <augie@google.com>
parents:
29661
diff
changeset
|
296 (u'-', u'\\-'), |
a8ba9a23c893
hgmanpage: stop using raw-unicode strings
Augie Fackler <augie@google.com>
parents:
29661
diff
changeset
|
297 (u"'", u'\\(aq'), |
a8ba9a23c893
hgmanpage: stop using raw-unicode strings
Augie Fackler <augie@google.com>
parents:
29661
diff
changeset
|
298 (u'´', u"\\'"), |
a8ba9a23c893
hgmanpage: stop using raw-unicode strings
Augie Fackler <augie@google.com>
parents:
29661
diff
changeset
|
299 (u'`', u'\\(ga'), |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
300 ] |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
301 for (in_char, out_markup) in replace_pairs: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
302 text = text.replace(in_char, out_markup) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
303 # unicode |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
304 text = self.deunicode(text) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
305 if self._in_literal: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
306 # prevent interpretation of "." at line start |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
307 if text[0] == '.': |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
308 text = '\\&' + text |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
309 text = text.replace('\n.', '\n\\&.') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
310 self.body.append(text) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
311 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
312 def depart_Text(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
313 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
314 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
315 def list_start(self, node): |
14764
a7d5816087a9
classes: fix class style problems found by b071cd58af50
Thomas Arendsen Hein <thomas@intevation.de>
parents:
14633
diff
changeset
|
316 class enum_char(object): |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
317 enum_style = { |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
318 'bullet': '\\(bu', |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
319 'emdash': '\\(em', |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
320 } |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
321 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
322 def __init__(self, style): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
323 self._style = style |
11643
50fede14fe4d
doc: remove has_key usage in hgmanpage
Nicolas Dumazet <nicdumz.commits@gmail.com>
parents:
11639
diff
changeset
|
324 if 'start' in node: |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
325 self._cnt = node['start'] - 1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
326 else: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
327 self._cnt = 0 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
328 self._indent = 2 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
329 if style == 'arabic': |
26193 | 330 # indentation depends on number of children |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
331 # and start value. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
332 self._indent = len(str(len(node.children))) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
333 self._indent += len(str(self._cnt)) + 1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
334 elif style == 'loweralpha': |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
335 self._cnt += ord('a') - 1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
336 self._indent = 3 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
337 elif style == 'upperalpha': |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
338 self._cnt += ord('A') - 1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
339 self._indent = 3 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
340 elif style.endswith('roman'): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
341 self._indent = 5 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
342 |
42060
93a1a4fef532
hgmanpage: use a py2 and py3 compatible iterable protocol
Philippe Pepiot <philippe.pepiot@logilab.fr>
parents:
42059
diff
changeset
|
343 def __next__(self): |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
344 if self._style == 'bullet': |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
345 return self.enum_style[self._style] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
346 elif self._style == 'emdash': |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
347 return self.enum_style[self._style] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
348 self._cnt += 1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
349 # TODO add prefix postfix |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
350 if self._style == 'arabic': |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
351 return "%d." % self._cnt |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
352 elif self._style in ('loweralpha', 'upperalpha'): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
353 return "%c." % self._cnt |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
354 elif self._style.endswith('roman'): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
355 res = roman.toRoman(self._cnt) + '.' |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
356 if self._style.startswith('upper'): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
357 return res.upper() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
358 return res.lower() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
359 else: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
360 return "%d." % self._cnt |
42060
93a1a4fef532
hgmanpage: use a py2 and py3 compatible iterable protocol
Philippe Pepiot <philippe.pepiot@logilab.fr>
parents:
42059
diff
changeset
|
361 |
93a1a4fef532
hgmanpage: use a py2 and py3 compatible iterable protocol
Philippe Pepiot <philippe.pepiot@logilab.fr>
parents:
42059
diff
changeset
|
362 next = __next__ |
93a1a4fef532
hgmanpage: use a py2 and py3 compatible iterable protocol
Philippe Pepiot <philippe.pepiot@logilab.fr>
parents:
42059
diff
changeset
|
363 |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
364 def get_width(self): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
365 return self._indent |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
366 |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
367 def __repr__(self): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
368 return 'enum_style-%s' % list(self._style) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
369 |
11643
50fede14fe4d
doc: remove has_key usage in hgmanpage
Nicolas Dumazet <nicdumz.commits@gmail.com>
parents:
11639
diff
changeset
|
370 if 'enumtype' in node: |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
371 self._list_char.append(enum_char(node['enumtype'])) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
372 else: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
373 self._list_char.append(enum_char('bullet')) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
374 if len(self._list_char) > 1: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
375 # indent nested lists |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
376 self.indent(self._list_char[-2].get_width()) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
377 else: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
378 self.indent(self._list_char[-1].get_width()) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
379 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
380 def list_end(self): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
381 self.dedent() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
382 self._list_char.pop() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
383 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
384 def header(self): |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
385 tmpl = ( |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
386 ".TH %(title_upper)s %(manual_section)s" |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
387 " \"%(date)s\" \"%(version)s\" \"%(manual_group)s\"\n" |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
388 ".SH NAME\n" |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
389 "%(title)s \\- %(subtitle)s\n" |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
390 ) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
391 return tmpl % self._docinfo |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
392 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
393 def append_header(self): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
394 """append header with .TH and .SH NAME""" |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
395 # NOTE before everything |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
396 # .TH title_upper section date source manual |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
397 if self.header_written: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
398 return |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
399 self.body.append(self.header()) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
400 self.body.append(MACRO_DEF) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
401 self.header_written = 1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
402 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
403 def visit_address(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
404 self.visit_docinfo_item(node, 'address') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
405 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
406 def depart_address(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
407 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
408 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
409 def visit_admonition(self, node, name=None): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
410 if name: |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
411 self.body.append('.IP %s\n' % self.language.labels.get(name, name)) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
412 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
413 def depart_admonition(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
414 self.body.append('.RE\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
415 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
416 def visit_attention(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
417 self.visit_admonition(node, 'attention') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
418 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
419 depart_attention = depart_admonition |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
420 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
421 def visit_docinfo_item(self, node, name): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
422 if name == 'author': |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
423 self._docinfo[name].append(node.astext()) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
424 else: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
425 self._docinfo[name] = node.astext() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
426 self._docinfo_keys.append(name) |
29158
7c0297bfe8bf
py3: make raise statement python3 compatible
Pulkit Goyal <7895pulkit@gmail.com>
parents:
28967
diff
changeset
|
427 raise nodes.SkipNode() |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
428 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
429 def depart_docinfo_item(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
430 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
431 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
432 def visit_author(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
433 self.visit_docinfo_item(node, 'author') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
434 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
435 depart_author = depart_docinfo_item |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
436 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
437 def visit_authors(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
438 # _author is called anyway. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
439 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
440 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
441 def depart_authors(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
442 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
443 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
444 def visit_block_quote(self, node): |
26781
1aee2ab0f902
spelling: trivial spell checking
Mads Kiilerich <madski@unity3d.com>
parents:
26193
diff
changeset
|
445 # BUG/HACK: indent always uses the _last_ indentation, |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
446 # thus we need two of them. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
447 self.indent(BLOCKQOUTE_INDENT) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
448 self.indent(0) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
449 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
450 def depart_block_quote(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
451 self.dedent() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
452 self.dedent() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
453 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
454 def visit_bullet_list(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
455 self.list_start(node) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
456 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
457 def depart_bullet_list(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
458 self.list_end() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
459 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
460 def visit_caption(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
461 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
462 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
463 def depart_caption(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
464 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
465 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
466 def visit_caution(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
467 self.visit_admonition(node, 'caution') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
468 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
469 depart_caution = depart_admonition |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
470 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
471 def visit_citation(self, node): |
10282
08a0f04b56bd
many, many trivial check-code fixups
Matt Mackall <mpm@selenic.com>
parents:
10007
diff
changeset
|
472 num, text = node.astext().split(None, 1) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
473 num = num.strip() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
474 self.body.append('.IP [%s] 5\n' % num) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
475 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
476 def depart_citation(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
477 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
478 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
479 def visit_citation_reference(self, node): |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
480 self.body.append('[' + node.astext() + ']') |
29158
7c0297bfe8bf
py3: make raise statement python3 compatible
Pulkit Goyal <7895pulkit@gmail.com>
parents:
28967
diff
changeset
|
481 raise nodes.SkipNode() |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
482 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
483 def visit_classifier(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
484 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
485 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
486 def depart_classifier(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
487 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
488 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
489 def visit_colspec(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
490 self.colspecs.append(node) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
491 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
492 def depart_colspec(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
493 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
494 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
495 def write_colspecs(self): |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
496 self.body.append("%s.\n" % ('L ' * len(self.colspecs))) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
497 |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
498 def visit_comment(self, node, sub=re.compile('-(?=-)').sub): |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
499 self.body.append(self.comment(node.astext())) |
29158
7c0297bfe8bf
py3: make raise statement python3 compatible
Pulkit Goyal <7895pulkit@gmail.com>
parents:
28967
diff
changeset
|
500 raise nodes.SkipNode() |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
501 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
502 def visit_contact(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
503 self.visit_docinfo_item(node, 'contact') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
504 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
505 depart_contact = depart_docinfo_item |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
506 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
507 def visit_container(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
508 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
509 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
510 def depart_container(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
511 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
512 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
513 def visit_compound(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
514 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
515 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
516 def depart_compound(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
517 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
518 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
519 def visit_copyright(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
520 self.visit_docinfo_item(node, 'copyright') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
521 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
522 def visit_danger(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
523 self.visit_admonition(node, 'danger') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
524 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
525 depart_danger = depart_admonition |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
526 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
527 def visit_date(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
528 self.visit_docinfo_item(node, 'date') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
529 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
530 def visit_decoration(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
531 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
532 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
533 def depart_decoration(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
534 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
535 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
536 def visit_definition(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
537 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
538 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
539 def depart_definition(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
540 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
541 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
542 def visit_definition_list(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
543 self.indent(DEFINITION_LIST_INDENT) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
544 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
545 def depart_definition_list(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
546 self.dedent() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
547 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
548 def visit_definition_list_item(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
549 self.body.append(self.defs['definition_list_item'][0]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
550 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
551 def depart_definition_list_item(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
552 self.body.append(self.defs['definition_list_item'][1]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
553 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
554 def visit_description(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
555 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
556 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
557 def depart_description(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
558 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
559 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
560 def visit_docinfo(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
561 self._in_docinfo = 1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
562 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
563 def depart_docinfo(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
564 self._in_docinfo = None |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
565 # NOTE nothing should be written before this |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
566 self.append_header() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
567 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
568 def visit_doctest_block(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
569 self.body.append(self.defs['literal_block'][0]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
570 self._in_literal = True |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
571 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
572 def depart_doctest_block(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
573 self._in_literal = False |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
574 self.body.append(self.defs['literal_block'][1]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
575 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
576 def visit_document(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
577 # no blank line between comment and header. |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
578 self.body.append(self.comment(self.document_start).rstrip() + '\n') |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
579 # writing header is postboned |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
580 self.header_written = 0 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
581 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
582 def depart_document(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
583 if self._docinfo['author']: |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
584 self.body.append( |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
585 '.SH AUTHOR\n%s\n' % ', '.join(self._docinfo['author']) |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
586 ) |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
587 skip = ( |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
588 'author', |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
589 'copyright', |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
590 'date', |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
591 'manual_group', |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
592 'manual_section', |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
593 'subtitle', |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
594 'title', |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
595 'title_upper', |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
596 'version', |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
597 ) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
598 for name in self._docinfo_keys: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
599 if name == 'address': |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
600 self.body.append( |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
601 "\n%s:\n%s%s.nf\n%s\n.fi\n%s%s" |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
602 % ( |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
603 self.language.labels.get(name, name), |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
604 self.defs['indent'][0] % 0, |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
605 self.defs['indent'][0] % BLOCKQOUTE_INDENT, |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
606 self._docinfo[name], |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
607 self.defs['indent'][1], |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
608 self.defs['indent'][1], |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
609 ) |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
610 ) |
16686
67964cda8701
cleanup: "not x in y" -> "x not in y"
Brodie Rao <brodie@sf.io>
parents:
16611
diff
changeset
|
611 elif name not in skip: |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
612 if name in self._docinfo_names: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
613 label = self._docinfo_names[name] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
614 else: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
615 label = self.language.labels.get(name, name) |
10282
08a0f04b56bd
many, many trivial check-code fixups
Matt Mackall <mpm@selenic.com>
parents:
10007
diff
changeset
|
616 self.body.append("\n%s: %s\n" % (label, self._docinfo[name])) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
617 if self._docinfo['copyright']: |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
618 self.body.append('.SH COPYRIGHT\n%s\n' % self._docinfo['copyright']) |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
619 self.body.append( |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
620 self.comment('Generated by docutils manpage writer.\n') |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
621 ) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
622 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
623 def visit_emphasis(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
624 self.body.append(self.defs['emphasis'][0]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
625 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
626 def depart_emphasis(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
627 self.body.append(self.defs['emphasis'][1]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
628 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
629 def visit_entry(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
630 # a cell in a table row |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
631 if 'morerows' in node: |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
632 self.document.reporter.warning( |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
633 '"table row spanning" not supported', base_node=node |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
634 ) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
635 if 'morecols' in node: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
636 self.document.reporter.warning( |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
637 '"table cell spanning" not supported', base_node=node |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
638 ) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
639 self.context.append(len(self.body)) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
640 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
641 def depart_entry(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
642 start = self.context.pop() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
643 self._active_table.append_cell(self.body[start:]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
644 del self.body[start:] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
645 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
646 def visit_enumerated_list(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
647 self.list_start(node) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
648 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
649 def depart_enumerated_list(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
650 self.list_end() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
651 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
652 def visit_error(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
653 self.visit_admonition(node, 'error') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
654 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
655 depart_error = depart_admonition |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
656 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
657 def visit_field(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
658 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
659 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
660 def depart_field(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
661 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
662 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
663 def visit_field_body(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
664 if self._in_docinfo: |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
665 name_normalized = self._field_name.lower().replace(" ", "_") |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
666 self._docinfo_names[name_normalized] = self._field_name |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
667 self.visit_docinfo_item(node, name_normalized) |
29158
7c0297bfe8bf
py3: make raise statement python3 compatible
Pulkit Goyal <7895pulkit@gmail.com>
parents:
28967
diff
changeset
|
668 raise nodes.SkipNode() |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
669 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
670 def depart_field_body(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
671 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
672 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
673 def visit_field_list(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
674 self.indent(FIELD_LIST_INDENT) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
675 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
676 def depart_field_list(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
677 self.dedent() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
678 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
679 def visit_field_name(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
680 if self._in_docinfo: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
681 self._field_name = node.astext() |
29158
7c0297bfe8bf
py3: make raise statement python3 compatible
Pulkit Goyal <7895pulkit@gmail.com>
parents:
28967
diff
changeset
|
682 raise nodes.SkipNode() |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
683 else: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
684 self.body.append(self.defs['field_name'][0]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
685 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
686 def depart_field_name(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
687 self.body.append(self.defs['field_name'][1]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
688 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
689 def visit_figure(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
690 self.indent(2.5) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
691 self.indent(0) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
692 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
693 def depart_figure(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
694 self.dedent() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
695 self.dedent() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
696 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
697 def visit_footer(self, node): |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
698 self.document.reporter.warning('"footer" not supported', base_node=node) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
699 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
700 def depart_footer(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
701 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
702 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
703 def visit_footnote(self, node): |
10282
08a0f04b56bd
many, many trivial check-code fixups
Matt Mackall <mpm@selenic.com>
parents:
10007
diff
changeset
|
704 num, text = node.astext().split(None, 1) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
705 num = num.strip() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
706 self.body.append('.IP [%s] 5\n' % self.deunicode(num)) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
707 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
708 def depart_footnote(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
709 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
710 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
711 def footnote_backrefs(self, node): |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
712 self.document.reporter.warning( |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
713 '"footnote_backrefs" not supported', base_node=node |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
714 ) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
715 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
716 def visit_footnote_reference(self, node): |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
717 self.body.append('[' + self.deunicode(node.astext()) + ']') |
29158
7c0297bfe8bf
py3: make raise statement python3 compatible
Pulkit Goyal <7895pulkit@gmail.com>
parents:
28967
diff
changeset
|
718 raise nodes.SkipNode() |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
719 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
720 def depart_footnote_reference(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
721 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
722 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
723 def visit_generated(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
724 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
725 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
726 def depart_generated(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
727 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
728 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
729 def visit_header(self, node): |
29158
7c0297bfe8bf
py3: make raise statement python3 compatible
Pulkit Goyal <7895pulkit@gmail.com>
parents:
28967
diff
changeset
|
730 raise NotImplementedError(node.astext()) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
731 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
732 def depart_header(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
733 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
734 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
735 def visit_hint(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
736 self.visit_admonition(node, 'hint') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
737 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
738 depart_hint = depart_admonition |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
739 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
740 def visit_subscript(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
741 self.body.append('\\s-2\\d') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
742 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
743 def depart_subscript(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
744 self.body.append('\\u\\s0') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
745 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
746 def visit_superscript(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
747 self.body.append('\\s-2\\u') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
748 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
749 def depart_superscript(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
750 self.body.append('\\d\\s0') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
751 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
752 def visit_attribution(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
753 self.body.append('\\(em ') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
754 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
755 def depart_attribution(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
756 self.body.append('\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
757 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
758 def visit_image(self, node): |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
759 self.document.reporter.warning('"image" not supported', base_node=node) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
760 text = [] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
761 if 'alt' in node.attributes: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
762 text.append(node.attributes['alt']) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
763 if 'uri' in node.attributes: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
764 text.append(node.attributes['uri']) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
765 self.body.append('[image: %s]\n' % ('/'.join(text))) |
29158
7c0297bfe8bf
py3: make raise statement python3 compatible
Pulkit Goyal <7895pulkit@gmail.com>
parents:
28967
diff
changeset
|
766 raise nodes.SkipNode() |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
767 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
768 def visit_important(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
769 self.visit_admonition(node, 'important') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
770 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
771 depart_important = depart_admonition |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
772 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
773 def visit_label(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
774 # footnote and citation |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
775 if isinstance(node.parent, nodes.footnote) or isinstance( |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
776 node.parent, nodes.citation |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
777 ): |
29158
7c0297bfe8bf
py3: make raise statement python3 compatible
Pulkit Goyal <7895pulkit@gmail.com>
parents:
28967
diff
changeset
|
778 raise nodes.SkipNode() |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
779 self.document.reporter.warning('"unsupported "label"', base_node=node) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
780 self.body.append('[') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
781 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
782 def depart_label(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
783 self.body.append(']\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
784 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
785 def visit_legend(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
786 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
787 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
788 def depart_legend(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
789 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
790 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
791 # WHAT should we use .INDENT, .UNINDENT ? |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
792 def visit_line_block(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
793 self._line_block += 1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
794 if self._line_block == 1: |
10006
9c142ed9c405
rst2man: separate inline blocks from previous paragraphs
Christian Ebert <blacktrash@gmx.net>
parents:
9793
diff
changeset
|
795 self.body.append('.sp\n') |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
796 self.body.append('.nf\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
797 else: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
798 self.body.append('.in +2\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
799 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
800 def depart_line_block(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
801 self._line_block -= 1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
802 if self._line_block == 0: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
803 self.body.append('.fi\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
804 self.body.append('.sp\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
805 else: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
806 self.body.append('.in -2\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
807 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
808 def visit_line(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
809 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
810 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
811 def depart_line(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
812 self.body.append('\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
813 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
814 def visit_list_item(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
815 # man 7 man argues to use ".IP" instead of ".TP" |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
816 self.body.append( |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
817 '.IP %s %d\n' |
45942
89a2afe31e82
formating: upgrade to black 20.8b1
Augie Fackler <raf@durin42.com>
parents:
43076
diff
changeset
|
818 % ( |
89a2afe31e82
formating: upgrade to black 20.8b1
Augie Fackler <raf@durin42.com>
parents:
43076
diff
changeset
|
819 next(self._list_char[-1]), |
89a2afe31e82
formating: upgrade to black 20.8b1
Augie Fackler <raf@durin42.com>
parents:
43076
diff
changeset
|
820 self._list_char[-1].get_width(), |
89a2afe31e82
formating: upgrade to black 20.8b1
Augie Fackler <raf@durin42.com>
parents:
43076
diff
changeset
|
821 ) |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
822 ) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
823 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
824 def depart_list_item(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
825 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
826 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
827 def visit_literal(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
828 self.body.append(self.defs['literal'][0]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
829 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
830 def depart_literal(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
831 self.body.append(self.defs['literal'][1]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
832 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
833 def visit_literal_block(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
834 self.body.append(self.defs['literal_block'][0]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
835 self._in_literal = True |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
836 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
837 def depart_literal_block(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
838 self._in_literal = False |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
839 self.body.append(self.defs['literal_block'][1]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
840 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
841 def visit_meta(self, node): |
29158
7c0297bfe8bf
py3: make raise statement python3 compatible
Pulkit Goyal <7895pulkit@gmail.com>
parents:
28967
diff
changeset
|
842 raise NotImplementedError(node.astext()) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
843 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
844 def depart_meta(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
845 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
846 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
847 def visit_note(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
848 self.visit_admonition(node, 'note') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
849 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
850 depart_note = depart_admonition |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
851 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
852 def indent(self, by=0.5): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
853 # if we are in a section ".SH" there already is a .RS |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
854 step = self._indent[-1] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
855 self._indent.append(by) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
856 self.body.append(self.defs['indent'][0] % step) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
857 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
858 def dedent(self): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
859 self._indent.pop() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
860 self.body.append(self.defs['indent'][1]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
861 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
862 def visit_option_list(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
863 self.indent(OPTION_LIST_INDENT) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
864 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
865 def depart_option_list(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
866 self.dedent() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
867 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
868 def visit_option_list_item(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
869 # one item of the list |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
870 self.body.append(self.defs['option_list_item'][0]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
871 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
872 def depart_option_list_item(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
873 self.body.append(self.defs['option_list_item'][1]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
874 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
875 def visit_option_group(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
876 # as one option could have several forms it is a group |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
877 # options without parameter bold only, .B, -v |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
878 # options with parameter bold italic, .BI, -f file |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
879 # |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
880 # we do not know if .B or .BI |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
881 self.context.append('.B') # blind guess |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
882 self.context.append(len(self.body)) # to be able to insert later |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
883 self.context.append(0) # option counter |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
884 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
885 def depart_option_group(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
886 self.context.pop() # the counter |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
887 start_position = self.context.pop() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
888 text = self.body[start_position:] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
889 del self.body[start_position:] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
890 self.body.append('%s%s\n' % (self.context.pop(), ''.join(text))) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
891 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
892 def visit_option(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
893 # each form of the option will be presented separately |
10282
08a0f04b56bd
many, many trivial check-code fixups
Matt Mackall <mpm@selenic.com>
parents:
10007
diff
changeset
|
894 if self.context[-1] > 0: |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
895 self.body.append(', ') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
896 if self.context[-3] == '.BI': |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
897 self.body.append('\\') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
898 self.body.append(' ') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
899 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
900 def depart_option(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
901 self.context[-1] += 1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
902 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
903 def visit_option_string(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
904 # do not know if .B or .BI |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
905 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
906 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
907 def depart_option_string(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
908 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
909 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
910 def visit_option_argument(self, node): |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
911 self.context[-3] = '.BI' # bold/italic alternate |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
912 if node['delimiter'] != ' ': |
10282
08a0f04b56bd
many, many trivial check-code fixups
Matt Mackall <mpm@selenic.com>
parents:
10007
diff
changeset
|
913 self.body.append('\\fB%s ' % node['delimiter']) |
18054
b35e3364f94a
check-code: there must also be whitespace between ')' and operator
Mads Kiilerich <madski@unity3d.com>
parents:
17517
diff
changeset
|
914 elif self.body[len(self.body) - 1].endswith('='): |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
915 # a blank only means no blank in output, just changing font |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
916 self.body.append(' ') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
917 else: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
918 # blank backslash blank, switch font then a blank |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
919 self.body.append(' \\ ') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
920 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
921 def depart_option_argument(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
922 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
923 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
924 def visit_organization(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
925 self.visit_docinfo_item(node, 'organization') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
926 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
927 def depart_organization(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
928 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
929 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
930 def visit_paragraph(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
931 # ``.PP`` : Start standard indented paragraph. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
932 # ``.LP`` : Start block paragraph, all except the first. |
9712
18b134ef294c
kill trailing whitespace
Dirkjan Ochtman <dirkjan@ochtman.nl>
parents:
9628
diff
changeset
|
933 # ``.P [type]`` : Start paragraph type. |
17487 | 934 # NOTE don't use paragraph starts because they reset indentation. |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
935 # ``.sp`` is only vertical space |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
936 self.ensure_eol() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
937 self.body.append('.sp\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
938 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
939 def depart_paragraph(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
940 self.body.append('\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
941 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
942 def visit_problematic(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
943 self.body.append(self.defs['problematic'][0]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
944 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
945 def depart_problematic(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
946 self.body.append(self.defs['problematic'][1]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
947 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
948 def visit_raw(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
949 if node.get('format') == 'manpage': |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
950 self.body.append(node.astext() + "\n") |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
951 # Keep non-manpage raw text out of output: |
29158
7c0297bfe8bf
py3: make raise statement python3 compatible
Pulkit Goyal <7895pulkit@gmail.com>
parents:
28967
diff
changeset
|
952 raise nodes.SkipNode() |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
953 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
954 def visit_reference(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
955 """E.g. link or email address.""" |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
956 self.body.append(self.defs['reference'][0]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
957 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
958 def depart_reference(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
959 self.body.append(self.defs['reference'][1]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
960 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
961 def visit_revision(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
962 self.visit_docinfo_item(node, 'revision') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
963 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
964 depart_revision = depart_docinfo_item |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
965 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
966 def visit_row(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
967 self._active_table.new_row() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
968 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
969 def depart_row(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
970 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
971 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
972 def visit_section(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
973 self.section_level += 1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
974 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
975 def depart_section(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
976 self.section_level -= 1 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
977 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
978 def visit_status(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
979 self.visit_docinfo_item(node, 'status') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
980 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
981 depart_status = depart_docinfo_item |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
982 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
983 def visit_strong(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
984 self.body.append(self.defs['strong'][0]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
985 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
986 def depart_strong(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
987 self.body.append(self.defs['strong'][1]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
988 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
989 def visit_substitution_definition(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
990 """Internal only.""" |
29158
7c0297bfe8bf
py3: make raise statement python3 compatible
Pulkit Goyal <7895pulkit@gmail.com>
parents:
28967
diff
changeset
|
991 raise nodes.SkipNode() |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
992 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
993 def visit_substitution_reference(self, node): |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
994 self.document.reporter.warning( |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
995 '"substitution_reference" not supported', base_node=node |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
996 ) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
997 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
998 def visit_subtitle(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
999 if isinstance(node.parent, nodes.sidebar): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1000 self.body.append(self.defs['strong'][0]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1001 elif isinstance(node.parent, nodes.document): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1002 self.visit_docinfo_item(node, 'subtitle') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1003 elif isinstance(node.parent, nodes.section): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1004 self.body.append(self.defs['strong'][0]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1005 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1006 def depart_subtitle(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1007 # document subtitle calls SkipNode |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
1008 self.body.append(self.defs['strong'][1] + '\n.PP\n') |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1009 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1010 def visit_system_message(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1011 # TODO add report_level |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
1012 # if node['level'] < self.document.reporter['writer'].report_level: |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1013 # Level is too low to display: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1014 # raise nodes.SkipNode |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1015 attr = {} |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1016 if node.hasattr('id'): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1017 attr['name'] = node['id'] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1018 if node.hasattr('line'): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1019 line = ', line %s' % node['line'] |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1020 else: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1021 line = '' |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
1022 self.body.append( |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
1023 '.IP "System Message: %s/%s (%s:%s)"\n' |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
1024 % (node['type'], node['level'], node['source'], line) |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
1025 ) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1026 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1027 def depart_system_message(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1028 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1029 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1030 def visit_table(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1031 self._active_table = Table() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1032 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1033 def depart_table(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1034 self.ensure_eol() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1035 self.body.extend(self._active_table.as_list()) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1036 self._active_table = None |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1037 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1038 def visit_target(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1039 # targets are in-document hyper targets, without any use for man-pages. |
29158
7c0297bfe8bf
py3: make raise statement python3 compatible
Pulkit Goyal <7895pulkit@gmail.com>
parents:
28967
diff
changeset
|
1040 raise nodes.SkipNode() |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1041 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1042 def visit_tbody(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1043 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1044 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1045 def depart_tbody(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1046 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1047 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1048 def visit_term(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1049 self.body.append(self.defs['term'][0]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1050 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1051 def depart_term(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1052 self.body.append(self.defs['term'][1]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1053 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1054 def visit_tgroup(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1055 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1056 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1057 def depart_tgroup(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1058 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1059 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1060 def visit_thead(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1061 # MAYBE double line '=' |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1062 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1063 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1064 def depart_thead(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1065 # MAYBE double line '=' |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1066 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1067 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1068 def visit_tip(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1069 self.visit_admonition(node, 'tip') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1070 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1071 depart_tip = depart_admonition |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1072 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1073 def visit_title(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1074 if isinstance(node.parent, nodes.topic): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1075 self.body.append(self.defs['topic-title'][0]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1076 elif isinstance(node.parent, nodes.sidebar): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1077 self.body.append(self.defs['sidebar-title'][0]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1078 elif isinstance(node.parent, nodes.admonition): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1079 self.body.append('.IP "') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1080 elif self.section_level == 0: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1081 self._docinfo['title'] = node.astext() |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1082 # document title for .TH |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1083 self._docinfo['title_upper'] = node.astext().upper() |
29158
7c0297bfe8bf
py3: make raise statement python3 compatible
Pulkit Goyal <7895pulkit@gmail.com>
parents:
28967
diff
changeset
|
1084 raise nodes.SkipNode() |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1085 elif self.section_level == 1: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1086 self.body.append('.SH ') |
9793
d2006e6d1d59
rst2man: more robust uppercasing of section titles
Martin Geisler <mg@lazybytes.net>
parents:
9791
diff
changeset
|
1087 for n in node.traverse(nodes.Text): |
d2006e6d1d59
rst2man: more robust uppercasing of section titles
Martin Geisler <mg@lazybytes.net>
parents:
9791
diff
changeset
|
1088 n.parent.replace(n, nodes.Text(n.astext().upper())) |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1089 else: |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1090 self.body.append('.SS ') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1091 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1092 def depart_title(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1093 if isinstance(node.parent, nodes.admonition): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1094 self.body.append('"') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1095 self.body.append('\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1096 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1097 def visit_title_reference(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1098 """inline citation reference""" |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1099 self.body.append(self.defs['title_reference'][0]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1100 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1101 def depart_title_reference(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1102 self.body.append(self.defs['title_reference'][1]) |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1103 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1104 def visit_topic(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1105 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1106 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1107 def depart_topic(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1108 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1109 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1110 def visit_sidebar(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1111 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1112 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1113 def depart_sidebar(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1114 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1115 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1116 def visit_rubric(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1117 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1118 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1119 def depart_rubric(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1120 pass |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1121 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1122 def visit_transition(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1123 # .PP Begin a new paragraph and reset prevailing indent. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1124 # .sp N leaves N lines of blank space. |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1125 # .ce centers the next line |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1126 self.body.append('\n.sp\n.ce\n----\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1127 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1128 def depart_transition(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1129 self.body.append('\n.ce 0\n.sp\n') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1130 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1131 def visit_version(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1132 self.visit_docinfo_item(node, 'version') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1133 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1134 def visit_warning(self, node): |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1135 self.visit_admonition(node, 'warning') |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1136 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1137 depart_warning = depart_admonition |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1138 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1139 def unimplemented_visit(self, node): |
43076
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
1140 raise NotImplementedError( |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
1141 'visiting unimplemented node type: %s' % node.__class__.__name__ |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
1142 ) |
2372284d9457
formatting: blacken the codebase
Augie Fackler <augie@google.com>
parents:
42060
diff
changeset
|
1143 |
9418
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1144 |
a82db54bc3be
doc: use our own rst2man.py script (issue1746)
Martin Geisler <mg@lazybytes.net>
parents:
diff
changeset
|
1145 # vim: set fileencoding=utf-8 et ts=4 ai : |