From: Junio C Hamano Date: Thu, 26 Mar 2026 21:10:12 GMT Subject: Re: [PATCH v2] docs: fix --commit-list-format related entries Message-ID: In-Reply-To: Mirko Faina writes: > 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.