{"thread":{"id":"43264","subject":"doc bug?","startedAt":"2006-12-08T17:07:43Z","lastAt":"2006-12-11T13:54:42Z","messageCount":5,"participants":["Han-Wen Nienhuys","Jonas Fonseca","Junio C Hamano"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"295428","messageId":"elc64k$t4i$1@sea.gmane.org","threadId":"43264","inReplyTo":null,"subject":"doc bug?","fromName":"Han-Wen Nienhuys","fromEmail":"hanwen@xs4all.nl","sentAt":"2006-12-08T17:07:43Z","receivedAt":"2006-12-08T17:07:43Z","isPatch":false,"sender":{"key":"hanwen@google.com","avatar":"https://avatars.githubusercontent.com/u/31547?v=4"},"body":"\nHi,\n\nwhile messing with GIT's build system, I got\n\n**\nasciidoc -b docbook -d manpage -f ../Documentation/asciidoc.conf ../Documentation/git-tools.txt\nERROR: git-tools.txt: line 2: malformed manpage title\nERROR: git-tools.txt: line 6: first section must be named NAME\nERROR: git-tools.txt: line 9: malformed NAME section body\nFAILED: /home/lilydev/vc/git/Documentation/git-tools.txt: line 9: unexpected error:\n------------------------------------------------------------\nTraceback (most recent call last):\n File \"/usr/bin/asciidoc\", line 3639, in asciidoc\n document.translate()\n File \"/usr/bin/asciidoc\", line 966, in translate\n Header.translate()\n File \"/usr/bin/asciidoc\", line 1123, in translate\n attrs['manname'] = string.strip(mo.group('manname'))\nAttributeError: 'NoneType' object has no attribute 'group'\n------------------------------------------------------------\n**\n\nis this a new problem? I'm on FC6, with asciidoc 7.0.2\n\n\n-- \n Han-Wen Nienhuys - hanwen@xs4all.nl - http://www.xs4all.nl/~hanwen\n"},{"id":"297272","messageId":"2c6b72b30612090930o7b856223ub87746181f958b7c@mail.gmail.com","threadId":"43264","inReplyTo":"elc64k$t4i$1@sea.gmane.org","subject":"Re: doc bug?","fromName":"Jonas Fonseca","fromEmail":"jonas.fonseca@gmail.com","sentAt":"2006-12-09T17:30:08Z","receivedAt":"2006-12-09T17:30:08Z","isPatch":false,"sender":{"key":"jonas.fonseca@gmail.com","avatar":"https://gravatar.com/avatar/9b7fa23cce50269e5d164312b6ac5ae818a180f837b38f28f3bdf689dd7f96cd?d=mp&s=160"},"body":"On 12/8/06, Han-Wen Nienhuys wrote:\n> Hi,\n\nHello,\n\n> while messing with GIT's build system, I got\n>\n> **\n> asciidoc -b docbook -d manpage -f ../Documentation/asciidoc.conf ../Documentation/git-tools.txt\n> ERROR: git-tools.txt: line 2: malformed manpage title\n> ERROR: git-tools.txt: line 6: first section must be named NAME\n> ERROR: git-tools.txt: line 9: malformed NAME section body\n> FAILED: /home/lilydev/vc/git/Documentation/git-tools.txt: line 9: unexpected error:\n> [traceback]\n> **\n>\n> is this a new problem? I'm on FC6, with asciidoc 7.0.2\n\nThe git-tools.txt document is not intended to be a man page\n(there is no git-tools command) so it cannot be converted into\na man page. You should be able to make a HTML document\nout of it, although the AsciiDoc formatting is not \"optimal\".\n\n-- \n"},{"id":"298722","messageId":"457AFAB7.907@xs4all.nl","threadId":"43264","inReplyTo":"2c6b72b30612090930o7b856223ub87746181f958b7c@mail.gmail.com","subject":"Re: doc bug?","fromName":"Han-Wen Nienhuys","fromEmail":"hanwen@xs4all.nl","sentAt":"2006-12-09T18:04:39Z","receivedAt":"2006-12-09T18:04:39Z","isPatch":false,"sender":{"key":"hanwen@google.com","avatar":"https://avatars.githubusercontent.com/u/31547?v=4"},"body":"Jonas Fonseca escreveu:\n>> is this a new problem? I'm on FC6, with asciidoc 7.0.2\n> \n> The git-tools.txt document is not intended to be a man page\n\nSo why does the doc try make one for it? This is a bug, no?\n\n-- \n"},{"id":"298114","messageId":"7vslfodi7b.fsf@assigned-by-dhcp.cox.net","threadId":"43264","inReplyTo":"elc64k$t4i$1@sea.gmane.org","subject":"Re: doc bug?","fromName":"Junio C Hamano","fromEmail":"junkio@cox.net","sentAt":"2006-12-09T18:42:32Z","receivedAt":"2006-12-09T18:42:32Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Han-Wen Nienhuys writes:\n\n> while messing with GIT's build system, I got\n>\n> **\n> asciidoc -b docbook -d manpage -f ../Documentation/asciidoc.conf ../Documentation/git-tools.txt\n> ERROR: git-tools.txt: line 2: malformed manpage title\n> ERROR: git-tools.txt: line 6: first section must be named NAME\n> ERROR: git-tools.txt: line 9: malformed NAME section body\n> FAILED: /home/lilydev/vc/git/Documentation/git-tools.txt: line 9: unexpected error:\n\nThat is interesting. git-tools is listed on ARTICLES which is\nexcluded from MAN1_TXT so the Makefile should not even try to\nrun the above commandline that says 'manpage'.\n\nAt least that is what our Makefile intends to do.\n\nSo that means you may have found a bug in our Makefile, or your\nmake (by the way I think we pretty much requires GNU make to\nbuild git), or perhaps both.\n\nBut I do not see an obvious breakage in our Makefile in this\narea...\n\n\n"},{"id":"294180","messageId":"457D6322.2020308@xs4all.nl","threadId":"43264","inReplyTo":"7vslfodi7b.fsf@assigned-by-dhcp.cox.net","subject":"doc bug?","fromName":"Han-Wen Nienhuys","fromEmail":"hanwen@xs4all.nl","sentAt":"2006-12-11T13:54:42Z","receivedAt":"2006-12-11T13:54:42Z","isPatch":false,"sender":{"key":"hanwen@google.com","avatar":"https://avatars.githubusercontent.com/u/31547?v=4"},"body":"Junio C Hamano escreveu:\n>> asciidoc -b docbook -d manpage -f ../Documentation/asciidoc.conf ../Documentation/git-tools.txt\n>> ERROR: git-tools.txt: line 2: malformed manpage title\n>> ERROR: git-tools.txt: line 6: first section must be named NAME\n>> ERROR: git-tools.txt: line 9: malformed NAME section body\n>> FAILED: /home/lilydev/vc/git/Documentation/git-tools.txt: line 9: unexpected error:\n \n> So that means you may have found a bug in our Makefile, or your\n> make (by the way I think we pretty much requires GNU make to\n> build git), or perhaps both.\n\nHi,\n\nit was my bad, caused by me tweaking the Makefiles. I will be posting\nthe last version of my separate builddir patch separately, with\nsupport for the documentation as well. Can you have a look so I know\nwhether it's worth investing any more time in? \n\nUnfortunately, asciidoc doesn't seem to support a --include-path\noption or similar, so I can't get the documentation support to work\ncompletely.\n\n-- \n"}]}