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

From: Junio C Hamano <gitster@pobox.com>
Date: Sep 30, 2012, 07:34 UTC
Message-ID: <7vipawge11.fsf@alter.siamese.dyndns.org>
In-Reply-To: <20120930030819.b5195ee0.hesco@yourmessagedelivered.com>

Hugh Esco <hesco@yourmessagedelivered.com> writes:

Show 20 quoted lines

> doing a source install of git v1.7.12.1, 
> on the `make all doc` step, I get:
>
> xmlto: input does not validate (status 1)
> /usr/local/git-git-51993a4/Documentation/git-bundle.xml:130: parser error : Opening and ending tag mismatch: subscript line 130 and literal
> such as <literal>master<subscript>1</literal> cannot be packaged, but are perfec
>                                              ^
> /usr/local/git-git-51993a4/Documentation/git-bundle.xml:134: parser error : Opening and ending tag mismatch: literal line 134 and subscript
> specified explicitly (e.g. <literal>^master</subscript>10</literal>), or implici
>                                                        ^
> make[1]: *** [git-bundle.1] Error 1
> make[1]: Leaving directory `/usr/local/git-git-51993a4/Documentation'
> make: *** [doc] Error 2
>
> -------------------------------------------
> and the patch which permitted me to proceed
> -------------------------------------------
>
> 130c130
>> such as <literal>master</literal><subscript>1</subscript> cannot be packaged, but are perfectly suitable for

PLEASE STOP.

git-anything.xml files are _not_ the source files we edit, so patches to them are not useful for us.

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.