Index: /main/waeup.sirp/trunk/docs/source/documentation.rst
===================================================================
--- /main/waeup.sirp/trunk/docs/source/documentation.rst	(revision 5339)
+++ /main/waeup.sirp/trunk/docs/source/documentation.rst	(revision 5340)
@@ -18,4 +18,7 @@
 * Georg Brandl for his `sphinx` package.
 
+See :ref:`building_documentation` to learn how to create HTML or PDF
+versions of this docs.
+
 See :ref:`reporting-bugs` for information how to report bugs in
 `waeup.sirp` itself.
Index: /main/waeup.sirp/trunk/docs/source/userdocs/buildingdocs.rst
===================================================================
--- /main/waeup.sirp/trunk/docs/source/userdocs/buildingdocs.rst	(revision 5340)
+++ /main/waeup.sirp/trunk/docs/source/userdocs/buildingdocs.rst	(revision 5340)
@@ -0,0 +1,47 @@
+.. _building_documentation:
+
+Building Documentation
+**********************
+
+To build the documentation for :mod:`waeup.sirp`, please follow these steps:
+
+Prerequisites
+=============
+
+We assume you already installed `waeup.sirp` as explained in
+:ref:`installing`. You ran ``bin/buildout`` and can find a script
+``bin/waeupdocs``.
+
+Building HTML docs
+==================
+
+After successful install go to the root dir, where `waeup.sirp` is
+located.
+
+There run::
+
+   $ ./bin/waeupdocs
+
+This will (re-)generate any needed docs.
+
+The output can be found in ``docs/build/html``.
+
+Alternatively, you can also go to ``docs/build`` and run::
+
+   $ make html
+
+Actually, ``waeupdocs`` is only a wrapper script around the real main
+script ``sphinx-build``, which should also be located in your ``bin/``
+directory.
+
+You therefore can also run ``bin/spinx-build`` manually, which will
+give you more options, especially, if you want the output to be
+created in a different location or similar.
+
+Building PDF docs
+=================
+
+We're currently not prepared for PDF, but support is already planned.
+
+Please be aware, that any PDF support will require a full TeX
+installation on your system to work.
Index: /main/waeup.sirp/trunk/docs/source/userdocs/index.rst
===================================================================
--- /main/waeup.sirp/trunk/docs/source/userdocs/index.rst	(revision 5339)
+++ /main/waeup.sirp/trunk/docs/source/userdocs/index.rst	(revision 5340)
@@ -6,2 +6,3 @@
 
    install
+   buildingdocs
Index: /main/waeup.sirp/trunk/docs/source/userdocs/install.rst
===================================================================
--- /main/waeup.sirp/trunk/docs/source/userdocs/install.rst	(revision 5339)
+++ /main/waeup.sirp/trunk/docs/source/userdocs/install.rst	(revision 5340)
@@ -1,1 +1,3 @@
+.. _installing: 
+
 .. include:: ../../INSTALL.txt
