From: Junio C Hamano <gitster@pobox.com>
To: Alex Henrie <alexhenrie24@gmail.com>
Cc: Paul Tan <pyokagan@gmail.com>, Git mailing list <git@vger.kernel.org>
Subject: Re: [PATCH] pull: add angle brackets to usage string
Date: Tue, 20 Oct 2015 11:18:19 -0700 [thread overview]
Message-ID: <xmqqeggp8kus.fsf@gitster.mtv.corp.google.com> (raw)
In-Reply-To: <CAMMLpeStjJY2sqGvC0wV_OqFSA3OuzmcDitvr53d=z8+y2dBYA@mail.gmail.com> (Alex Henrie's message of "Tue, 20 Oct 2015 10:54:20 -0600")
Alex Henrie <alexhenrie24@gmail.com> writes:
> I pushed to change [options] to [<options>] because even if the angle
> brackets don't help new users or translators in this particular case,
> the angle brackets encourage Git authors to use angle brackets when
> writing commands that are not so easy to understand. If you think that
> [<option>...] is better because it is even more consistent, I would be
> happy to send a patch to make that change.
I do agree that [<option>...] would make things consistent between
options and non-option arguments. But I also would expect that
reasonably intelligent readers know that options are special, and
they would understand that [options] and [<options>] mean the same
thing as [<option>...] anyway, so I do not feel too strongly either
way myself (meaning: I wouldn't be motivated to prepare patches for
it myself, I wouldn't jump up and down saying they are wrong and
revert them if such patches were applied by an interim maintainer
while I am on vacation, and I would apply such patches myself only
if they do not overly interfere with topics in flight while
merging).
Thanks.
next prev parent reply other threads:[~2015-10-20 18:18 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-10-16 2:22 [PATCH] pull: add angle brackets to usage string Alex Henrie
2015-10-16 16:36 ` Junio C Hamano
2015-10-16 16:42 ` Alex Henrie
2015-10-16 17:42 ` Junio C Hamano
2015-10-19 17:27 ` Alex Henrie
2015-10-20 5:17 ` Junio C Hamano
2015-10-20 16:54 ` Alex Henrie
2015-10-20 18:18 ` Junio C Hamano [this message]
2015-10-16 17:24 ` Ralf Thielow
2015-10-16 17:46 ` Junio C Hamano
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=xmqqeggp8kus.fsf@gitster.mtv.corp.google.com \
--to=gitster@pobox.com \
--cc=alexhenrie24@gmail.com \
--cc=git@vger.kernel.org \
--cc=pyokagan@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.