{"thread":{"id":"20262","subject":"Re: [PATCH] Documentation: Fix build failure of docs.","startedAt":"2009-07-28T16:39:33Z","lastAt":"2009-07-29T09:09:49Z","messageCount":3,"participants":["Saikiran Madugula","Michael J Gruber"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"118971","messageId":"4A6F29C5.6030608@gmail.com","threadId":"20262","inReplyTo":null,"subject":"Re: [PATCH] Documentation: Fix build failure of docs.","fromName":"Saikiran Madugula","fromEmail":"hummerbliss@gmail.com","sentAt":"2009-07-28T16:39:33Z","receivedAt":"2009-07-28T16:39:33Z","isPatch":true,"sender":{"key":"hummerbliss@gmail.com","avatar":null},"body":"OOps, forgot to cc vger.kernel.org\n\nThomas Rast wrote:\n> NAK. Presumably you are using an asciidoc 8.x? Please check if\n> saying\n> \n> make ASCIIDOC8=Yes man\n> \n> fixes the problem. Read the comments in Documentation/Makefile for\n> advice on what precise combination of options you should use. Also,\n> if you do not want to actually work on docs\n> \n> make quick-install-man\n> \n> is a much less painful way to get manpages (in this case, from Junio's\n> 'man' branch that has preformatted manpages for 'master').\n\nMy asciidoc version is 8.4.1. Yes \"make ASCIIDOC8=yes\" seems to have built with\nout any problems. Thanks for quick-install-man tip, I should have read till the\nend of INSTALL document :) .\n> \n> I put the +++ in there to stop the version I used at the time from\n> rendering the closing backtick as part of the URL and garbling the\n> entire paragraph in the process. To be precise, with asciidoc 8.2.7\n> and without the +++ I get\n> \n> Clone it with git clone file:///path/to/repo>.\n> \n> in the HTML output. Note the nested tags. (With asciidoc 8.4.5 the\n> problem appears to be fixed.)\n> \n\nPeople would start using latest versions of ascii doc which has no problems,\nwouldn't it be better if the default compile options suit them ? Also, it would\nbe good if \"make install man\", would do \"quick-install-man\" as default to\nprevent users from the painful compilation of manpages everytime they try to\ninstall latest git.\n"},{"id":"118976","messageId":"4A6F3D57.2010602@drmicha.warpmail.net","threadId":"20262","inReplyTo":"4A6F29C5.6030608@gmail.com","subject":"Re: [PATCH] Documentation: Fix build failure of docs.","fromName":"Michael J Gruber","fromEmail":"git@drmicha.warpmail.net","sentAt":"2009-07-28T18:03:03Z","receivedAt":"2009-07-28T18:03:03Z","isPatch":true,"sender":{"key":"git@grubix.eu","avatar":"https://avatars.githubusercontent.com/u/233215?v=4"},"body":"Saikiran Madugula venit, vidit, dixit 28.07.2009 18:39:\n> OOps, forgot to cc vger.kernel.org\n> \n> Thomas Rast wrote:\n>> NAK. Presumably you are using an asciidoc 8.x? Please check if\n>> saying\n>>\n>> make ASCIIDOC8=Yes man\n>>\n>> fixes the problem. Read the comments in Documentation/Makefile for\n>> advice on what precise combination of options you should use. Also,\n>> if you do not want to actually work on docs\n>>\n>> make quick-install-man\n>>\n>> is a much less painful way to get manpages (in this case, from Junio's\n>> 'man' branch that has preformatted manpages for 'master').\n> \n> My asciidoc version is 8.4.1. Yes \"make ASCIIDOC8=yes\" seems to have built with\n> out any problems. Thanks for quick-install-man tip, I should have read till the\n> end of INSTALL document :) .\n>>\n>> I put the +++ in there to stop the version I used at the time from\n>> rendering the closing backtick as part of the URL and garbling the\n>> entire paragraph in the process. To be precise, with asciidoc 8.2.7\n>> and without the +++ I get\n>>\n>> Clone it with git clone file:///path/to/repo>.\n>>\n>> in the HTML output. Note the nested tags. (With asciidoc 8.4.5 the\n>> problem appears to be fixed.)\n>>\n> \n> People would start using latest versions of ascii doc which has no problems,\n> wouldn't it be better if the default compile options suit them ? Also, it would\n> be good if \"make install man\", would do \"quick-install-man\" as default to\n> prevent users from the painful compilation of manpages everytime they try to\n> install latest git.\n\n\"make install\" does not build any documentation at all, so that should\nbe no source of pain.\n\nThe user decides which we to go: install-man or quick-install-man.\n\nHaving the defaults set up so that recent \"mainstream\" versions of the\ntool chain work without extra options may sound like a good idea - but\nthat would mean changing options again and again. I think we should do\nthis for major milestones (say git 1.7).\n\nMichael\n"},{"id":"119043","messageId":"4A7011DD.5020709@gmail.com","threadId":"20262","inReplyTo":"4A6F3D57.2010602@drmicha.warpmail.net","subject":"Re: [PATCH] Documentation: Fix build failure of docs.","fromName":"Saikiran Madugula","fromEmail":"hummerbliss@gmail.com","sentAt":"2009-07-29T09:09:49Z","receivedAt":"2009-07-29T09:09:49Z","isPatch":true,"sender":{"key":"hummerbliss@gmail.com","avatar":null},"body":"Michael J Gruber wrote:\n> Saikiran Madugula venit, vidit, dixit 28.07.2009 18:39:\n>>>\n>> People would start using latest versions of ascii doc which has no problems,\n>> wouldn't it be better if the default compile options suit them ? Also, it would\n>> be good if \"make install man\", would do \"quick-install-man\" as default to\n>> prevent users from the painful compilation of manpages everytime they try to\n>> install latest git.\n> \n> \"make install\" does not build any documentation at all, so that should\n> be no source of pain.\n> \n> The user decides which we to go: install-man or quick-install-man.\n> \n> Having the defaults set up so that recent \"mainstream\" versions of the\n> tool chain work without extra options may sound like a good idea - but\n> that would mean changing options again and again. I think we should do\n> this for major milestones (say git 1.7).\n> \n> Michael\nSure.\n"}]}