Denton Liu <liu.denton@xxxxxxxxx> 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.