From: Junio C Hamano <gitster@pobox.com>
Date: Thu, 13 Oct 2022 16:33:44 GMT
Subject: Re: [PATCH v5 00/34] doc/UX: make txt & -h output more consistent
Message-ID: <xmqqpmevhedz.fsf@gitster.g>
In-Reply-To: <cover-v5-00.34-00000000000-20221013T153625Z-avarab@gmail.com>

Ævar Arnfjörð Bjarmason  <avarab@gmail.com> writes:

> We are currently wildly inconsistent in whether the SYNOPSIS in the
> manual page matches the first line of the -h output, and as we add new
> options we routinely forget to add them to one or the other (or both).
>
> Without a more complex approach it's hard to do something about the
> "or both" case. But we can rather easily test whether the -h output
> matches the *.txt version, and report differences.

Nice.