{"thread":{"id":"17394","subject":"Building Documentation in Cygwin","startedAt":"2009-01-27T15:41:23Z","lastAt":"2009-01-27T20:05:06Z","messageCount":7,"participants":["Tim Visher","Tay Ray Chuan","Junio C Hamano"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"102130","messageId":"c115fd3c0901270741h2f213b99s31bac8829bd182c2@mail.gmail.com","threadId":"17394","inReplyTo":null,"subject":"Building Documentation in Cygwin","fromName":"Tim Visher","fromEmail":"tim.visher@gmail.com","sentAt":"2009-01-27T15:41:23Z","receivedAt":"2009-01-27T15:41:23Z","isPatch":false,"sender":{"key":"tim.visher@gmail.com","avatar":"https://gravatar.com/avatar/98307ce54bcac1a46b5d845827d5386e2a27895ff08790cdd3877ad527760575?d=mp&s=160"},"body":"Hey Everyone,\n\nI've asked this question here before but unfortunately I can't find\nthe answer in any of the archives. I'm trying to build the\ndocumentation on Windows in Cygwin. Git builds fine, the html docs\nbuild fine, but when I get to the man pages, I get the following\nerror:\n\n $ make install-man\n rm -f doc.dep+ doc.dep\n /usr/bin/perl ./build-docdep.perl >doc.dep+\n mv doc.dep+ doc.dep\n make -C ../ GIT-VERSION-FILE\n make[1]: Entering directory `/cygdrive/c/Documents and\nSettings/tvishe01/Desktop/Projects/git'\n make[1]: `GIT-VERSION-FILE' is up to date.\n make[1]: Leaving directory `/cygdrive/c/Documents and\nSettings/tvishe01/Desktop/Projects/git'\n make -C ../ GIT-VERSION-FILE\n make[1]: Entering directory `/cygdrive/c/Documents and\nSettings/tvishe01/Desktop/Projects/git'\n make[1]: `GIT-VERSION-FILE' is up to date.\n make[1]: Leaving directory `/cygdrive/c/Documents and\nSettings/tvishe01/Desktop/Projects/git'\n rm -f git-add.xml+ git-add.xml\n asciidoc -b docbook -d manpage -f asciidoc.conf \\\n -agit_version=1.6.1.1.230.gdfb04 -o git-add.xml+\ngit-add.txt\n mv git-add.xml+ git-add.xml\n rm -f git-add.1\n xmlto -m callouts.xsl man git-add.xml\n xmlto: input does not validate (status 3)\n error : Operation not permitted\n /home/tvishe01/projects/git/Documentation/git-add.xml:2: warning:\nfailed to load external entity\n\"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd\"\n D DocBook XML V4.2//EN\"\n\"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd\"\n\n ^\n error : Operation not permitted\n warning: failed to load external entity\n\"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd\"\n Could not load the external subset\n\"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd\"\n Document /home/tvishe01/projects/git/Documentation/git-add.xml\ndoes not validate\n make: *** [git-add.1] Error 3\n\nI've fixed this before but I've been thwarted all morning on the\nGoogles trying to find out what to do. I remember it having something\nto do with explicitly telling xmlto not to try to download doctypes or\nsomething. Also, I remember there being pre-built man pages somewhere\nthat I could download and just manually install.\n\nAnyway, I'm not opposed to either of those routes, I just can't figure\nout how to do it personally.\n\nThanks in advance!\n\n--\n\nhttp://five.sentenc.es/ - Spend less time on e-mail.\nWritten using [Emacs](http://www.gnu.org/software/emacs/).\n"},{"id":"102132","messageId":"be6fef0d0901270832o1a176691nab5500a86c531795@mail.gmail.com","threadId":"17394","inReplyTo":"c115fd3c0901270741h2f213b99s31bac8829bd182c2@mail.gmail.com","subject":"Re: Building Documentation in Cygwin","fromName":"Tay Ray Chuan","fromEmail":"rctay89@gmail.com","sentAt":"2009-01-27T16:32:05Z","receivedAt":"2009-01-27T16:32:05Z","isPatch":false,"sender":{"key":"rctay89@gmail.com","avatar":"https://avatars.githubusercontent.com/u/61553?v=4"},"body":"Hi,\n\nOn Tue, Jan 27, 2009 at 11:41 PM, Tim Visher wrote:\n> $ make install-man\n> rm -f doc.dep+ doc.dep\n> /usr/bin/perl ./build-docdep.perl >doc.dep+\n> mv doc.dep+ doc.dep\n> make -C ../ GIT-VERSION-FILE\n> make[1]: Entering directory `/cygdrive/c/Documents and\n> Settings/tvishe01/Desktop/Projects/git'\n> make[1]: `GIT-VERSION-FILE' is up to date.\n> make[1]: Leaving directory `/cygdrive/c/Documents and\n> Settings/tvishe01/Desktop/Projects/git'\n> make -C ../ GIT-VERSION-FILE\n> make[1]: Entering directory `/cygdrive/c/Documents and\n> Settings/tvishe01/Desktop/Projects/git'\n> make[1]: `GIT-VERSION-FILE' is up to date.\n> make[1]: Leaving directory `/cygdrive/c/Documents and\n> Settings/tvishe01/Desktop/Projects/git'\n> rm -f git-add.xml+ git-add.xml\n> asciidoc -b docbook -d manpage -f asciidoc.conf \\\n> -agit_version=1.6.1.1.230.gdfb04 -o git-add.xml+\n> git-add.txt\n> mv git-add.xml+ git-add.xml\n> rm -f git-add.1\n> xmlto -m callouts.xsl man git-add.xml\n> xmlto: input does not validate (status 3)\n\nhmm i tried running this and this rule passed for me.\n\ntry running xmlto in verbose, what does it output? here's mine:\n\n---cut---\n\n$ xmlto -v -m callouts.xsl man git-add.xml\nFormat script: /usr/share/xmlto/format/docbook/man\nConvert to troff\nReal stylesheet:\nhttp://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl\nxmllint >/dev/null --xinclude --postvalid\n/cygdrive/g/temp/git/git/Documentation/git-add.xml\nStylesheet: /tmp/xmlto-xsl.nEUjsh\nxsltproc --nonet --xinclude \\\n -o /tmp/xmlto.MvioXw/git-add.proc \\\n /tmp/xmlto-xsl.nEUjsh \\\n /cygdrive/g/temp/git/git/Documentation/git-add.xml\nWriting git-add.1 for refentry\n\n---cut---\n\nyou might also want to try getting the cygwin package docbook-xml42.\n\n-- \nCheers,\nRay Chuan\n"},{"id":"102137","messageId":"c115fd3c0901270944p7a4b6cc5n5dfe9b2f268f038c@mail.gmail.com","threadId":"17394","inReplyTo":"be6fef0d0901270832o1a176691nab5500a86c531795@mail.gmail.com","subject":"Re: Building Documentation in Cygwin","fromName":"Tim Visher","fromEmail":"tim.visher@gmail.com","sentAt":"2009-01-27T17:44:36Z","receivedAt":"2009-01-27T17:44:36Z","isPatch":false,"sender":{"key":"tim.visher@gmail.com","avatar":"https://gravatar.com/avatar/98307ce54bcac1a46b5d845827d5386e2a27895ff08790cdd3877ad527760575?d=mp&s=160"},"body":"On Tue, Jan 27, 2009 at 11:32 AM, Tay Ray Chuan wrote:\n\n> try running xmlto in verbose, what does it output?\n\n$ xmlto -v -m callouts.xsl man git-add.xml\nFormat script: /usr/share/xmlto/format/docbook/man\nConvert to troff\nReal stylesheet:\nhttp://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl\nxmllint >/dev/null --xinclude --postvalid\n/home/tvishe01/projects/git/Documentation/git-add.xml\nxmlto: input does not validate (status 3)\nerror : Operation not permitted\n/home/tvishe01/projects/git/Documentation/git-add.xml:2: warning:\nfailed to load external entity\n\"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd\"\nD DocBook XML V4.2//EN\" \"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd\"\n ^\nerror : Operation not permitted\nwarning: failed to load external entity\n\"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd\"\nCould not load the external subset\n\"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd\"\nDocument /home/tvishe01/projects/git/Documentation/git-add.xml does not validate\n\n-- cut\n\nIt might be germane to mention that I'm attempting to build this on an\noffline box.\n\n> you might also want to try getting the cygwin package docbook-xml42.\n\nSure enough, I didn't have that installed. Turns out I should've done\nthat part first too, as it appears to have fixed my problem. Thanks\nso much!\n\n-- \n\nIn Christ,\n\nTimmy V.\n\nhttp://burningones.com/\nhttp://five.sentenc.es/ - Spend less time on e-mail\n"},{"id":"102153","messageId":"c115fd3c0901271027s61a33273lfe9dd702a66aac6@mail.gmail.com","threadId":"17394","inReplyTo":"c115fd3c0901270944p7a4b6cc5n5dfe9b2f268f038c@mail.gmail.com","subject":"Re: Building Documentation in Cygwin","fromName":"Tim Visher","fromEmail":"tim.visher@gmail.com","sentAt":"2009-01-27T18:27:54Z","receivedAt":"2009-01-27T18:27:54Z","isPatch":false,"sender":{"key":"tim.visher@gmail.com","avatar":"https://gravatar.com/avatar/98307ce54bcac1a46b5d845827d5386e2a27895ff08790cdd3877ad527760575?d=mp&s=160"},"body":"On Tue, Jan 27, 2009 at 12:44 PM, Tim Visher wrote:\n\n>> you might also want to try getting the cygwin package docbook-xml42.\n>\n> Sure enough, I didn't have that installed. Turns out I should've done\n> that part first too, as it appears to have fixed my problem. Thanks\n> so much!\n\nWell, I take that back. I built the docs successfully on the machine\nthat is connected to the net. I couldn't build them on the offline\nbox. Currently my solution is to build them on this box and then\nmanually move them over to the offline box. It'd be nice to not have\nto do this though... :\\\n\nAnyway, further help is appreciated! :)\n\n-- \n\nIn Christ,\n\nTimmy V.\n\nhttp://burningones.com/\nhttp://five.sentenc.es/ - Spend less time on e-mail\n"},{"id":"102155","messageId":"7vskn4y4zt.fsf@gitster.siamese.dyndns.org","threadId":"17394","inReplyTo":"c115fd3c0901271027s61a33273lfe9dd702a66aac6@mail.gmail.com","subject":"Re: Building Documentation in Cygwin","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2009-01-27T18:32:22Z","receivedAt":"2009-01-27T18:32:22Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Tim Visher writes:\n\n> On Tue, Jan 27, 2009 at 12:44 PM, Tim Visher wrote:\n>\n>>> you might also want to try getting the cygwin package docbook-xml42.\n>>\n>> Sure enough, I didn't have that installed. Turns out I should've done\n>> that part first too, as it appears to have fixed my problem. Thanks\n>> so much!\n>\n> Well, I take that back. I built the docs successfully on the machine\n> that is connected to the net. I couldn't build them on the offline\n> box. Currently my solution is to build them on this box and then\n> manually move them over to the offline box. It'd be nice to not have\n> to do this though... :\\\n>\n> Anyway, further help is appreciated! :)\n\nThe xml toolchain has a tendency to download dtds from the original source\nwith a way for you (typically your distribution) to tell it to use a\nlocally installed version. \"Can build online, fail when offline\" is a\nsign that it is not using the local copy.\n"},{"id":"102158","messageId":"c115fd3c0901271127q2a7f0f58i59ff446060982fd7@mail.gmail.com","threadId":"17394","inReplyTo":"7vskn4y4zt.fsf@gitster.siamese.dyndns.org","subject":"Re: Building Documentation in Cygwin","fromName":"Tim Visher","fromEmail":"tim.visher@gmail.com","sentAt":"2009-01-27T19:27:21Z","receivedAt":"2009-01-27T19:27:21Z","isPatch":false,"sender":{"key":"tim.visher@gmail.com","avatar":"https://gravatar.com/avatar/98307ce54bcac1a46b5d845827d5386e2a27895ff08790cdd3877ad527760575?d=mp&s=160"},"body":"On Tue, Jan 27, 2009 at 1:32 PM, Junio C Hamano wrote:\n\n> The xml toolchain has a tendency to download dtds from the original source\n> with a way for you (typically your distribution) to tell it to use a\n> locally installed version. \"Can build online, fail when offline\" is a\n> sign that it is not using the local copy.\n\nSounds like we're on the same page. I'm not familiar enough with any\nof these tools to know how to do anything about that. Does anyone\nknow how to explicitly inform xmlto to use a local DTD? I have it\ninstalled, as far as I know, via cygwin (the docbook-xml42 package)\nbut I don't know how to tell xmlto about it.\n\nThanks in advance!\n\n-- \n\nIn Christ,\n\nTimmy V.\n\nhttp://burningones.com/\nhttp://five.sentenc.es/ - Spend less time on e-mail\n"},{"id":"102160","messageId":"7vpri8347h.fsf@gitster.siamese.dyndns.org","threadId":"17394","inReplyTo":"c115fd3c0901271127q2a7f0f58i59ff446060982fd7@mail.gmail.com","subject":"Re: Building Documentation in Cygwin","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2009-01-27T20:05:06Z","receivedAt":"2009-01-27T20:05:06Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Tim Visher writes:\n\n> On Tue, Jan 27, 2009 at 1:32 PM, Junio C Hamano wrote:\n>\n>> The xml toolchain has a tendency to download dtds from the original source\n>> with a way for you (typically your distribution) to tell it to use a\n>> locally installed version. \"Can build online, fail when offline\" is a\n>> sign that it is not using the local copy.\n>\n> Sounds like we're on the same page. I'm not familiar enough with any\n> of these tools to know how to do anything about that. Does anyone\n> know how to explicitly inform xmlto to use a local DTD? I have it\n> installed, as far as I know, via cygwin (the docbook-xml42 package)\n> but I don't know how to tell xmlto about it.\n>\n> Thanks in advance!\n\nI do not know how Cygwin packages things, but here is an exchange I had\nwith k.org admin when they updated the machine I prepare the preformatted\ndocumentation pages and I had similar trouble.\n\n-- >8 -- from here -- >8 --\n/usr/share/sgml/docbook/xmlcatalog on master.kernel.org is empty:\n\n$ ls -l /usr/share/sgml/docbook/xmlcatalog\n-rw-r--r-- 1 root root 236 2008-06-30 06:51 /usr/share/sgml/docbook/xmlcatalog\n$ cat /usr/share/sgml/docbook/xmlcatalog\n\n\n\n\nOn a good machine, however, it is much larger:\n\n$ ls -l /usr/share/sgml/docbook/xmlcatalog\n-rw-r--r-- 1 root root 7907 Jul 4 14:08 /usr/share/sgml/docbook/xmlcatalog\n$ grep docbookx /usr/share/sgml/docbook/xmlcatalog\n \n \n \n \n\nThe lack of these entries seems to cause the processing to go to the\nnetwork instead of using the files locally installed.\n-- 8< -- to here -- 8< --\n\nand a response I got from them:\n\n-- >8 -- from here -- >8 --\n\nHmmm tried reinstalling docbook-dtds-1.0-35.fc9.noarch.rpm and things\nseem to have showed up like your expecting - clearly a bad dependency in\nthe rpm. Anyway give it a whirl.\n\n-- 8< -- to here -- 8< --\n\nAfter that exchange, things did work much better.\n\nI hope the above (words like \"docbook-dtds\") has enough hints for you to\nfind corresponding set of packages on Cygwin to additionally install or\nfutz with to get the formatting working.\n"}]}