doc/send-email: mention handling of "reply-to" with --compose
commite0c7e2c3261fa49f9c99638fb2adf526e3833927
authorJeff King <peff@peff.net>
Fri, 20 Oct 2023 10:09:01 +0000 (20 06:09 -0400)
committerJunio C Hamano <gitster@pobox.com>
Fri, 20 Oct 2023 21:31:30 +0000 (20 14:31 -0700)
treed1833fc43734e07c50c9e88182cf75b5f6878759
parent43c8a30d150ecede9709c1f2527c8fba92c65f40
doc/send-email: mention handling of "reply-to" with --compose

The documentation for git-send-email lists the headers handled specially
by --compose in a way that implies that this is the complete set of
headers that are special. But one more was added by d11c943c78
(send-email: support separate Reply-To address, 2018-03-04) and never
documented.

Let's add it, and reword the documentation slightly to avoid having to
specify the list of headers twice (as it is growing and will continue to
do so as we add new features).

If you read the code, you may notice that we also handle MIME-Version
specially, in that we'll avoid over-writing user-provided MIME headers.
I don't think this is worth mentioning, as it's what you'd expect to
happen (as opposed to the other headers, which are picked up to be used
in later emails). And certainly this feature existed when the
documentation was expanded in 01d3861217 (git-send-email.txt: describe
--compose better, 2009-03-16), and we chose not to mention it then.

Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-send-email.txt