Fix: protection of roff requests in literal-block.
[docutils/kirr.git] / sandbox / manpage-writer / expected / test.latin1
blob95185ab7e2c08d6964e6cb1a49e9b5e3dec22f7f
1 RST2MAN(1)                      text processing                     RST2MAN(1)
5 N\bNA\bAM\bME\bE
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
24        -\b-b\bb     another
27        -\b-f\bf,\b, -\b--\b-f\bfo\bor\brc\bce\be
28               really do it
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.
44        Special characters:
47        · backslash: \
50        · hyphen: -
53        · quotes: ´ "
56    L\bLi\bis\bst\bts\bs
57        · bullet list
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,
65          1.  and a nested
68          2.  enumeration
71            · some line
74            · bullets
77          3.  a third
80          4.  a third
83          5.  a third
86            a. alphabetically list
89            b. betacarotin
92            c. grammar
95          6.  a third
98            Y. the end
101            Z. yellow
104          7.  a third
107          8.  a third
110          9.  a third
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.
120        7. dont start with 1
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
132        not flowing into.
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
141               some more text
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:
149               with the colon.
152    T\bTa\bab\bbl\ble\bes\bs
153                                  +---------+-------+
154                                  |single   | frame |
155                                  +---------+-------+
156                                  |no table |       |
157                                  |header   |       |
158                                  +---------+-------+
160    l\bli\bin\bne\beb\bbl\blo\boc\bck\bk
161        paul
162        tel. 12345
163        LA
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
170        some literal text
172        here now it starts
173        and continues
174          indented
175        and back
177        and a paragraph after the literal.
179        some special characters and roff formatting in literal:
181        .SS "." at line start
182        backslash "\"
185    r\bra\baw\bw
186        raw input to man
188    A\bAd\bdm\bmo\bon\bni\bit\bti\bio\bon\bns\bs
189        Attention!
190               Directives at large.
193        Caution!
194               Don´t take any wooden nickels.
197        !DANGER!
198               Mad scientist at work!
201        Error  Does not compute.
204        Hint   It´s bigger than a bread box.
207        Important
209        · Wash behind your ears.
212        · Clean up your room.
215        · Call your mother.
218        · Back up your data.
221        Note   This is a note.
224        Tip    15% if the service is good.
227        Warning
228               Strong prose may provoke extreme mental exertion.   Reader  dis-
229               cretion is strongly advised.
232        And, by the way...
233               You can make up your own admonition too.
235               With more than one paragraph.
237        Text after the admonition.
240    o\bot\bth\bhe\ber\br
241        inline references _\br_\be_\bf _\bs_\bo_\bm_\be_\bt_\bh_\bi_\bn_\bg .
243        Contained verbose. Nothing special.
246 F\bFI\bIL\bLE\bES\bS
247        This is a file.
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!
263 B\bBU\bUG\bGS\bS
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
282        humankind
284        123 Example Street
285        Example, EX  Canada
286        A1B 2C3
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)