On Sun, 29 Jan 2012 12:51:00 -0600
C Anthony Risinger <[email protected]> wrote:
> btw ... does anyone have experience with sphinx (new thread)? i
> can't get the autodoc running because pyjamas.* isn't real modules
Yes, somewhat, more than one year ago, but didn't get it right and in
the middle of the battle I had a context switch that distracted me :)
Anyway, the Sphinx autodoc parser does not use the Python parser to
extract documentation, IIRC. It just need indications on how to reach
the pj sources, that is, I just added
# Insert needed paths
for path in os.environ.get('PYJAMAS_PATHS', '').split(':'):
sys.path.insert(0, path)
to the ``conf.py`` file, and
SPHINXBUILD = $(PYJAMAS_PATHS) sphinx-build
...
# Pyjamas specific paths
PJ_LIBRARY = $(abspath src/pyjamas/library)
PJ_ADDONS = $(abspath src/pyjamas/addons)
PYJAMAS_PATHS := PYJAMAS_PATHS=$(PJ_LIBRARY):$(PJ_ADDONS)
in its ``Makefile``.
hope this helps,
ciao, lele.
--
nickname: Lele Gaifax | Se non si ha voglia di far conoscere a
real: Emanuele Gaifas | qualcuno quello che si รจ fatto, forse
[email protected] | non si doveva farlo affatto. -- Google's CEO
