# doc bug? 5 messages from 2006-12-08 to 2006-12-11. Participants: Han-Wen Nienhuys, Jonas Fonseca, Junio C Hamano. Thread: https://gitlist.dev/t/43264 ## Han-Wen Nienhuys, 2006-12-08 17:07 Subject: doc bug? Message-ID: URL: https://gitlist.dev/e/elc64k%24t4i%241%40sea.gmane.org ``` Hi, while messing with GIT's build system, I got ** asciidoc -b docbook -d manpage -f ../Documentation/asciidoc.conf ../Documentation/git-tools.txt ERROR: git-tools.txt: line 2: malformed manpage title ERROR: git-tools.txt: line 6: first section must be named NAME ERROR: git-tools.txt: line 9: malformed NAME section body FAILED: /home/lilydev/vc/git/Documentation/git-tools.txt: line 9: unexpected error: ------------------------------------------------------------ Traceback (most recent call last): File "/usr/bin/asciidoc", line 3639, in asciidoc document.translate() File "/usr/bin/asciidoc", line 966, in translate Header.translate() File "/usr/bin/asciidoc", line 1123, in translate attrs['manname'] = string.strip(mo.group('manname')) AttributeError: 'NoneType' object has no attribute 'group' ------------------------------------------------------------ ** is this a new problem? I'm on FC6, with asciidoc 7.0.2 -- Han-Wen Nienhuys - hanwen@xs4all.nl - http://www.xs4all.nl/~hanwen ``` ## Jonas Fonseca, 2006-12-09 17:30 Subject: Re: doc bug? Message-ID: <2c6b72b30612090930o7b856223ub87746181f958b7c@mail.gmail.com> URL: https://gitlist.dev/e/2c6b72b30612090930o7b856223ub87746181f958b7c%40mail.gmail.com In-Reply-To: ``` On 12/8/06, Han-Wen Nienhuys wrote: > Hi, Hello, > while messing with GIT's build system, I got > > ** > asciidoc -b docbook -d manpage -f ../Documentation/asciidoc.conf ../Documentation/git-tools.txt > ERROR: git-tools.txt: line 2: malformed manpage title > ERROR: git-tools.txt: line 6: first section must be named NAME > ERROR: git-tools.txt: line 9: malformed NAME section body > FAILED: /home/lilydev/vc/git/Documentation/git-tools.txt: line 9: unexpected error: > [traceback] > ** > > is this a new problem? I'm on FC6, with asciidoc 7.0.2 The git-tools.txt document is not intended to be a man page (there is no git-tools command) so it cannot be converted into a man page. You should be able to make a HTML document out of it, although the AsciiDoc formatting is not "optimal". -- ``` ## Han-Wen Nienhuys, 2006-12-09 18:04 Subject: Re: doc bug? Message-ID: <457AFAB7.907@xs4all.nl> URL: https://gitlist.dev/e/457AFAB7.907%40xs4all.nl In-Reply-To: <2c6b72b30612090930o7b856223ub87746181f958b7c@mail.gmail.com> ``` Jonas Fonseca escreveu: >> is this a new problem? I'm on FC6, with asciidoc 7.0.2 > > The git-tools.txt document is not intended to be a man page So why does the doc try make one for it? This is a bug, no? -- ``` ## Junio C Hamano, 2006-12-09 18:42 Subject: Re: doc bug? Message-ID: <7vslfodi7b.fsf@assigned-by-dhcp.cox.net> URL: https://gitlist.dev/e/7vslfodi7b.fsf%40assigned-by-dhcp.cox.net In-Reply-To: ``` Han-Wen Nienhuys writes: > while messing with GIT's build system, I got > > ** > asciidoc -b docbook -d manpage -f ../Documentation/asciidoc.conf ../Documentation/git-tools.txt > ERROR: git-tools.txt: line 2: malformed manpage title > ERROR: git-tools.txt: line 6: first section must be named NAME > ERROR: git-tools.txt: line 9: malformed NAME section body > FAILED: /home/lilydev/vc/git/Documentation/git-tools.txt: line 9: unexpected error: That is interesting. git-tools is listed on ARTICLES which is excluded from MAN1_TXT so the Makefile should not even try to run the above commandline that says 'manpage'. At least that is what our Makefile intends to do. So that means you may have found a bug in our Makefile, or your make (by the way I think we pretty much requires GNU make to build git), or perhaps both. But I do not see an obvious breakage in our Makefile in this area... ``` ## Han-Wen Nienhuys, 2006-12-11 13:54 Subject: doc bug? Message-ID: <457D6322.2020308@xs4all.nl> URL: https://gitlist.dev/e/457D6322.2020308%40xs4all.nl In-Reply-To: <7vslfodi7b.fsf@assigned-by-dhcp.cox.net> ``` Junio C Hamano escreveu: >> asciidoc -b docbook -d manpage -f ../Documentation/asciidoc.conf ../Documentation/git-tools.txt >> ERROR: git-tools.txt: line 2: malformed manpage title >> ERROR: git-tools.txt: line 6: first section must be named NAME >> ERROR: git-tools.txt: line 9: malformed NAME section body >> FAILED: /home/lilydev/vc/git/Documentation/git-tools.txt: line 9: unexpected error: > So that means you may have found a bug in our Makefile, or your > make (by the way I think we pretty much requires GNU make to > build git), or perhaps both. Hi, it was my bad, caused by me tweaking the Makefiles. I will be posting the last version of my separate builddir patch separately, with support for the documentation as well. Can you have a look so I know whether it's worth investing any more time in? Unfortunately, asciidoc doesn't seem to support a --include-path option or similar, so I can't get the documentation support to work completely. -- ```