linking to docstrings in the source code broken
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
OpenERP Documentation |
New
|
Undecided
|
Unassigned |
Bug Description
Hello,
While trying to build the doc according to the info presented in the file documentation_
$ PYTHONPATH=
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/
[ 15%] book/7/
Usage: sphinx-build [options]
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/
File "/usr/local/
__import_
ImportError: No module named osv.osv
/home/user/
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
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 1_2_Guided_ Tour/1_ 2_Guided_ Tour_install_ functioreading sources... 5_15_Manufactur ing/5_15_ Manufacturing_ forecastireadin g sources... book/index workspace/ openobject- doc/source/ book/6/ 6_17_Purchases/ 6_17_Purchases_ analytic. rst:: WARNING: document isn't included in any toctree
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/
[ 11%] book/5/
...
[100%] usability_
looking for now-outdated files... none found
pickling environment... done
checking consistency... /home/bstanciu/
done
preparing documents... done
writing output...
[ 4%] book/1/ 1_2_Guided_ Tour/1_ 2_Guided_ Tour_install_ functionwriting output... 5_15_Manufactur ing/5_15_ Manufacturing_ forecastinwriti ng output... introduction towriting output... book/index
[ 11%] book/5/
...
[ 97%] usability_book/2. Business Applications/
[100%] usability_
/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) 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) 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) 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) 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) 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) 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) 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) 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) 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...
/home/bstanciu/
/home/bstanciu/
/home/bstanciu/
/home/bstanciu/
/home/bstanciu/
/home/bstanciu/
/home/bstanciu/
/home/bstanciu/
/home/bstanciu/