linking to docstrings in the source code broken

[Bogdan Stanciu]

Hello,

While trying to build the doc according to the info presented in the file documentation_process, the process fails in both cases:

$ PYTHONPATH=/home/bstanciu/workspace/server-trunk/openerp make html

mkdir -p build/html build/doctrees
sphinx-build -b html -d build/doctrees source build/html
Running Sphinx v1.0.7
loading pickled environment... not yet created
building [html]: targets for 996 source files that are out of date
updating environment: 996 added, 0 changed, 0 removed
reading sources...
[ 4%] book/1/1_2_Guided_Tour/1_2_Guided_Tour_install_functionalireading sources...
[ 15%] book/7/7_23_Managementsystem/7_23_Managementsystem_nonconf
Usage: sphinx-build [options]eloper/2_5_Objects_Fields_Methods/methods

sphinx-build: error: no such option: -b
make: *** [html] Error 2

if I try without the pythonpath, there is obviously the "not found" error:

$ make html

mkdir -p build/html build/doctrees
sphinx-build -b html -d build/doctrees source build/html
Running Sphinx v1.0.7
loading pickled environment... done
building [html]: targets for 996 source files that are out of date
updating environment: 0 added, 3 changed, 0 removed
Traceback (most recent call last):r/2_5_Objects_Fields_Methods/methods
  File "/usr/local/lib/python2.7/dist-packages/Sphinx-1.0.7-py2.7.egg/sphinx/ext/autodoc.py", line 329, in import_object
    __import__(self.modname)
ImportError: No module named osv.osv

/home/user/workspace/openobject-doc/source/developer/2_5_Objects_Fields_Methods/methods.rst:23: (WARNING/2) autodoc can't import/find class 'osv.osv.osv', it reported error: "No module named osv.osv", please check your spelling and sys.path

looking for now-outdated files... none found
...

and it goes till the end, with a few WARNINGS...
...

Build finished. The HTML pages are in build/html.

thank you!
Bogdan

[Bogdan Stanciu (bstanciu)]

hello,

I just tried the build against version 6.0 and it works quite smoothly... with a few warnings.

$ PYTHONPATH=/home/bstanciu/workspace/6.0/bin make html
mkdir -p build/html build/doctrees
sphinx-build -b html -d build/doctrees source build/html
Running Sphinx v1.0.7
loading pickled environment... not yet created
building [html]: targets for 996 source files that are out of date
updating environment: 996 added, 0 changed, 0 removed
reading sources...
[ 4%] book/1/1_2_Guided_Tour/1_2_Guided_Tour_install_functioreading sources...
[ 11%] book/5/5_15_Manufacturing/5_15_Manufacturing_forecastireading sources...
...
[100%] usability_book/index
looking for now-outdated files... none found
pickling environment... done
checking consistency... /home/bstanciu/workspace/openobject-doc/source/book/6/6_17_Purchases/6_17_Purchases_analytic.rst:: WARNING: document isn't included in any toctree
done
preparing documents... done

writing output...

[ 4%] book/1/1_2_Guided_Tour/1_2_Guided_Tour_install_functionwriting output...
[ 11%] book/5/5_15_Manufacturing/5_15_Manufacturing_forecastinwriting output...
...
[ 97%] usability_book/2. Business Applications/introduction towriting output...
[100%] usability_book/index

/home/bstanciu/workspace/openobject-doc/source/book/0/index.rst:135: WARNING: undefined label: ch-crm (if the link has no caption the label must precede a section header)
/home/bstanciu/workspace/openobject-doc/source/book/0/index.rst:135: WARNING: undefined label: part2-crm (if the link has no caption the label must precede a section header)
/home/bstanciu/workspace/openobject-doc/source/book/0/index.rst:141: WARNING: undefined label: part2-crm (if the link has no caption the label must precede a section header)
/home/bstanciu/workspace/openobject-doc/source/book/1/1_0_Subscribe_Start/index.rst:18: WARNING: undefined label: part5-crm-install (if the link has no caption the label must precede a section header)
/home/bstanciu/workspace/openobject-doc/source/book/1/1_2_Guided_Tour/1_2_Guided_Tour_openerp.rst:352: WARNING: undefined label: part2-crm (if the link has no caption the label must precede a section header)
/home/bstanciu/workspace/openobject-doc/source/book/2/3_CRM_Contacts/communicate.rst:132: WARNING: undefined label: outlook (if the link has no caption the label must precede a section header)
/home/bstanciu/workspace/openobject-doc/source/book/2/3_CRM_Contacts/communicate.rst:322: WARNING: undefined label: thunderbird (if the link has no caption the label must precede a section header)
/home/bstanciu/workspace/openobject-doc/source/book/2/3_CRM_Contacts/leads.rst:102: WARNING: undefined label: ch-crm-fetchmail-install (if the link has no caption the label must precede a section header)
/home/bstanciu/workspace/openobject-doc/source/book/2/3_CRM_Contacts/opport.rst:220: WARNING: undefined label: crm-flow (if the link has no caption the label must precede a section header)
/home/bstanciu/workspace/openobject-doc/source/book/2/3_CRM_Contacts/tracking.rst:28: WARNING: undefined label: part4-crm-sales (if the link has no caption the label must precede a sectio...