General Sphinx usage
====================

With a few exceptions, :mod:`sphinx` markup is a superset of
`docutils <http://docutils.sourceforge.net/index.html>`_
restructured text.

In your sphinx installation, the doc directory contains
sphinx-generated html as well as the source rst files.
You can regenerate html or pdf with the :ref:`sphinx-build` command.


This documentation contains an introduction to restructured text markup, but you
will probably need to consult some more detailed 
:mod:`docutils` `ReSt documentation <http://docutils.sourceforge.net/rst.html>`_ 
(e.g.  :mod:`docutils` `ReSt quickref <http://docutils.sourceforge.net/docs/user/rst/quickref.html>`_)



Some initial pointers:

.. note::

   *  tab-indentations in re-structured text are three spaces
   *  text enclosed in single back-ticks is *interpreted*
   *  text enclosed in double back-ticks is simply emphasized 

A brief tour
------------

.. toctree::
   :maxdepth: 1

   getting_started
   features/index