From: Junio C Hamano <gitster@pobox.com>
Date: Mon, 28 Oct 2019 01:24:31 GMT
Subject: Re: [PATCH 1/3] myfirstcontrib: add 'psuh' to command-list.txt
Message-ID: <xmqqmudlbr1s.fsf@gitster-ct.c.googlers.com>
In-Reply-To: <20191026080057.GP4348@szeder.dev>

SZEDER Gábor <szeder.dev@gmail.com> writes:

> See that last "no link: git-bisect" line?  That's what happened to
> catch my eyes when Derrick forgot to add his new 'sparse-checkout'
> builtin to 'command-list.txt'.  I still haven't looked up what that
> 'no link' is supposed to mean, but if it were an error, then we would

Build procedure for the Documentation uses ../command-list.txt as
its input to produce cmds-<class>.txt files, that are included in
git.txt (hence resulting git.1 and git.html).  While it works, it
tries to make sure that a command that has its own documentation
page at Documentation/git-<command>.txt is listed; otherwise we have
a page for <command> to which there is no link from git.{1,html}.

I think "make check-builtins" might also want to sanity check
command-list.txt.