From: Junio C Hamano <gitster@pobox.com>
To: Stefan Beller <sbeller@google.com>
Cc: Alangi Derick <alangiderick@gmail.com>,
"git\@vger.kernel.org" <git@vger.kernel.org>
Subject: Re: Patch that modifies git usage message
Date: Fri, 01 May 2015 09:29:50 -0700 [thread overview]
Message-ID: <xmqqfv7gxnup.fsf@gitster.dls.corp.google.com> (raw)
In-Reply-To: <CAGZ79kY1ZoYrVwVVqfyB+uMGsJo59qDxbDLgyo5qygSm=CUVhA@mail.gmail.com> (Stefan Beller's message of "Fri, 1 May 2015 08:51:07 -0700")
Stefan Beller <sbeller@google.com> writes:
> For the patch itself:
>
> $ grep -r usage *.c builtin/*.c |wc -l
> 551
> $ grep -r Usage *.c builtin/*.c |wc -l
> 3
>
> The community agreed (maybe subconciously) to prefer lower case
> for the 'usage' string, so I don't think this is an improvement.
I tend to agree with the conclusion, but you need to be a bit
careful here. These catch all the variable names that contain
"[uU]sage" as substring, but we do not spell in-code variables
with camelCase, so the former probably is over-counting. Things
like "static const char usage[] = ..." are counted; so are calls
to usage_with_options().
If you look for the beginning of a string constant, you would get
this:
$ git grep '"usage' -- \*.c builtin/\*.c
12
$ git grep '"Usage' -- \*.c builtin/\*.c
0
The former undercounts the messages because many usage messages are
produced by calling usage_with_options() these days.
The latter being zero made me scratch my head and do this:
$ git grep Usage -- \*.c builtin/\*.c
commit.c: * Usage example:
test-hashmap.c: * Usage: time echo "perfhas...
I cannot find the third one you found for "Usage" in your example,
though.
next prev parent reply other threads:[~2015-05-01 16:30 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-05-01 11:01 Patch that modifies git usage message Alangi Derick
2015-05-01 15:51 ` Stefan Beller
2015-05-01 15:54 ` Alangi Derick
2015-05-01 16:29 ` Junio C Hamano [this message]
2015-05-01 16:38 ` Alangi Derick
2015-05-01 16:55 ` Stefan Beller
2015-05-01 17:40 ` Eric Sunshine
2015-05-01 17:49 ` Alangi Derick
2015-05-01 18:01 ` Eric Sunshine
2015-05-01 16:55 ` Stefan Beller
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=xmqqfv7gxnup.fsf@gitster.dls.corp.google.com \
--to=gitster@pobox.com \
--cc=alangiderick@gmail.com \
--cc=git@vger.kernel.org \
--cc=sbeller@google.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.