On Sat, Aug 31, 2013 at 12:46 AM, René Scharfe <l....@web.de> wrote:
> Am 29.08.2013 22:36, schrieb Felipe Contreras:
>> On Thu, Aug 29, 2013 at 3:03 PM, René Scharfe <l....@web.de> wrote:
>>> If you have a --work-tree option then parseopt accepts --work as well,
>>> unless it's ambiguous, i.e. another option starts with --work, too. So
>>> can have a descriptive, extra-long option and type just a few characters
>>> the same time.
>> Right, but what do we use in the documentation? Writing --work-tree in
>> the 'git reset' table for example would be rather ugly. I'm fine with
>> --work-tree, but I think it would be weird to have short-hands in the
>> documentation, although not entirely bad.
> I don't see what's so ugly about it.
> The git command itself has a --work-tree parameter for specifying the
> location of the checked-out files, however. It could be confusing to have
> the same parameter do different things:
> $ git reset --work-tree=/some/where reset --work-tree
> Perhaps a note in the documentation is enough to clear this up.
I agree that this is confusing for people not deeply versed in Git jargon.
We also know that no one reads documentation.
Maybe a better word can be found? How about "git reset --files"?
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majord...@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html