sandbox/manpage-writer/expected/test.latin1

   1 RST2MAN(1)                      text processing                     RST2MAN(1)
   2
   3
   4
   5 N\bNA\bAM\bME\bE
   6        rst2man - generate unix manpages from reStructured text
   7
   8 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
   9        r\brs\bst\bt2\b2m\bma\ban\bn -\b--\b-h\bhe\bel\blp\bp
  10
  11        r\brs\bst\bt2\b2m\bma\ban\bn [ OPTIONS ] [ SOURCE [ _\bd_\be_\bs_\bt_\bi_\bn_\ba_\bt_\bi_\bo_\bn ] ]
  12
  13 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
  14        Run it and examine output.
  15
  16 O\bOP\bPT\bTI\bIO\bON\bNS\bS
  17        -\b-o\bo _\bx   an option
  18
  19        -\b-b\bb     another
  20
  21        -\b-f\bf, -\b--\b-f\bfo\bor\brc\bce\be
  22               really do it
  23
  24        For all other options see -\b--\b-h\bhe\bel\blp\bp.
  25
  26 E\bEX\bXA\bAM\bMP\bPL\bLE\bES\bS
  27        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
  28               create a manpage from xml-schema-catalog.rst
  29
  30    C\bCh\bha\bar\bra\bac\bct\bte\ber\br f\bfo\bor\brm\bma\bat\btt\bti\bin\bng\bg
  31        _\bB_\bU_\bG The section title should be separated from the title above.
  32
  33        Test b\bbo\bol\bld\bd or s\bst\btr\bro\bon\bng\bg formatting.
  34
  35        Special characters:
  36
  37        · backslash: \
  38
  39        · hyphen: -
  40
  41        · accents: ´ `
  42
  43        · quotes: ' "
  44
  45        .period ad line start.
  46
  47    L\bLi\bis\bst\bts\bs
  48        · bullet list
  49
  50        · and  a  longer  entry,  and a longer entry, and a longer entry, and a
  51          longer entry, and a longer entry, and a longer entry,  and  a  longer
  52          entry, and a longer entry,
  53
  54          1.  and a nested
  55
  56          2.  enumeration
  57
  58            · some line
  59
  60            · bullets
  61
  62          3.  a third
  63
  64          4.  a third
  65
  66          5.  a third
  67
  68            a. alphabetically list
  69
  70            b. betacarotin
  71
  72            c. grammar
  73
  74          6.  a third
  75
  76            Y. the end
  77
  78            Z. yellow
  79
  80          7.  a third
  81
  82          8.  a third
  83
  84          9.  a third
  85
  86          10. bigger  indentation  if there are more than nine enumerated items
  87              (or there are larger numbers)
  88
  89              a second paragraph that should be separated from the previous one
  90              and not flowing into.
  91
  92        7. dont start with 1
  93
  94        9. dont increment by 1
  95
  96        13. Problematic: indentation does not match for nonconsecutive entries.
  97
  98        This  paragraph  must not be indented with the text the last list-item,
  99        but start at the left margin of the numbers.
 100
 101        a second paragraph that should be separated from the previous  one  and
 102        not flowing into.
 103
 104    D\bDe\bef\bfi\bin\bni\bit\bti\bio\bon\bn L\bLi\bis\bst\bts\bs
 105        T\bTe\ber\brm\bm   Definition
 106
 107        T\bTe\ber\brm\bm   classifier Definition paragraph 1.
 108
 109               Definition paragraph 2.
 110
 111        .\b.i\bin\bni\bi-\b-f\bfi\bil\ble\bes\bs
 112               Term starting with period.
 113
 114        T\bTe\ber\brm\bm   Definition
 115
 116    F\bFi\bie\bel\bld\bd l\bli\bis\bst\bts\bs
 117        f\bfi\bir\brs\bst\bt  a short label and a short text
 118
 119        s\bse\bec\bco\bon\bnd\bdl\bly\by a\ba l\blo\bon\bng\bge\ber\br l\bla\bab\bbe\bel\bl
 120               and  some  more text and some more text and some more text   and
 121               some more text
 122
 123        d\bde\bef\bfi\bin\bni\bit\bti\bio\bon\bn l\bli\bis\bst\bts\bs
 124               are also a valuable option and simple nonintrusive formatting
 125
 126        d\bde\bef\bfi\bin\bni\bit\bti\bio\bon\bn t\bto\boo\bo :\b:
 127               with the colon.
 128
 129    D\bDo\boc\bct\bte\bes\bst\bt B\bBl\blo\boc\bck\bks\bs
 130        >>> print 'Python-specific usage examples; begun with ">>>"'
 131        Python-specific usage examples; begun with ">>>"
 132        >>> print '(cut and pasted from interactive Python sessions)'
 133        (cut and pasted from interactive Python sessions)
 134
 135    T\bTa\bab\bbl\ble\bes\bs
 136                               +----------------+-------+
 137                               |single          | frame |
 138                               +----------------+-------+
 139                               |no table header |       |
 140                               +----------------+-------+
 141
 142    l\bli\bin\bne\beb\bbl\blo\boc\bck\bk
 143        paul
 144        tel. 12345
 145        LA
 146
 147
 148        A paragraph following the line block.  lorem ipsum  lorem  ipsum  lorem
 149        ipsum lorem ipsum lorem ipsum lorem ipsum lorem ipsum lorem ipsum
 150
 151    L\bLi\bit\bte\ber\bra\bal\bl
 152        some literal text
 153
 154           here now it starts
 155           and continues
 156             indented
 157           and back
 158
 159        and a paragraph after the literal.
 160
 161        some special characters and roff formatting in literal:
 162
 163           .SS "." at line start
 164           backslash "\"
 165
 166    L\bLi\bin\bne\be b\bbl\blo\boc\bck\bks\bs
 167        This is a line block.  It ends with a blank line.
 168          Each new line begins with a vertical bar ("|").
 169          Line breaks and initial indents are preserved.
 170        Continuation lines are wrapped portions of long lines;
 171        they begin with a space in place of the vertical bar.
 172          The left edge of a continuation line need not be aligned with
 173          the left edge of the text above it.
 174
 175        This is a second line block.
 176
 177        Blank lines are permitted internally, but they must begin with a "|".
 178
 179
 180        Take it away, Eric the Orchestra Leader!
 181           A one, two, a one two three four
 182
 183           Half a bee, philosophically,
 184             must, _\bi_\bp_\bs_\bo _\bf_\ba_\bc_\bt_\bo, half not be.
 185           But half the bee has got to be,
 186             _\bv_\bi_\bs _\ba _\bv_\bi_\bs its entity.  D'you see?
 187
 188           But can a bee be said to be
 189             or not to be an entire bee,
 190               when half the bee is not a bee,
 191                 due to some ancient injury?
 192
 193           Singing...
 194
 195
 196    r\bra\baw\bw
 197        raw input to man
 198
 199    A\bAd\bdm\bmo\bon\bni\bit\bti\bio\bon\bns\bs
 200        A\bAT\bTT\bTE\bEN\bNT\bTI\bIO\bON\bN!\b!:\b:
 201           Directives at large.
 202
 203        C\bCA\bAU\bUT\bTI\bIO\bON\bN!\b!:\b:
 204           Don't take any wooden nickels.
 205
 206        !\b!D\bDA\bAN\bNG\bGE\bER\bR!\b!:\b:
 207           Mad scientist at work!
 208
 209        E\bER\bRR\bRO\bOR\bR:\b:
 210           Does not compute.
 211
 212        H\bHI\bIN\bNT\bT:\b:
 213           It's bigger than a bread box.
 214
 215        I\bIM\bMP\bPO\bOR\bRT\bTA\bAN\bNT\bT:\b:
 216
 217           · Wash behind your ears.
 218
 219           · Clean up your room.
 220
 221           · Call your mother.
 222
 223           · Back up your data.
 224
 225        N\bNO\bOT\bTE\bE:\b:
 226           This is a note.
 227
 228        T\bTI\bIP\bP:\b:
 229           15% if the service is good.
 230
 231        W\bWA\bAR\bRN\bNI\bIN\bNG\bG:\b:
 232           Strong prose may provoke extreme mental exertion.  Reader discretion
 233           is strongly advised.
 234
 235           And, by the way...
 236
 237                  You can make up your own admonition too.
 238
 239                  With more than one paragraph.
 240
 241        Text after the admonition.
 242
 243    o\bot\bth\bhe\ber\br
 244        inline references _\br_\be_\bf _\bs_\bo_\bm_\be_\bt_\bh_\bi_\bn_\bg .  Contained verbose. Nothing special.
 245
 246 T\bTO\bOP\bP S\bSE\bEC\bCT\bTI\bIO\bON\bN
 247        With mixed case
 248
 249 T\bTO\bOP\bP S\bSE\bEC\bCT\bTI\bIO\bON\bN B\bB C\bC D\bD E\bE F\bF G\bG
 250        with character formatting.
 251
 252 F\bFI\bIL\bLE\bES\bS
 253        This is a file.
 254
 255 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
 256        _\bd_\bo_\bc_\bu_\bt_\bi_\bl_\bs
 257
 258        r\brs\bst\bt2\b2x\bxm\bml\bl(dummy)
 259
 260        More information can be found about
 261
 262        · 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/
 263
 264        And see the stars at the sky!
 265
 266 B\bBU\bUG\bGS\bS
 267        Numerous mapping problems.
 268
 269        1. Where do we get the manual section number from ? Commandline ?
 270
 271        2. docutils authors should be filled into section "AUTHORS".
 272
 273        3. be carefull with linebreaks in generated code.
 274
 275        4. list items.  bullets and enumerators.
 276
 277 A\bAU\bUT\bTH\bHO\bOR\bR
 278        grubert@users.sourceforge.net
 279
 280        Organization: humankind
 281
 282        Address:
 283           123 Example Street
 284           Example, EX  Canada
 285           A1B 2C3
 286
 287 C\bCO\bOP\bPY\bYR\bRI\bIG\bGH\bHT\bT
 288        public domain Behave responsible.
 289
 290
 291
 292
 293 0.0.1                             2009-06-22                        RST2MAN(1)