Re: [PATCH] Rearrange git-format-patch synopsis to improve clarity.

From: Jon Loeliger <jdl@freescale.com>
Date: Nov 6, 2007, 15:01 UTC
Message-ID: <473081C2.7060106@freescale.com>
In-Reply-To: <ee77f5c20711051432w284cf22dx71192c145d25dced@mail.gmail.com>

David Symonds wrote:

Show 14 quoted lines

> On 11/5/07, David Symonds <dsymonds@gmail.com> wrote:
>>                     [-s | --signoff] [<common diff options>]
>> -                   [--start-number <n>] [--numbered-files]
>> +                   [-n | --numbered-files | -N | --no-numbered]
>> +                   [--start-number <n>]
> 
> Now that I look at it again, it seems the long options look quite
> inconsistent. I think it should be either
> --numbered-files/--no-numbered-files or --numbered/--no-numbered. My
> preference is with the latter (for brevity), but that breaks
> backward-compatibility.
> 
> Would you accept a patch that changed --numbered-files to --numbered,
> and kept the former as a synonym?

There are two forms of numbered file output names: the traditional "0001-Foo-the-bar" and just "1" styles. Please don't break that. Both are needed.

Thanks, jdl