From: Junio C Hamano <gitster@pobox.com>
Date: Fri, 24 Sep 2021 20:03:00 GMT
Subject: Re: [PATCH v5 3/3] send-email docs: add format-patch options
Message-ID: <xmqqo88hspvv.fsf@gitster.g>
In-Reply-To: <CAPUEspiSh91a8MvhqhKm=DAn5_u-HoRBuL6-gBRMUtSshqpf=g@mail.gmail.com>

Carlo Arenas <carenas@gmail.com> writes:

>> Or do you mean
>>
>>         git send-email <options>
>>
>> and have the <options> placeholder to stand for both send-email
>> options and options meant for format-patch?
>
> the later AND including a non optional part that explains that you
> need to indicate some sort of revision ...

Ah, thanks for explanation.

    git format-patch -2

would be options-only way to "indicate some sort of revision", so
perhaps 

    . git send-email <send-email options> files|directory
    . git send-email <send-email options> <format-patch options>

(where "options" is used to refer to both --options and arguments)
would illustrate the differences better?