# git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase 15 messages from 2009-03-11 to 2009-03-31. Participants: Tom Holaday, Michael J Gruber, Jay Soffian, Alejandro Riveira, Alejandro Riveira Fernández, Todd Zullinger, byrnejb. Thread: https://gitlist.dev/t/18266 ## Tom Holaday, 2009-03-11 14:21 Subject: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase Message-ID: <5e68abd90903110721o414283a4te188b58e0e4df8ad@mail.gmail.com> URL: https://gitlist.dev/e/5e68abd90903110721o414283a4te188b58e0e4df8ad%40mail.gmail.com ``` Hello, On OS X 10.5.6 (Leopard), the command ... xmlto -m callouts.xsl man git-filter-branch.xml ... terminates with these errors: xmlto: input does not validate (status 1) /git-1.6.2/Documentation/git-filter-branch.xml:431: parser error : PCDATA invalid Char value 7 Clone it with git clone +++0+++. The clone ^ /git-1.6.2/Documentation/git-filter-branch.xml:431: parser error : PCDATA invalid Char value 7 Clone it with git clone +++0+++. The clone ^ make[1]: *** [git-filter-branch.1] Error 1 make: *** [doc] Error 2 What issue-tracker, if any, would be appropriate for this? -- Tom Holaday ``` ## Michael J Gruber, 2009-03-11 14:43 Subject: Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase Message-ID: <49B7CDFA.30006@drmicha.warpmail.net> URL: https://gitlist.dev/e/49B7CDFA.30006%40drmicha.warpmail.net In-Reply-To: <5e68abd90903110721o414283a4te188b58e0e4df8ad@mail.gmail.com> ``` Tom Holaday venit, vidit, dixit 11.03.2009 15:21: > Hello, > > On OS X 10.5.6 (Leopard), the command ... > > xmlto -m callouts.xsl man git-filter-branch.xml > > ... terminates with these errors: > > xmlto: input does not validate (status 1) > /git-1.6.2/Documentation/git-filter-branch.xml:431: parser error : > PCDATA invalid Char value 7 > Clone it with git clone +++0+++. The clone > ^ > /git-1.6.2/Documentation/git-filter-branch.xml:431: parser error : > PCDATA invalid Char value 7 > Clone it with git clone +++0+++. The clone That means that the xml file is incorrect already, which means it's an asciidoc problem. What's your asciidoc version? > ^ > make[1]: *** [git-filter-branch.1] Error 1 > make: *** [doc] Error 2 > > What issue-tracker, if any, would be appropriate for this? You should send a note to the mailing list ;) Michael ``` ## Jay Soffian, 2009-03-11 15:12 Subject: Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase Message-ID: <76718490903110812t5e1723ebi28a84da680422d8a@mail.gmail.com> URL: https://gitlist.dev/e/76718490903110812t5e1723ebi28a84da680422d8a%40mail.gmail.com In-Reply-To: <5e68abd90903110721o414283a4te188b58e0e4df8ad@mail.gmail.com> ``` On Wed, Mar 11, 2009 at 10:21 AM, Tom Holaday wrote: > Hello, > > On OS X 10.5.6 (Leopard), the command ... > >   xmlto -m callouts.xsl man git-filter-branch.xml > > ... terminates with these errors: Assuming you're using the MacPorts asciidoc, to build on OS X you need: export ASCIIDOC8=YesPlease export DOCBOOK_XSL_172=YesPlease And your man pages still won't be perfect. Preformatted text will look like this: .ft C ... .ft I haven't had a chance to track down what is causing this. If you build and install the html pages and use "help -w" those are formatted fine. You may just want to install the prebuilt man-pages (quick-install-doc or quick-install-man). j. ``` ## Jay Soffian, 2009-03-11 15:39 Subject: Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase Message-ID: <76718490903110839m17041c7bxd7912eb09496c81a@mail.gmail.com> URL: https://gitlist.dev/e/76718490903110839m17041c7bxd7912eb09496c81a%40mail.gmail.com In-Reply-To: <76718490903110812t5e1723ebi28a84da680422d8a@mail.gmail.com> ``` On Wed, Mar 11, 2009 at 11:12 AM, Jay Soffian wrote: > And your man pages still won't be perfect. Preformatted text will look > like this: > >  .ft C >          ... >  .ft Hmm. git-help.txt has this text: ---snip--- ------------------------------------------------ [man] viewer = konqueror viewer = woman ------------------------------------------------ ---snap--- Which gets translated to: ---snip--- .ft C [man] viewer = konqueror viewer = woman .ft ---snap--- While git-push has this text: ---snip--- + -------------------------- git push public #1 git push --repo=public #2 -------------------------- + ---snap--- Which gets translated to: ---snip--- git push public #1 git push --repo=public #2 ---snap--- Both appear to render identically after being transformed into html, but the transformation to man pages leaves the ".ft C" and ".ft" macros literally in the resultant text. This is using asciidoc 8.3.1 and docbook-xsl 1.74.0. Further investigation is in order, but the transformation from asciidoc to man pages is currently deep magic to me. j. ``` ## Jay Soffian, 2009-03-11 15:49 Subject: Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase Message-ID: <76718490903110849x2ef48a89j3f17706390991eda@mail.gmail.com> URL: https://gitlist.dev/e/76718490903110849x2ef48a89j3f17706390991eda%40mail.gmail.com In-Reply-To: <76718490903110839m17041c7bxd7912eb09496c81a@mail.gmail.com> ``` On Wed, Mar 11, 2009 at 11:39 AM, Jay Soffian wrote: > On Wed, Mar 11, 2009 at 11:12 AM, Jay Soffian wrote: >> And your man pages still won't be perfect. Preformatted text will look >> like this: >> >>  .ft C >>          ... >>  .ft I must be losing my mind. This is suddenly working, though I can't track it down to any change in git. I just rebuilt my man pages and this no longer is occurring, even though I still have a terminal window open with the output of "git help help" _showing this problem_ and that's from man pages I built/installed just a few days ago. (And I haven't upgraded MacPorts lately.) Oh well. j. ``` ## Michael J Gruber, 2009-03-11 16:27 Subject: Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase Message-ID: <49B7E670.7060606@drmicha.warpmail.net> URL: https://gitlist.dev/e/49B7E670.7060606%40drmicha.warpmail.net In-Reply-To: <76718490903110849x2ef48a89j3f17706390991eda@mail.gmail.com> ``` Jay Soffian venit, vidit, dixit 11.03.2009 16:49: > On Wed, Mar 11, 2009 at 11:39 AM, Jay Soffian wrote: >> On Wed, Mar 11, 2009 at 11:12 AM, Jay Soffian wrote: >>> And your man pages still won't be perfect. Preformatted text will look >>> like this: >>> >>> .ft C >>> ... >>> .ft > I must be losing my mind. This is suddenly working, though I can't > track it down to any change in git. I just rebuilt my man pages and > this no longer is occurring, even though I still have a terminal > window open with the output of "git help help" _showing this problem_ > and that's from man pages I built/installed just a few days ago. (And > I haven't upgraded MacPorts lately.) > > Oh well. > > j. FWIW: The effect you describe (which is different from the OP) occurs on Fedora 10 as well, and not only for git man pages, also for others. I've been meaning to look into this, just like I've been meaning to look into so much stuff... Michael ``` ## Alejandro Riveira, 2009-03-11 20:12 Subject: Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase Message-ID: URL: https://gitlist.dev/e/gp95vf%24gp1%241%40ger.gmane.org In-Reply-To: <49B7E670.7060606@drmicha.warpmail.net> ``` El Wed, 11 Mar 2009 17:27:28 +0100, Michael J Gruber escribió: > Jay Soffian venit, vidit, dixit 11.03.2009 16:49: >> >> j. > > FWIW: The effect you describe (which is different from the OP) occurs on > Fedora 10 as well, and not only for git man pages, also for others. I've > been meaning to look into this, just like I've been meaning to look into > so much stuff... > "Me too" from a Ubuntu 8.10 Box > Michael ``` ## Michael J Gruber, 2009-03-12 11:17 Subject: Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase Message-ID: <49B8EF3E.2070208@drmicha.warpmail.net> URL: https://gitlist.dev/e/49B8EF3E.2070208%40drmicha.warpmail.net In-Reply-To: ``` Alejandro Riveira venit, vidit, dixit 11.03.2009 21:12: > El Wed, 11 Mar 2009 17:27:28 +0100, Michael J Gruber escribió: > >> Jay Soffian venit, vidit, dixit 11.03.2009 16:49: >>> j. >> FWIW: The effect you describe (which is different from the OP) occurs on >> Fedora 10 as well, and not only for git man pages, also for others. I've >> been meaning to look into this, just like I've been meaning to look into >> so much stuff... >> > "Me too" from a Ubuntu 8.10 Box Following up on this: On Fedora 10, I have asciidoc 8.2.5 and docbook 1.7.4 xsl's. For proper man and html doc, I have to set DOCBOOK_XSL_172=Yes but leave ASCIIDOC8 unset! I always forget, though (just like the packagers). Setting DOCBOOK_XSL_172 shuts off a certain hack which would otherwise introduce the notorious .ft in man output. Setting ASCIIDOC8 would keep _emphasis_ from being transformed into emphasis, which means it would end up as literal _emphasis_ in man as well as html. Michael BTW: Alejandro, please don't cull cc here. ``` ## Alejandro Riveira Fernández, 2009-03-12 14:02 Subject: Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase Message-ID: <20090312150236.5684b816@varda> URL: https://gitlist.dev/e/20090312150236.5684b816%40varda In-Reply-To: <49B8EF3E.2070208@drmicha.warpmail.net> ``` El Thu, 12 Mar 2009 12:17:18 +0100 Michael J Gruber escribió: > Alejandro Riveira venit, vidit, dixit 11.03.2009 21:12: > >> > > "Me too" from a Ubuntu 8.10 Box > > Following up on this: > On Fedora 10, I have asciidoc 8.2.5 and docbook 1.7.4 xsl's. For proper > man and html doc, I have to set DOCBOOK_XSL_172=Yes but leave ASCIIDOC8 > unset! I always forget, though (just like the packagers). > > Setting DOCBOOK_XSL_172 shuts off a certain hack which would otherwise > introduce the notorious .ft in man output. > > Setting ASCIIDOC8 would keep _emphasis_ from being transformed into > emphasis, which means it would end up as literal > _emphasis_ in man as well as html. > > Michael > > BTW: Alejandro, please don't cull cc here. I'm sorry :[ In my defense that was using gmane new service via Pan Thanks for the explanation on how to workaround the issue ``` ## Todd Zullinger, 2009-03-12 17:09 Subject: Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase Message-ID: <20090312170931.GB19175@inocybe.teonanacatl.org> URL: https://gitlist.dev/e/20090312170931.GB19175%40inocybe.teonanacatl.org In-Reply-To: <49B8EF3E.2070208@drmicha.warpmail.net> ``` Michael J Gruber wrote: > Following up on this: > On Fedora 10, I have asciidoc 8.2.5 and docbook 1.7.4 xsl's. For > proper man and html doc, I have to set DOCBOOK_XSL_172=Yes but leave > ASCIIDOC8 unset! I always forget, though (just like the packagers). Check the fedora git packages in rawhide, we don't set ASCIIDOC8. :) I experimented with that and found it did not improve things. We are only setting DOCBOOK_XSL_172. Without that, we get the '.ft C' droppings. With it, we get non-ascii characters in various places (where bold should be used to make the (1) notations stand out, for example). This was filed as: https://bugzilla.redhat.com/show_bug.cgi?id=485161 I didn't add DOCBOOK_XSL_172 to the F-10 packages yet, because I know that it fixes one problem and causes another. Either way, we'd be shipping packages with known brokeness. I chose to stick with keeping the currently broken '.ft C' behavior. Pick your poison. ;) One of the fedora/red hat folks that works on the xmlto and docbook packages was going to take a look, as I very much don't understand the documentation stack. :/ Anyone who does is very welcome to help find the culprit(s) and help get fixes to the proper places. -- Todd OpenPGP -> KeyID: 0xBEAF0CE3 | URL: www.pobox.com/~tmz/pgp ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The worth of a state, in the long run, is the worth of the individuals composing it. -- John Stuart Mill ``` ## Michael J Gruber, 2009-03-13 10:29 Subject: Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase Message-ID: <49BA356D.8050007@drmicha.warpmail.net> URL: https://gitlist.dev/e/49BA356D.8050007%40drmicha.warpmail.net In-Reply-To: <20090312170931.GB19175@inocybe.teonanacatl.org> ``` Todd Zullinger venit, vidit, dixit 12.03.2009 18:09: > Michael J Gruber wrote: >> Following up on this: >> On Fedora 10, I have asciidoc 8.2.5 and docbook 1.7.4 xsl's. For >> proper man and html doc, I have to set DOCBOOK_XSL_172=Yes but leave >> ASCIIDOC8 unset! I always forget, though (just like the packagers). > > Check the fedora git packages in rawhide, we don't set ASCIIDOC8. :) I was unclear, but I meant forgetting to set DOCB... But: > I experimented with that and found it did not improve things. We are > only setting DOCBOOK_XSL_172. Without that, we get the '.ft C' > droppings. With it, we get non-ascii characters in various places > (where bold should be used to make the (1) notations stand out, for > example). This was filed as: > > https://bugzilla.redhat.com/show_bug.cgi?id=485161 I hadn't noticed that yet (neither the effect nor the report). So, you kept it unset intentionally and for a good reason. Please accept my apology! > > I didn't add DOCBOOK_XSL_172 to the F-10 packages yet, because I know > that it fixes one problem and causes another. Either way, we'd be > shipping packages with known brokeness. I chose to stick with keeping > the currently broken '.ft C' behavior. Pick your poison. ;) > > One of the fedora/red hat folks that works on the xmlto and docbook > packages was going to take a look, as I very much don't understand the > documentation stack. :/ > > Anyone who does is very welcome to help find the culprit(s) and help > get fixes to the proper places. So the easy solution is out again, quite a pitty. The problem occurs on F10 as well as F11/rawhide, right? On a related issue: Does anybody know which asciidoc versions need asciidoc7compatible to be set? 8.2.5 and above certainly don't, so we should not advise using it. asciidoc's hg repo doesn't go back much more (the initial revision does not need it either), and I haven't dug for their earlier history yet. Michael J Gruber ``` ## Jay Soffian, 2009-03-13 16:18 Subject: Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase Message-ID: <76718490903130918r733e3ef4meae49311883969b5@mail.gmail.com> URL: https://gitlist.dev/e/76718490903130918r733e3ef4meae49311883969b5%40mail.gmail.com In-Reply-To: <49BA356D.8050007@drmicha.warpmail.net> ``` On Fri, Mar 13, 2009 at 6:29 AM, Michael J Gruber wrote: > On a related issue: Does anybody know which asciidoc versions need > asciidoc7compatible to be set? 8.2.5 and above certainly don't, so we > should not advise using it. asciidoc's hg repo doesn't go back much more > (the initial revision does not need it either), and I haven't dug for > their earlier history yet. I'm using 8.3.1 and set asciidoc7compatible. I don't recall why I set it, but I'm sure I had a good reason for it. :-) j. ``` ## Michael J Gruber, 2009-03-13 17:06 Subject: Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase Message-ID: <49BA9283.9090607@drmicha.warpmail.net> URL: https://gitlist.dev/e/49BA9283.9090607%40drmicha.warpmail.net In-Reply-To: <76718490903130918r733e3ef4meae49311883969b5@mail.gmail.com> ``` Jay Soffian venit, vidit, dixit 13.03.2009 17:18: > On Fri, Mar 13, 2009 at 6:29 AM, Michael J Gruber > wrote: >> On a related issue: Does anybody know which asciidoc versions need >> asciidoc7compatible to be set? 8.2.5 and above certainly don't, so we >> should not advise using it. asciidoc's hg repo doesn't go back much more >> (the initial revision does not need it either), and I haven't dug for >> their earlier history yet. > > I'm using 8.3.1 and set asciidoc7compatible. I don't recall why I set > it, but I'm sure I had a good reason for it. :-) And you don't have any issues with _emphasis_? E.g. in git help filter-branch, "positive" in the second paragraph should be emphasized, possibly underlined. OK, I just checked myself. At least 8.2.7 still had problems, but 8.3.0 is fine, even 8.4.1 is. asciidoc needs to be convinced forcibly to look for its config in its own location (rather than /etc), which is what tripped off my first tests... So, asciidoc version 8.3.0 and above is fine with asciidoc7compatible (at least regarding emphasis), 8.2.4~23 through 8.2.7 is not. Below their hg history ends. Oh well, the doc tool chain. Dig into it and feel chained to a stool, in need to see a doc. Lame pun, time to go home :| Michael ``` ## byrnejb, 2009-03-31 20:17 Subject: Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase Message-ID: <1238530620384-2565224.post@n2.nabble.com> URL: https://gitlist.dev/e/1238530620384-2565224.post%40n2.nabble.com In-Reply-To: <76718490903130918r733e3ef4meae49311883969b5@mail.gmail.com> ``` Hi, I am attempting to build git-1.6.2-1 on CentOS5.3 and running into this problem: parser error : PCDATA invalid Char value 7 I am using asciidoc-8.4.1 and yesterday, when I first built git from the src rpm, the process completed without error. The only thing that has happened to the build system since then is an update of perl packages from epel. I do not see how that would affect anything, but I include the information for completeness nonetheless. In any case, I can live without the documentation if that will get the application built. I have tried the suggestions with respect to setting ENV variables without success: $ set ASCIIDOC8=YesPlease ... DOCBOOK_XSL_172=YesPlease So, have I misunderstood the instructions given here? Is there something else I should do? Is there a way to simply skip the documentation part of the build? -- View this message in context: http://n2.nabble.com/git-doc-build-failure-on-OS-X-10.5.6-%28Leopard%29-during-xmlto-phase-tp2461534p2565224.html Sent from the git mailing list archive at Nabble.com. ``` ## byrnejb, 2009-03-31 20:56 Subject: Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase Message-ID: <1238532991146-2565413.post@n2.nabble.com> URL: https://gitlist.dev/e/1238532991146-2565413.post%40n2.nabble.com In-Reply-To: <1238530620384-2565224.post@n2.nabble.com> ``` Is there a way to simply skip the documentation part of the build? $ rpmbuild -bb --without docs git.spec # this gets me the application at least. Is there a fix or workaroung to get past the asciidoc error? -- View this message in context: http://n2.nabble.com/git-doc-build-failure-on-OS-X-10.5.6-%28Leopard%29-during-xmlto-phase-tp2461534p2565413.html Sent from the git mailing list archive at Nabble.com. ```