bug report, v1.7.12.1 -- Documentation/gitcredentials.xml:180: parser error

From: Hugh Esco <hesco@campaignfoundations.com>
Date: Sep 30, 2012, 08:27 UTC
Message-ID: <20120930042731.d8e2086d.hesco@campaignfoundations.com>

doing a source install of git v1.7.12.1, on the `make all doc` step, I get:

    XMLTO gitcredentials.7
xmlto: input does not validate (status 1)
/usr/local/git-git-51993a4/Documentation/gitcredentials.xml:180: parser error : Opening and ending tag mismatch: emphasis line 180 and literal
<literal>credential.<emphasis role="strong"></literal> (which applies to all cre
                                                      ^
/usr/local/git-git-51993a4/Documentation/gitcredentials.xml:181: parser error : Opening and ending tag mismatch: literal line 181 and emphasis
<literal>credential.&lt;url&gt;.</emphasis></literal>, where &lt;url&gt; matches
                                           ^
make[1]: *** [gitcredentials.7] Error 1
make[1]: Leaving directory `/usr/local/git-git-51993a4/Documentation'
make: *** [doc] Error 2
pbx:/usr/local/git-git-51993a4# diff Documentation/gitcore-tutorial.xml ~hesco/gitcore-tutorial.xml 
824c824
< (notice the asterisk <literal></literal> character), and the first column for
---

> (notice the asterisk <literal><emphasis role="strong"></literal> character), and the first column for

828c828 < All of them have non blank characters in the first column (<literal></literal> ---

> All of them have non blank characters in the first column (<literal></emphasis></literal>

1263c1263 < <note><simpara>You will see two files, <literal>pack-.pack</literal> and <literal>pack-.idx</literal>, ---

> <note><simpara>You will see two files, <literal>pack-<emphasis role="strong">.pack</literal> and <literal>pack-</emphasis>.idx</literal>,

------------------------------------------- and the patch which permitted me to proceed -------------------------------------------

180,181c180,181 < <literal>credential.</literal> (which applies to all credentials), or < <literal>credential.<url>.</literal>, where <url> matches the context as described ---

> <literal>credential.<emphasis role="strong"></literal> (which applies to all credentials), or
> <literal>credential.&lt;url&gt;.</emphasis></literal>, where &lt;url&gt; matches the context as described

And with the resolution of this bug, the `make doc all` completed without further error.

Not sure if my version of the xml parser does not recognize the emphasis tag, although many of these involved overlapping tags and sometimes I saw tags which wrapped literally nothing at all. Have no idea what that might have been about.

-- 
Hugh Esco 
skype: hresco3_ ; 678-921-8186 x21 
http://www.CampaignFoundations.com/
Providing Application Hosting, Telephony, 
Custom Development and Consulting Services 
to Green Candidates, Green Parties and
the non profits working for a just and sustainable future.

if( $insurance->rationing() ) { $people->die(); }
if( isa_ok($self,'Troy::Davis') =~ m/^ok/) { $people->are_whole(); }