On Mon, Aug 19, 2019 at 7:53 PM Denton Liu <liu.denton@xxxxxxxxx> wrote: > diff --git a/Documentation/config/format.txt b/Documentation/config/format.txt > @@ -74,7 +74,8 @@ format.signOff:: > format.coverLetter:: > - A boolean that controls whether to generate a cover-letter when > + A boolean which lets you enable the `--cover-letter` option by > + default when > format-patch is invoked, but in addition can be set to "auto", to > generate a cover-letter only when there's more than one patch. Rather than rewriting like this, I think it's more common in Git documentation to mention the default as the last sentence in the paragraph. For instance: ... when there's more than one patch. Default is true.