git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] git config: clarify bool types

From
Felipe Contreras <felipe.contreras@gmail.com>
Date
May 6, 2009, 23:07 UTC
Message-ID
<94a0d4530905061607s14c700e5t4b87166772c75622@mail.gmail.com>
In-Reply-To
<7vk56nocpg.fsf@gitster.siamese.dyndns.org>
On Wed, Mar 18, 2009 at 4:13 AM, Junio C Hamano <gitster@pobox.com> wrote:
Show 34 quoted lines
> Felipe Contreras <felipe.contreras@gmail.com> writes:
>
>> The value is what it is, the --bool and --bool-or-int options don't
>> specify the value type, just how it is interpreted. For example: a value
>> of '1' can be interpreted as 'true'.
>>
>> Signed-off-by: Felipe Contreras <felipe.contreras@gmail.com>
>> ---
>>
>> This applies on top of the 'next' branch.
>>
>>  builtin-config.c |    4 ++--
>>  1 files changed, 2 insertions(+), 2 deletions(-)
>>
>> diff --git a/builtin-config.c b/builtin-config.c
>> index 1a3baa1..c3a0176 100644
>> --- a/builtin-config.c
>> +++ b/builtin-config.c
>> @@ -66,9 +66,9 @@ static struct option builtin_config_options[] = {
>>       OPT_STRING(0, "get-color", &get_color_slot, "slot", "find the color configured: [default]"),
>>       OPT_STRING(0, "get-colorbool", &get_colorbool_slot, "slot", "find the color setting: [stdout-is-tty]"),
>>       OPT_GROUP("Type"),
>> -     OPT_BIT(0, "bool", &types, "value is \"true\" or \"false\"", TYPE_BOOL),
>> +     OPT_BIT(0, "bool", &types, "value is intepreted as bool (\"true\" or \"false\")", TYPE_BOOL),
>
> I'd rater see it say something like:
>
>        Output the value as boolean (true or false)
>
> so that it is consistent with others you can see in the context.
> E.g. get-color explains it to order the command to "find the color".
>
> "Interpret" is fine too.  The point is not about the choice of verb but
> use of imperative mood.

-bool is not only used to output values, it's also used to set them, so it's not related to an action, it's an action modifier, so I don't think it must be imperative.

I'm going to resend this patch as is.
-- 
Felipe Contreras
Previous: Junio C Hamano
Message 3 of 3 in “git config: clarify bool types”
  1. git config: clarify bool typesFelipe Contreras, Mar 17, 2009
  2. Junio C HamanoMar 18, 2009
  3. Felipe ContrerasMay 6, 2009

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.