{"thread":{"id":"16087","subject":"request for pre-generated git.info pages","startedAt":"2008-10-29T22:00:45Z","lastAt":"2008-10-31T00:19:59Z","messageCount":6,"participants":["Leo Razoumov","Mike Ralphson","Miklos Vajna","Kalle Olavi Niemitalo"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"94234","messageId":"ee2a733e0810291500o67b3f94fibef63e0a173e8cc1@mail.gmail.com","threadId":"16087","inReplyTo":null,"subject":"request for pre-generated git.info pages","fromName":"Leo Razoumov","fromEmail":"slonik.az@gmail.com","sentAt":"2008-10-29T22:00:45Z","receivedAt":"2008-10-29T22:00:45Z","isPatch":false,"sender":{"key":"slonik.az@gmail.com","avatar":null},"body":"I am an emacs user but with my current setup I have difficulties\ngenerating git.info pages. Main Git repo already provides\npre-generated man and html  documentation in \"man\" and \"html\"\nbranches. I would kindly beg to extend this privilege to \"info\" pages\nto benefit all the emacs users out there.\n\n--Leo--\n"},{"id":"94265","messageId":"e2b179460810300206g79e06c63m2060092fa654b18b@mail.gmail.com","threadId":"16087","inReplyTo":"ee2a733e0810291500o67b3f94fibef63e0a173e8cc1@mail.gmail.com","subject":"Re: request for pre-generated git.info pages","fromName":"Mike Ralphson","fromEmail":"mike.ralphson@gmail.com","sentAt":"2008-10-30T09:06:35Z","receivedAt":"2008-10-30T09:06:35Z","isPatch":false,"sender":{"key":"mike.ralphson@gmail.com","avatar":"https://avatars.githubusercontent.com/u/21603?v=4"},"body":"2008/10/29 Leo Razoumov <slonik.az@gmail.com>:\n> I am an emacs user but with my current setup I have difficulties\n> generating git.info pages. Main Git repo already provides\n> pre-generated man and html  documentation in \"man\" and \"html\"\n> branches. I would kindly beg to extend this privilege to \"info\" pages\n> to benefit all the emacs users out there.\n\nUnfortunately I don't have a working asciidoc etc toolchain either\n(though I will take a look at getting it working on my central git box\nwhich is Linux based). As I'm not an emacs or Info user I probably\nwouldn't know if they were building correctly anyway.\n\nHowever, if anyone can do the above, I'll be happy to help them get\nset up to push an 'info' branch to gitbuild.git\n(http://repo.or.cz/w/git/gitbuild.git).\n\nHow often would you want the info pages rebuilt? Just the versions\nwhich Junio tags? Or would you only want them built from one branch\n(e.g. maint)?\n\nMike\n"},{"id":"94266","messageId":"20081030093335.GM24201@genesis.frugalware.org","threadId":"16087","inReplyTo":"e2b179460810300206g79e06c63m2060092fa654b18b@mail.gmail.com","subject":"Re: request for pre-generated git.info pages","fromName":"Miklos Vajna","fromEmail":"vmiklos@frugalware.org","sentAt":"2008-10-30T09:33:35Z","receivedAt":"2008-10-30T09:33:35Z","isPatch":false,"sender":{"key":"vmiklos@frugalware.org","avatar":"https://gravatar.com/avatar/401c1cbbb3a5d13e650c691a2c71d6fd0b80df1a01bc74d9f1972675dd58f2bd?d=mp&s=160"},"body":"On Thu, Oct 30, 2008 at 09:06:35AM +0000, Mike Ralphson <mike.ralphson@gmail.com> wrote:\n> How often would you want the info pages rebuilt? Just the versions\n> which Junio tags? Or would you only want them built from one branch\n> (e.g. maint)?\n\nProbably it could be done in a similar way to the html and the man pages\n(each time master is updated + for tags).\n"},{"id":"94277","messageId":"e2b179460810300501s5569b03ej56616a8ab1c8c28e@mail.gmail.com","threadId":"16087","inReplyTo":"e2b179460810300206g79e06c63m2060092fa654b18b@mail.gmail.com","subject":"Re: request for pre-generated git.info pages","fromName":"Mike Ralphson","fromEmail":"mike.ralphson@gmail.com","sentAt":"2008-10-30T12:01:53Z","receivedAt":"2008-10-30T12:01:53Z","isPatch":false,"sender":{"key":"mike.ralphson@gmail.com","avatar":"https://avatars.githubusercontent.com/u/21603?v=4"},"body":"2008/10/30 Mike Ralphson <mike.ralphson@gmail.com>:\n> Unfortunately I don't have a working asciidoc etc toolchain either\n> (though I will take a look at getting it working on my central git box\n> which is Linux based). As I'm not an emacs or Info user I probably\n> wouldn't know if they were building correctly anyway.\n\nThe only machine at my disposal with a working Python installation\n(and I'm afraid I don't feel inclined to install it anywhere else,\nPython on AIX is painful, and obviously if I was a Python nut, I'd be\nrunning mercurial anyway, right?) is my desktop cygwin installation.\n\nAt least there obtaining asciidoc was no problem, but I think I'm\nstuck in some docbook2x dependency hell with lots of twisty turny\nprerequisities, all alike.\n\nNow deep in a dark cave with a sign saying \"Can't locate\nXML/Handler/SGMLSpl.pm in @INC\", which is where my adventure ends.\nScore 0/100.\n\nSo a volunteer would still be appreciated.\n\nMike\n"},{"id":"94381","messageId":"8763n98yz7.fsf@Astalo.kon.iki.fi","threadId":"16087","inReplyTo":"ee2a733e0810291500o67b3f94fibef63e0a173e8cc1@mail.gmail.com","subject":"Re: request for pre-generated git.info pages","fromName":"Kalle Olavi Niemitalo","fromEmail":"kon@iki.fi","sentAt":"2008-10-30T23:06:20Z","receivedAt":"2008-10-30T23:06:20Z","isPatch":false,"sender":{"key":"kon@iki.fi","avatar":null},"body":"\"Leo Razoumov\" <slonik.az@gmail.com> writes:\n\n> I am an emacs user but with my current setup I have difficulties\n> generating git.info pages.\n\nThis bug in docbook2x 0.8.8 can result in empty *.texi files:\nhttp://sourceforge.net/tracker/index.php?func=detail&aid=1912754&group_id=7856&atid=107856\n`db2x_teximl' does not honor `--to-stdout'\n\nWith docbook2x 0.8.3, I successfully built git.info and gitman.info.\nHowever, the Info browser does not recognize cross-references\nbetween them.  I am playing with some patches to fix those.\n"},{"id":"94382","messageId":"871vxx8vkg.fsf@Astalo.kon.iki.fi","threadId":"16087","inReplyTo":"8763n98yz7.fsf@Astalo.kon.iki.fi","subject":"Re: request for pre-generated git.info pages","fromName":"Kalle Olavi Niemitalo","fromEmail":"kon@iki.fi","sentAt":"2008-10-31T00:19:59Z","receivedAt":"2008-10-31T00:19:59Z","isPatch":false,"sender":{"key":"kon@iki.fi","avatar":null},"body":"Kalle Olavi Niemitalo <kon@iki.fi> writes:\n\n> However, the Info browser does not recognize cross-references\n> between them.  I am playing with some patches to fix those.\n\nThis seems to fix it, although the result isn't pretty.\nNot signed off.\n\ndiff --git a/Documentation/Makefile b/Documentation/Makefile\nindex 62269e3..56e1cf5 100644\n--- a/Documentation/Makefile\n+++ b/Documentation/Makefile\n@@ -184,12 +184,12 @@ git.info: user-manual.texi\n \n user-manual.texi: user-manual.xml\n \t$(RM) $@+ $@\n-\t$(DOCBOOK2X_TEXI) user-manual.xml --to-stdout | $(PERL_PATH) fix-texi.perl >$@+\n+\t$(DOCBOOK2X_TEXI) -s texi.xsl user-manual.xml --to-stdout | $(PERL_PATH) fix-texi.perl >$@+\n \tmv $@+ $@\n \n gitman.texi: $(MAN_XML) cat-texi.perl\n \t$(RM) $@+ $@\n-\t($(foreach xml,$(MAN_XML),$(DOCBOOK2X_TEXI) --to-stdout $(xml);)) | \\\n+\t($(foreach xml,$(MAN_XML),$(DOCBOOK2X_TEXI) -s texi.xsl --to-stdout $(xml);)) | \\\n \t$(PERL_PATH) cat-texi.perl $@ >$@+\n \tmv $@+ $@\n \ndiff --git a/Documentation/texi.xsl b/Documentation/texi.xsl\nnew file mode 100644\nindex 0000000..5c6f4cd\n--- /dev/null\n+++ b/Documentation/texi.xsl\n@@ -0,0 +1,17 @@\n+<xsl:stylesheet xmlns:xsl=\"http://www.w3.org/1999/XSL/Transform\"\n+                xmlns=\"http://docbook2x.sourceforge.net/xmlns/Texi-XML\"\n+                version=\"1.0\">\n+  <!-- docbook2x 0.8.3 recognizes sf.net but not sourceforge.net.  -->\n+  <xsl:import href=\"http://docbook2x.sf.net/latest/xslt/texi/docbook.xsl\"/>\n+\n+  <!-- In a man page, asciidoc.conf expands linkgit to citerefentry.\n+       Each man page goes in gitman.texi so ref/@file is not needed.  -->\n+  <xsl:template match=\"citerefentry[starts-with(refentrytitle, 'git')]\">\n+    <ref node=\"{refentrytitle}\" />\n+  </xsl:template>\n+\n+  <!-- In Git User's Manual, user-manual.conf expands linkgit to ulink.  -->\n+  <xsl:template match=\"ulink[starts-with(@url, 'git') and substring(@url, string-length(@url) - 4) = '.html']\">\n+    <ref node=\"{substring(@url, 1, string-length(@url) - 5)}\" file=\"gitman.info\" />\n+  </xsl:template>\n+</xsl:stylesheet>\n"}]}