git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: doc bug?

From
Junio C Hamano <junkio@cox.net>
Date
Dec 9, 2006, 18:42 UTC
Message-ID
<7vslfodi7b.fsf@assigned-by-dhcp.cox.net>
In-Reply-To
<elc64k$t4i$1@sea.gmane.org>
Han-Wen Nienhuys <hanwen@xs4all.nl> writes:
Show 8 quoted lines
> 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...

Previous: Han-Wen NienhuysNext: Han-Wen Nienhuys
Message 4 of 5 in “doc bug?”
  1. Han-Wen NienhuysDec 8, 2006
  2. Jonas FonsecaDec 9, 2006
  3. Han-Wen NienhuysDec 9, 2006
  4. Junio C HamanoDec 9, 2006
  5. Han-Wen NienhuysDec 11, 2006

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.