Re: bug report, v1.7.12.1 -- Documentation/git-bundle.xml:130: parser error

From: Hugh Esco <hesco@greens.org>
Date: Sep 30, 2012, 18:29 UTC
Message-ID: <20120930182939.30C058059E@mail.greens.org>
In-Reply-To: <20120930180209.GA13596@sigill.intra.peff.net>

Your are correct.  That is apparently the issue:

git@pbx:~$ asciidoc --version asciidoc 8.2.7

This server is still running Debian Lenny. Not sure when I will be able to rebuild it.

My apologies for spamming your bug reporting list with all of that. I now have source installs of git and gitolite installed and presumably working on this server and promise not to bother you further with that issue.

-- Hugh Esco

Date: Sun, 30 Sep 2012 14:02:09 -0400
From: Jeff King <peff@peff.net>
To: Junio C Hamano <gitster@pobox.com>
Cc: hesco@yourmessagedelivered.com, git@vger.kernel.org
Subject: Re: bug report, v1.7.12.1 -- Documentation/git-bundle.xml:130:
 parser error

On Sun, Sep 30, 2012 at 12:34:18AM -0700, Junio C Hamano wrote:

Show 10 quoted lines

> I suspect that a tilde inside literal `` environment is mishandled
> in your versions of the documentation toolchain.  Either you would
> need to upgrade some tool in the toolchain, or we would need patches
> to the source that would look like:
> 
> 	-such as `master~1` cannot be packaged,...
>         +such as `master{tilde}1` cannot be packaged,...
> 
> to work around this problem if the version of the problematic tool
> you are using is widespread.

That would not work, as commit 6cf378f turned off no-inline-literal, and modern asciidoc would not expand that "{tilde}" at all. My guess is that Hugh is using a version of asciidoc older than 8.4.1, which was the first version to understand inline literals.

This came up already once before:

  http://thread.gmane.org/gmane.comp.version-control.git/198733

where the culprit was older third-party RPMs on RHEL5. It can be worked around by upgrading asciidoc, or using "make quick-install-doc" to pull the pre-built versions.

-Peff