1 RST2MAN(1) text processing RST2MAN(1)
6 rst2man - generate unix manpages from reStructured text
10 S
\bSY
\bYN
\bNO
\bOP
\bPS
\bSI
\bIS
\bS
11 r
\brs
\bst
\bt2
\b2m
\bma
\ban
\bn -
\b--
\b-h
\bhe
\bel
\blp
\bp
13 r
\brs
\bst
\bt2
\b2m
\bma
\ban
\bn [ OPTIONS ] [ SOURCE [ _
\bd_
\be_
\bs_
\bt_
\bi_
\bn_
\ba_
\bt_
\bi_
\bo_
\bn ] ]
16 D
\bDE
\bES
\bSC
\bCR
\bRI
\bIP
\bPT
\bTI
\bIO
\bON
\bN
17 Run it and examine output.
20 O
\bOP
\bPT
\bTI
\bIO
\bON
\bNS
\bS
21 -
\b-o
\bo _
\bx an option
27 -
\b-f
\bf,
\b, -
\b--
\b-f
\bfo
\bor
\brc
\bce
\be
30 For all other options see -
\b--
\b-h
\bhe
\bel
\blp
\bp.
33 E
\bEX
\bXA
\bAM
\bMP
\bPL
\bLE
\bES
\bS
34 r
\brs
\bst
\bt2
\b2m
\bma
\ban
\bn.
\b.p
\bpy
\by x
\bxm
\bml
\bl-
\b-s
\bsc
\bch
\bhe
\bem
\bma
\ba-
\b-c
\bca
\bat
\bta
\bal
\blo
\bog
\bg.
\b.r
\brs
\bst
\bt x
\bxm
\bml
\bl-
\b-s
\bsc
\bch
\bhe
\bem
\bma
\ba-
\b-c
\bca
\bat
\bta
\bal
\blo
\bog
\bg.
\b.m
\bma
\ban
\bn
35 create a manpage from xml-schema-catalog.rst
39 C
\bCh
\bha
\bar
\bra
\bac
\bct
\bte
\ber
\br f
\bfo
\bor
\brm
\bma
\bat
\btt
\bti
\bin
\bng
\bg
40 _
\bB_
\bU_
\bG The section title should be separated from the title above.
42 Test b
\bbo
\bol
\bld
\bd or s
\bst
\btr
\bro
\bon
\bng
\bg formatting.
60 · and a longer entry, and a longer entry, and a longer entry, and a
61 longer entry, and a longer entry, and a longer entry, and a longer
62 entry, and a longer entry,
86 a. alphabetically list
113 10. bigger indentation if there are more than nine enumerated items
114 (or there are larger numbers)
116 a second paragraph that should be separated from the previous one
117 and not flowing into.
123 9. dont increment by 1
126 13. Problematic: indentation does not match for nonconsecutive entries.
128 This paragraph must not be indented with the text the last list-item,
129 but start at the left margin of the numbers.
131 a second paragraph that should be separated from the previous one and
135 F
\bFi
\bie
\bel
\bld
\bd l
\bli
\bis
\bst
\bts
\bs
136 f
\bfi
\bir
\brs
\bst
\bt a short label and a short text
139 s
\bse
\bec
\bco
\bon
\bnd
\bdl
\bly
\by a
\ba l
\blo
\bon
\bng
\bge
\ber
\br l
\bla
\bab
\bbe
\bel
\bl
140 and some more text and some more text and some more text and
144 d
\bde
\bef
\bfi
\bin
\bni
\bit
\bti
\bio
\bon
\bn l
\bli
\bis
\bst
\bts
\bs
145 are also a valuable option and simple nonintrusive formatting
148 d
\bde
\bef
\bfi
\bin
\bni
\bit
\bti
\bio
\bon
\bn t
\bto
\boo
\bo :
\b:
152 T
\bTa
\bab
\bbl
\ble
\bes
\bs
160 l
\bli
\bin
\bne
\beb
\bbl
\blo
\boc
\bck
\bk
165 A paragraph following the line block. lorem ipsum lorem ipsum lorem
166 ipsum lorem ipsum lorem ipsum lorem ipsum lorem ipsum lorem ipsum
169 L
\bLi
\bit
\bte
\ber
\bra
\bal
\bl
177 and a paragraph after the literal.
179 some special characters and roff formatting in literal:
181 .SS "." at line start
188 A
\bAd
\bdm
\bmo
\bon
\bni
\bit
\bti
\bio
\bon
\bns
\bs
194 Don´t take any wooden nickels.
198 Mad scientist at work!
201 Error Does not compute.
204 Hint It´s bigger than a bread box.
209 · Wash behind your ears.
212 · Clean up your room.
224 Tip 15% if the service is good.
228 Strong prose may provoke extreme mental exertion. Reader dis-
229 cretion is strongly advised.
233 You can make up your own admonition too.
235 With more than one paragraph.
237 Text after the admonition.
241 inline references _
\br_
\be_
\bf _
\bs_
\bo_
\bm_
\be_
\bt_
\bh_
\bi_
\bn_
\bg .
243 Contained verbose. Nothing special.
250 S
\bSE
\bEE
\bE A
\bAL
\bLS
\bSO
\bO
251 _
\bd_
\bo_
\bc_
\bu_
\bt_
\bi_
\bl_
\bs
253 r
\brs
\bst
\bt2
\b2x
\bxm
\bml
\bl(dummy)
255 More information can be found about
258 · xml-schema-catalog at _
\bh_
\bt_
\bt_
\bp_
\b:_
\b/_
\b/_
\bx_
\bm_
\bl_
\b-_
\bs_
\bc_
\bh_
\be_
\bm_
\ba_
\b-_
\bc_
\ba_
\bt_
\ba_
\bl_
\bo_
\bg_
\b._
\bo_
\br_
\bi_
\bg_
\bo_
\b._
\be_
\bt_
\bh_
\bz_
\b._
\bc_
\bh_
\b/
260 And see the stars at the sky!
264 Numerous mapping problems.
267 1. Where do we get the manual section number from ? Commandline ?
270 2. docutils authors should be filled into section "AUTHORS".
273 3. be carefull with linebreaks in generated code.
276 4. list items. bullets and enumerators.
279 A
\bAU
\bUT
\bTH
\bHO
\bOR
\bR
280 grubert@users.sourceforge.net
288 C
\bCO
\bOP
\bPY
\bYR
\bRI
\bIG
\bGH
\bHT
\bT
289 public domain Behave responsible.
294 0.0.1 2009-06-22 RST2MAN(1)