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

[FUJIWARA Katsunori]

At Wed, 25 Apr 2012 03:00:36 +0200,
Mads Kiilerich wrote:
> 
> 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.

Oops ! very sorry for my careless patch !

> 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.

Shoul I post patch like above (for issue3397) ? or should this be
fixed on upstream by some of commiters ?

> Do you have an idea for a better solution?
> 
> /Mads
> 
> _______________________________________________
> Mercurial-devel mailing list
> Mercurial-devel at selenic.com
> http://selenic.com/mailman/listinfo/mercurial-devel
> 


----------------------------------------------------------------------
[FUJIWARA Katsunori]                             foozy at lares.dti.ne.jp