From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-Status: No, score=-4.0 required=3.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,NICE_REPLY_A, RCVD_IN_DNSWL_HI,SPF_HELO_PASS,SPF_PASS shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by dcvr.yhbt.net (Postfix) with ESMTP id E34F31F5AF for ; Mon, 29 Mar 2021 13:47:53 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231809AbhC2NrJ (ORCPT ); Mon, 29 Mar 2021 09:47:09 -0400 Received: from smtp.hosts.co.uk ([85.233.160.19]:14141 "EHLO smtp.hosts.co.uk" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231546AbhC2Nqp (ORCPT ); Mon, 29 Mar 2021 09:46:45 -0400 Received: from host-92-1-139-132.as43234.net ([92.1.139.132] helo=[192.168.1.37]) by smtp.hosts.co.uk with esmtpa (Exim) (envelope-from ) id 1lQsDu-0001ZE-G2; Mon, 29 Mar 2021 14:46:43 +0100 Subject: Re: [PATCH v3] column, range-diff: downcase option description To: Chinmoy via GitGitGadget , git@vger.kernel.org Cc: Bagas Sanjaya , Chinmoy References: From: Philip Oakley Message-ID: Date: Mon, 29 Mar 2021 14:46:29 +0100 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.9.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Content-Language: en-GB Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Super minor nit - missing space after full stop. On 29/03/2021 11:45, Chinmoy via GitGitGadget wrote: > From: Chinmoy Chakraborty > > It is customary not to begin the help text for each option given to > the parse-options API with a capital letter.Various (sub)commands' s/Various/ Various/ -- Philip > option arrays don't follow the guideline provided by the parse_options > Documentation regarding the descriptions. > > Downcase the first word of some option descriptions for "column" > and "range-diff". > > Signed-off-by: Chinmoy Chakraborty > --- > column, range-diff: downcase option description > > It is customary not to begin the help text for each option given to the > parse-options API with a capital letter.Various (sub)commands' option > arrays don't follow the guideline provided by the parse_options > Documentation regarding the descriptions. > > Downcase the first word of some option descriptions for "column" and > "range-diff". > > Signed-off-by: Chinmoy Chakraborty chinmoy12c@gmail.com > > Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-920%2Fchinmoy12c%2Fissue_636-v3 > Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-920/chinmoy12c/issue_636-v3 > Pull-Request: https://github.com/gitgitgadget/git/pull/920 > > Range-diff vs v2: > > 1: b032c2fa5b28 ! 1: 61be08b7dd73 Documentation: make (sub)command options conform to TD of option parsing > @@ Metadata > Author: Chinmoy Chakraborty > > ## Commit message ## > - Documentation: make (sub)command options conform to TD of option parsing > + column, range-diff: downcase option description > > - The Git suite option parsing API's Technical Documentation suggests this > - about the option descriptions of a (sub)command: > + It is customary not to begin the help text for each option given to > + the parse-options API with a capital letter.Various (sub)commands' > + option arrays don't follow the guideline provided by the parse_options > + Documentation regarding the descriptions. > > - `description` is a short string to describe the effect of the option. > - It shall begin with a lower-case letter and a full stop (.) shall be > - omitted at the end. > - > - Various (sub)commands' option arrays don't follow the guideline provided > - by the parse_options Documentation regarding the descriptions. > + Downcase the first word of some option descriptions for "column" > + and "range-diff". > > Signed-off-by: Chinmoy Chakraborty > > > > builtin/column.c | 8 ++++---- > builtin/range-diff.c | 2 +- > 2 files changed, 5 insertions(+), 5 deletions(-) > > diff --git a/builtin/column.c b/builtin/column.c > index e815e148aa18..40d4b3bee2dd 100644 > --- a/builtin/column.c > +++ b/builtin/column.c > @@ -27,10 +27,10 @@ int cmd_column(int argc, const char **argv, const char *prefix) > OPT_STRING(0, "command", &real_command, N_("name"), N_("lookup config vars")), > OPT_COLUMN(0, "mode", &colopts, N_("layout to use")), > OPT_INTEGER(0, "raw-mode", &colopts, N_("layout to use")), > - OPT_INTEGER(0, "width", &copts.width, N_("Maximum width")), > - OPT_STRING(0, "indent", &copts.indent, N_("string"), N_("Padding space on left border")), > - OPT_INTEGER(0, "nl", &copts.nl, N_("Padding space on right border")), > - OPT_INTEGER(0, "padding", &copts.padding, N_("Padding space between columns")), > + OPT_INTEGER(0, "width", &copts.width, N_("maximum width")), > + OPT_STRING(0, "indent", &copts.indent, N_("string"), N_("padding space on left border")), > + OPT_INTEGER(0, "nl", &copts.nl, N_("padding space on right border")), > + OPT_INTEGER(0, "padding", &copts.padding, N_("padding space between columns")), > OPT_END() > }; > > diff --git a/builtin/range-diff.c b/builtin/range-diff.c > index 78bc9fa77062..50318849d657 100644 > --- a/builtin/range-diff.c > +++ b/builtin/range-diff.c > @@ -25,7 +25,7 @@ int cmd_range_diff(int argc, const char **argv, const char *prefix) > struct option range_diff_options[] = { > OPT_INTEGER(0, "creation-factor", > &range_diff_opts.creation_factor, > - N_("Percentage by which creation is weighted")), > + N_("percentage by which creation is weighted")), > OPT_BOOL(0, "no-dual-color", &simple_color, > N_("use simple diff colors")), > OPT_PASSTHRU_ARGV(0, "notes", &other_arg, > > base-commit: 84d06cdc06389ae7c462434cb7b1db0980f63860