Re: [PATCH 2/2] git-worktree.txt: add missing `-v` to synopsis for `worktree list`
- From
Junio C Hamano <gitster@pobox.com>
- Date
- Dec 6, 2021, 17:53 UTC
- Message-ID
- <xmqqh7blhb6r.fsf@gitster.g>
- In-Reply-To
- <211206.86bl1trbdp.gmgdl@evledraar.gmail.com>
Ævar Arnfjörð Bjarmason <avarab@gmail.com> writes:
Show 10 quoted lines
>> Taking this point into consideration, a middle-ground alternative to >> Ævar's idea would be to add tooling which only compares (by some >> definition of "compare") the output of `git blah -h` with the synopsis >> in `git-blah.txt` and complains if there are significant differences >> (by some definition "significant" and "difference"). It doesn't >> automate-away the work of keeping the synopsis up-to-date, but at >> least would flag inconsistencies. > > Or we could do the reverse and move the source code version of it to be > generated from the [verse] sections in the documentation.
Either would be far more preferrable than committing generated files, or committing us to work on unreadable sources.
Thanks.