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