Re: [PATCH 2/3] Doc: add more detail for git-format-patch
From: Junio C Hamano <hidden>
Date: 2019-08-20 19:01:30
Denton Liu [off-list ref] writes:
Next, while we're at it, surround option arguments with <>. ... [--start-number <n>] [--numbered-files] - [--in-reply-to=Message-Id] [--suffix=.<sfx>] + [--in-reply-to=<Message-Id>] [--suffix=.<sfx>] [--ignore-if-in-upstream] - [--rfc] [--subject-prefix=Subject-Prefix] + [--rfc] [--subject-prefix=<Subject-Prefix>] ... ---in-reply-to=Message-Id:: +--in-reply-to=<Message-Id>::
That is a good change, but if we are making this change while are at it, I think we should fix it to read <message id>. "Message-Id" is a good spelling iff we are talking about the label on the left hand side of colon in e-mail header, but in this context, we are talking about the value to be placed on that header. All the other multi-word placeholders in the SYNOPSIS section spell the words as normal multiple words separated with whitespace in lower case. You'd also want to fix the spelling of Subject-Prefix to <subject prefix> for consistency. Thanks.