psycopg2/doc
Jon Dufresne c1d3948be9 Update documentation to reflect JSON import behavior
The docs don't need to describe what will happen on Python versions
before 2.6 as they are unsupported by psycopg2.

Should have been included in commit
d58844e548, but was missed.
2017-11-28 06:38:44 -08:00
..
src Update documentation to reflect JSON import behavior 2017-11-28 06:38:44 -08:00
COPYING.LESSER Changes license to LGPL3 + OpenSSL exception on all source files 2010-02-12 23:34:53 +01:00
Makefile Disable uploading docs on pythonhosted 2017-08-23 13:42:49 +01:00
pep-0249.txt Fix multiple misspellings 2013-04-26 09:59:40 +01:00
README.rst Docs build process and docs cleaned up 2015-04-28 09:32:58 +01:00
release.rst Improved notes to release psycopg packages 2017-03-13 16:50:57 +00:00
requirements.txt Sphinx version do build docs updated to 1.6 2017-10-18 21:56:48 +01:00
SUCCESS Fix multiple misspellings 2013-04-26 09:59:40 +01:00

How to build psycopg documentation
----------------------------------

Building the documentation usually requires building the library too for
introspection, so you will need the same prerequisites_.  The only extra
prerequisite is virtualenv_: the packages needed to build the docs will be
installed when building the env.

.. _prerequisites: http://initd.org/psycopg/docs/install.html#install-from-source
.. _virtualenv: https://virtualenv.pypa.io/en/latest/

Build the env once with::

    make env

Then you can build the documentation with::

    make

Or the single targets::

    make html
    make text

You should find the rendered documentation in the ``html`` dir and the text
file ``psycopg2.txt``.