=========
 rst2man
=========

---------------------------------------------
generate unix manpages from reStructured text
---------------------------------------------

:Author: grubert@users.sourceforge.net
:organization: humankind
:Address: 123 Example Street
          Example, EX  Canada
          A1B 2C3
:Date:   2006-10-22
:Copyright: public domain
            Behave responsible.
:Version: 0.0.1
:Manual section: 1
:Manual group: text processing

.. TODO: authors and author with name <email>

SYNOPSIS
========

``rst2man`` ``--help``

``rst2man`` [ OPTIONS ] [ SOURCE [ *destination* ] ]


DESCRIPTION
===========

Run it and examine output.

OPTIONS
=======

-o x   an option
-b     another

For all other options see ``--help``.


EXAMPLES
===========

:rst2man.py xml-schema-catalog.rst xml-schema-catalog.man:
    create a manpage from xml-schema-catalog.rst


Character formatting
--------------------

*BUG* The section title should be separated from the title above.



Lists
-----

* bullet list
* and a longer entry, and a longer entry, and a longer entry, and a longer entry,
  and a longer entry, and a longer entry, and a longer entry, and a longer entry,

  1. and a nested 
  2. enumeration

     - some line 
     - bullets

  3. a third
  4. a third
  5. a third

     a. alphabetically list
     b. betacarotin
     c. grammar

  6. a third
  7. a third
  8. a third
  9. a third
  10. bigger indentation if there are more than nine
      enumerated items (or there are larger numbers)

7. dont start with 1

9. dont increment by 1

13. does not work.

This paragraph must not be indented with the text the last list-item,
but start at the left margin of the numbers.


Field lists
-----------

:first: a short label and a short text
:secondly a longer label: and some more text and some more text
  and some more text   and some more text

definition lists
  are also a valuable option and simple nonintrusive formatting
definition too :
  with the colon.

Tables
------

+----------+--------+
| single   | frame  |
+----------+--------+
| no table |        |
| header   |        |
+----------+--------+

lineblock
---------

| paul
| tel. 12345
| LA

raw
---

.. raw :: manpage

   raw input to man

.. raw :: latex
   
   never seen

other
-----

inline references `ref something` .


FILES
=====

This is a file.

SEE ALSO
========

`docutils <http://docutils.sourceforge.net>`__

``rst2xml``\(dummy)

More information can be found about 

* xml-schema-catalog at
  http://xml-schema-catalog.origo.ethz.ch/

And see the stars at the sky!


BUGS
====

Numerous mapping problems.

1. Where do we get the manual section number from ? Commandline ?
2. docutils authors should be filled into section "AUTHORS".
3. be carefull with linebreaks in generated code.
4. list items. 
   bullets and enumerators.


