doc generation fails with python-docutils 0.8 - :hg: gives invalid option block

Mads Kiilerich mads at kiilerich.com
Tue Apr 24 20:00:36 CDT 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