git@vger.kernel.org mailing list mirror (one of many)
 help / color / mirror / code / Atom feed
* bug report, v1.7.12.1 -- Documentation/git-bundle.xml:130: parser error
@ 2012-09-30  7:08 Hugh Esco
  2012-09-30  7:34 ` Junio C Hamano
  0 siblings, 1 reply; 4+ messages in thread
From: Hugh Esco @ 2012-09-30  7:08 UTC (permalink / raw)
  To: git

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
---
< such as <literal>master<subscript>1</literal> cannot be packaged, but are perfectly suitable for

134c134
> specified explicitly (e.g. <literal>^master</literal><subscript>10</subscript>), or implicitly (e.g.
---
< specified explicitly (e.g. <literal>^master</subscript>10</literal>), or implicitly (e.g.

-------------------------------------------
-------------------------------------------

Next bug encountered with:
Documentation/git-check-ref-format.xml

details to follow in next email.

-- 
Hugh Esco 
404-424-8701
YourMessageDelivered.com
Keeping Your Group in the Loop
No Matter How Large or How Small

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: bug report, v1.7.12.1 -- Documentation/git-bundle.xml:130: parser error
  2012-09-30  7:08 bug report, v1.7.12.1 -- Documentation/git-bundle.xml:130: parser error Hugh Esco
@ 2012-09-30  7:34 ` Junio C Hamano
  2012-09-30 18:02   ` Jeff King
  0 siblings, 1 reply; 4+ messages in thread
From: Junio C Hamano @ 2012-09-30  7:34 UTC (permalink / raw)
  To: hesco; +Cc: git

Hugh Esco <hesco@yourmessagedelivered.com> writes:

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

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: bug report, v1.7.12.1 -- Documentation/git-bundle.xml:130: parser error
  2012-09-30  7:34 ` Junio C Hamano
@ 2012-09-30 18:02   ` Jeff King
  2012-09-30 18:29     ` Hugh Esco
  0 siblings, 1 reply; 4+ messages in thread
From: Jeff King @ 2012-09-30 18:02 UTC (permalink / raw)
  To: Junio C Hamano; +Cc: hesco, git

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

> 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

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: bug report, v1.7.12.1 -- Documentation/git-bundle.xml:130: parser error
  2012-09-30 18:02   ` Jeff King
@ 2012-09-30 18:29     ` Hugh Esco
  0 siblings, 0 replies; 4+ messages in thread
From: Hugh Esco @ 2012-09-30 18:29 UTC (permalink / raw)
  To: gitster, peff; +Cc: git, hesco

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:

> 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

^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2012-09-30 18:36 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2012-09-30  7:08 bug report, v1.7.12.1 -- Documentation/git-bundle.xml:130: parser error Hugh Esco
2012-09-30  7:34 ` Junio C Hamano
2012-09-30 18:02   ` Jeff King
2012-09-30 18:29     ` Hugh Esco

Code repositories for project(s) associated with this public inbox

	https://80x24.org/mirrors/git.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).