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=-3.9 required=3.0 tests=AWL,BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,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 EBC991F9FC for ; Sun, 28 Mar 2021 18:33:50 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231214AbhC1SdP (ORCPT ); Sun, 28 Mar 2021 14:33:15 -0400 Received: from pb-smtp1.pobox.com ([64.147.108.70]:51526 "EHLO pb-smtp1.pobox.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230144AbhC1Sco (ORCPT ); Sun, 28 Mar 2021 14:32:44 -0400 Received: from pb-smtp1.pobox.com (unknown [127.0.0.1]) by pb-smtp1.pobox.com (Postfix) with ESMTP id CD346BD027; Sun, 28 Mar 2021 14:32:43 -0400 (EDT) (envelope-from junio@pobox.com) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=pobox.com; h=from:to:cc :subject:references:date:in-reply-to:message-id:mime-version :content-type; s=sasl; bh=vaXSWudOzPfr99g83Mn5ZGPygVM=; b=dhX+ei S8gihNYphGcoxa/c8CdQLwJUuWAxZH/w79LMKbFqWsYzG2AxmhNHt6wDvJkyi6KL SGLlgFmK8Gi14Ku/JdsSlKvPIyhlwNENOoymW4ipA1hpesetci0hDakQs5WphGb7 0GE0LeoSsj3+Geyyz1OkZZuEAALcWsM+ylCrI= DomainKey-Signature: a=rsa-sha1; c=nofws; d=pobox.com; h=from:to:cc :subject:references:date:in-reply-to:message-id:mime-version :content-type; q=dns; s=sasl; b=XlsvV2CmGXew7mhuffK58+ZssKaZ2kiK VHZgD9+Z3z9WwCyz5nirK6lCmVGDe6uNuStzZSdNBiYZNunZAPlltaGg2Ts1efLY qgEpfK1td1LsuYcPegl6QbwdGfTmewgBSMQtsbJhgsqjjZy5TQGtp0PSAwOpgGsu dkXNRkhY1oQ= Received: from pb-smtp1.nyi.icgroup.com (unknown [127.0.0.1]) by pb-smtp1.pobox.com (Postfix) with ESMTP id C4CCBBD026; Sun, 28 Mar 2021 14:32:43 -0400 (EDT) (envelope-from junio@pobox.com) Received: from pobox.com (unknown [34.74.119.39]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by pb-smtp1.pobox.com (Postfix) with ESMTPSA id 56BAEBD025; Sun, 28 Mar 2021 14:32:43 -0400 (EDT) (envelope-from junio@pobox.com) From: Junio C Hamano To: Bagas Sanjaya Cc: Chinmoy via GitGitGadget , Chinmoy , git@vger.kernel.org Subject: Re: [PATCH] Documentation: amended usages of various (sub)commands References: Date: Sun, 28 Mar 2021 11:32:42 -0700 In-Reply-To: (Bagas Sanjaya's message of "Sun, 28 Mar 2021 15:13:54 +0700") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1.90 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Pobox-Relay-ID: FC109EA2-8FF3-11EB-A100-D152C8D8090B-77302942!pb-smtp1.pobox.com Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Bagas Sanjaya writes: >>> ... >> Wait, I expected that this patch touches Documentation/* (as the title implied), >> but it seems like the patch content is something else (not related). >> Totally wrong patch submitted here. Please learn to trim your quotes. > Oops, I don't see that diff above. Sorry for that. > > What about this patch title below?: > > `Make (sub)command options conform to TD of option parsing` "Make X conform" has low information contents (especially when nobody knows what the TD is), because nobody would try to make the code worse by making things nonconforming. Subject: [PATCH] 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. Downcase the first word of some option descriptions for "column" and "range-diff". or something like that? Even though the guideline for the documentation talks about two things (i.e. not starting with capital and omitting full-stop at the end), the help strings being touched by the patch only have problem with the former, so quoting the guideline in full would not help people understand what is changed and why.