Generate documentation from reStructuredText

README converted to reStructuredText
manual pages now generated dynamically
documentation/nitrate.man no more necessary

2 files changed, 14 insertions, 108 deletions

diff --git a/documentation/nitrate.man b/documentation/nitrate.man
deleted file mode 100644
index ade1542..0000000
--- a/documentation/nitrate.man
+++ /dev/null
@@ -1,84 +0,0 @@
-.\" Man page generated from reStructeredText.
-.
-.TH NITRATE 1 "" "" ""
-.SH NAME
-nitrate \- Python API for the Nitrate test case management system
-.
-.nr rst2man-indent-level 0
-.
-.de1 rstReportMargin
-\\$1 \\n[an-margin]
-level \\n[rst2man-indent-level]
-level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
--
-\\n[rst2man-indent0]
-\\n[rst2man-indent1]
-\\n[rst2man-indent2]
-..
-.de1 INDENT
-.\" .rstReportMargin pre:
-. RS \\$1
-. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
-. nr rst2man-indent-level +1
-.\" .rstReportMargin post:
-..
-.de UNINDENT
-. RE
-.\" indent \\n[an-margin]
-.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
-.nr rst2man-indent-level -1
-.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
-.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
-..
-.SH SYNOPSIS
-.sp
-nitrate
-.SH DESCRIPTION
-.sp
-python\-nitrate provides a high\-level Python interface to the
-Nitrate test case management system. The package also provides
-standalone script \(aqnitrate\(aq which allows easy experimenting with
-the interface directly from the Python interpreter by importing
-all available objects and enabling the readline support. In short,
-after setting your configuration you can directly manipulate all
-nitrate objects, for example:
-.sp
-.nf
-.ft C
-$ nitrate
->>> for case in TestRun(123):
-\&...     print case
-.ft P
-.fi
-.SH CONFIGURATION
-.sp
-To be able to contact the Nitrate server a minimal user config
-file ~/.nitrate has to be provided in the user home directory:
-.sp
-.nf
-.ft C
-[nitrate]
-url = https://nitrate.server/xmlrpc/
-.ft P
-.fi
-.SH SEE ALSO
-.sp
-For more detailed and most up\-to\-date description of all available
-nitrate module features see Python online documentation:
-.sp
-.nf
-.ft C
-pydoc nitrate
-.ft P
-.fi
-.SH AUTHORS
-.sp
-Written by Petr Splichal <\fI\%psplicha@redhat.com\fP>. The Python xmlrpc
-driver is based on the work of Airald Hapairai, David Malcolm
-<\fI\%dmalcolm@redhat.com\fP>, Will Woods <\fI\%wwoods@redhat.com\fP> and Bill Peck
-<\fI\%bpeck@redhat.com\fP> and was enhanced by Chenxiong Qi <\fI\%cqi@redhat.com\fP>,
-Tang Chaobin <\fI\%ctang@redhat.com\fP>, Yuguang Wang <\fI\%yuwang@redhat.com\fP> and
-Xuqing Kuang <\fI\%xuqingkuang@gmail.com\fP>.
-.\" Generated by docutils manpage writer.
-.\" 
-.
diff --git a/documentation/nitrate.rst b/documentation/nitrate.rst
index f32a1a6..a0e6671 100644
--- a/documentation/nitrate.rst
+++ b/documentation/nitrate.rst
@@ -1,31 +1,32 @@
-
-==================================================================
- nitrate
-==================================================================
+===============
+    nitrate
+===============
 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- Python API for the Nitrate test case management system
+    Command line interpreter for the Nitrate Python API
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 :Manual section: 1
+:Manual group: User Commands
+:Date: February 2012
 
 
 SYNOPSIS
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
 nitrate
 
 
 DESCRIPTION
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
 python-nitrate provides a high-level Python interface to the
 Nitrate test case management system. The package also provides
 standalone script 'nitrate' which allows easy experimenting with
 the interface directly from the Python interpreter by importing
-all available objects and enabling the readline support. In short,
-after setting your configuration you can directly manipulate all
-nitrate objects, for example::
+all available objects and enabling the readline support.
+
+In short, after setting your configuration you can easily
+manipulate all Nitrate objects from the command line, for
+example::
 
     $ nitrate
     >>> for case in TestRun(123):
@@ -34,7 +35,6 @@ nitrate objects, for example::
 
 CONFIGURATION
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
 To be able to contact the Nitrate server a minimal user config
 file ~/.nitrate has to be provided in the user home directory::
 
@@ -44,19 +44,9 @@ file ~/.nitrate has to be provided in the user home directory::
 
 SEE ALSO
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+python-nitrate
 
-For more detailed and most up-to-date description of all available
-nitrate module features see Python online documentation::
-
-    pydoc nitrate
 
-
-AUTHORS
+AUTHOR
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Written by Petr Splichal <psplicha@redhat.com>. The Python xmlrpc
-driver is based on the work of Airald Hapairai, David Malcolm
-<dmalcolm@redhat.com>, Will Woods <wwoods@redhat.com> and Bill Peck
-<bpeck@redhat.com> and was enhanced by Chenxiong Qi <cqi@redhat.com>,
-Tang Chaobin <ctang@redhat.com>, Yuguang Wang <yuwang@redhat.com> and
-Xuqing Kuang <xuqingkuang@gmail.com>.
+Petr Šplíchal <psplicha@redhat.com>