text wrapping in doc_generate causes broken links and ReST syntax errors (was: make docs fails creating manpage due to "-0.92" at lines 2344, 2424)
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
Bazaar |
Fix Released
|
Medium
|
Martin Pool |
Bug Description
Issuing make docs in the source directory for bzr 1.5 fails with the following error:
python tools/rst2html.py --link-stylesheet --footnote-
doc/en/
Exiting due to level-2 (WARNING) system message.
make: *** [doc/en/
I discovered that substituting "--pack" for "--pack-0.92" allows the generation to continue but the same error occurs at line 2424 (which seems to be a repeat of 2344). I did not tinker further since removing "-0.92" obviously is not a fix - I just wanted to figure out which part of the line caused the error. Unfortunately, I'm not familiar with the mark-up for RST and my efforts to correct doc/en/
I checked MacPorts in case they had a patch but couldn't find anything relevant.
I'm not sure if this is a bzr bug, a docutils bug or something else but this seemed the best place to report it initially.
Darwin Kernel Version 8.11.0: Wed Oct 10 18:26:00 PDT 2007; root:xnu-
bzr 1.5
python 2.5.2
docutils snapshot (downloaded 2008/07/14)
Related branches
Changed in bzr: | |
assignee: | nobody → mbp |
status: | Confirmed → In Progress |
Bumping the version of docutils from 0.4.1 to 0.6.0 in tools/rst2html.py at line 23 allows the documentation to build successfully but I gather from the comments there that this is not an optimal solution.