Re: [PATCH v2] docs: fix --commit-list-format related entries
- From
Junio C Hamano <gitster@pobox.com>
- Date
- Mar 26, 2026, 21:10 UTC
- Message-ID
- <xmqqo6kanvpn.fsf@gitster.g>
- In-Reply-To
- <acWbpJTRusOv6bPk@exploit>
Mirko Faina <mroik@delayed.space> writes:
Show 14 quoted lines
> On Thu, Mar 26, 2026 at 01:45:15PM -0700, Junio C Hamano wrote: >> Being verbose is usually a good way to discourage readers from >> reading. > ... >> The use of this command line option implies `--cover-letter`, >> unless explicitly countermanded with `--no-cover-letter`. > > this part in particular is no different than the original text: > > This option implies the use of `--cover-letter` unless > `--no-cover-letter` is given. > > If we want to emphasize that the configuration variable doesn't imply > --cover-letter, we have to add the note on `format.commitListFormat`.
I do not think so.
If we mention a variable, the readers would wonder if the variable has effects. You can explicitly say that that it does *not* have effect, but we are often better of not mentioning what is not relevant.