doc generation fails with python-docutils 0.8 - :hg: gives invalid option block
Mads Kiilerich
mads at kiilerich.com
Wed Apr 25 01:00:36 UTC 2012
Hi
generating docs with python-docutils 0.8 currently fails on stable:
> python runrst hgmanpage --halt warning \
> --strip-elements-with-class htmlonly hg.1.txt hg.1
> hg.1.gendoc.txt:3336: (ERROR/3) Error in "note" directive:
> invalid option block.
>
> .. note::
> Patterns specified in ``.hgignore`` are not rooted. Please see
> :hg:`help hgignore` for details.
>
> Exiting due to level-3 (ERROR) system message.
Html fails the same way.
A simple and stupid workaround is to wrap the text differently so we
don't have a note line starting with :hg: :
--- a/mercurial/help/patterns.txt
+++ b/mercurial/help/patterns.txt
@@ -7,8 +7,8 @@
Alternate pattern notations must be specified explicitly.
.. note::
- Patterns specified in ``.hgignore`` are not rooted. Please see
- :hg:`help hgignore` for details.
+ Patterns specified in ``.hgignore`` are not rooted.
+ Please see :hg:`help hgignore` for details.
Do you have an idea for a better solution?
/Mads
More information about the Mercurial-devel
mailing list