.. include:: headings.inc

.. module:: lib.pubsub.sphinx

.. currentmodule:: lib.pubsub.sphinx

.. highlight:: python



.. _lib.pubsub.sphinx:

==========================================================================================================================================
|phoenix_title|  **sphinx**
==========================================================================================================================================

Sphinx autodoc requires direct import of pubsub.pubsub1.pub. 
But in that case, the pub module no longer has access to 
sibbling modules from pubsub package. By adding ".." to 
sys.path, "import something" in pubsub1/pub.py find the 
module in pubsub and sphinx autodoc works as expected. 

This module should be used from sphinx's conf.py.