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-ASN: AS3215 2.6.0.0/16 X-Spam-Status: No, score=-3.8 required=3.0 tests=AWL,BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from out1.vger.email (out1.vger.email [IPv6:2620:137:e000::1:20]) by dcvr.yhbt.net (Postfix) with ESMTP id 0E8201F51E for ; Fri, 30 Sep 2022 21:40:54 +0000 (UTC) Authentication-Results: dcvr.yhbt.net; dkim=pass (1024-bit key; unprotected) header.d=pobox.com header.i=@pobox.com header.b="aXV3FJs8"; dkim-atps=neutral Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231745AbiI3Vkc (ORCPT ); Fri, 30 Sep 2022 17:40:32 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:45680 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232165AbiI3Vka (ORCPT ); Fri, 30 Sep 2022 17:40:30 -0400 Received: from pb-smtp1.pobox.com (pb-smtp1.pobox.com [64.147.108.70]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id BB811E0064 for ; Fri, 30 Sep 2022 14:40:27 -0700 (PDT) Received: from pb-smtp1.pobox.com (unknown [127.0.0.1]) by pb-smtp1.pobox.com (Postfix) with ESMTP id EC6271451B4; Fri, 30 Sep 2022 17:40:26 -0400 (EDT) (envelope-from junio@pobox.com) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=pobox.com; h=from:to:cc :subject:references:date:in-reply-to:message-id:mime-version :content-type:content-transfer-encoding; s=sasl; bh=vPUUMZugmcek aYcRQY0qflLdT8zmYmem2R5xJ5JENxc=; b=aXV3FJs80JHOd33Odd98AMLi/3Ht 0dzhDY5HvkeN30KX0jgITIwM84jOCD8WEI+ZqAwNOd0L/ovt+utuwRtWqTYSsPHO Mb3YnbQ6RE4bO1NilDacdVYDJ+ev5+eCXY0/iqNZiPBt9uLf7nfQCmYxxTTRVbDb +2ancgg0W5gz/Ls= Received: from pb-smtp1.nyi.icgroup.com (unknown [127.0.0.1]) by pb-smtp1.pobox.com (Postfix) with ESMTP id E29061451B3; Fri, 30 Sep 2022 17:40:26 -0400 (EDT) (envelope-from junio@pobox.com) Received: from pobox.com (unknown [34.83.5.33]) (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 547041451B1; Fri, 30 Sep 2022 17:40:26 -0400 (EDT) (envelope-from junio@pobox.com) From: Junio C Hamano To: =?utf-8?B?w4Z2YXIgQXJuZmrDtnLDsA==?= Bjarmason Cc: git@vger.kernel.org, Victoria Dye , Taylor Blau , Emily Shaffer , Jonathan Nieder , John Cai , Eric Sunshine Subject: Re: [PATCH v3 14/36] doc txt & -h consistency: correct padding around "[]()" References: Date: Fri, 30 Sep 2022 14:40:25 -0700 In-Reply-To: (=?utf-8?B?IsOGdmFyIEFybmZqw7Zyw7A=?= Bjarmason"'s message of "Fri, 30 Sep 2022 20:07:37 +0200") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 X-Pobox-Relay-ID: 7EF0FBE8-4108-11ED-8525-2AEEC5D8090B-77302942!pb-smtp1.pobox.com Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org =C3=86var Arnfj=C3=B6r=C3=B0 Bjarmason writes: > The whitespace padding of alternatives should be of the form "[-f | > --force]" not "[-f|--force]". Likewise we should not have padding > before the first option, so "(--all | ...)" is correct, > not "( --all | ... )". > > Signed-off-by: =C3=86var Arnfj=C3=B6r=C3=B0 Bjarmason > --- > Documentation/git-diff-files.txt | 2 +- > Documentation/git-hash-object.txt | 2 +- > Documentation/git-merge-base.txt | 4 ++-- > Documentation/git-pack-redundant.txt | 2 +- > Documentation/git-prune-packed.txt | 2 +- > Documentation/git-rerere.txt | 2 +- > Documentation/git-send-pack.txt | 2 +- > Documentation/git-show-branch.txt | 4 ++-- > Documentation/git-show-ref.txt | 4 ++-- > Documentation/git-var.txt | 2 +- > Documentation/git-verify-pack.txt | 2 +- > builtin/bugreport.c | 2 +- > builtin/commit-graph.c | 2 +- > builtin/diagnose.c | 2 +- > builtin/sparse-checkout.c | 2 +- > 15 files changed, 18 insertions(+), 18 deletions(-) Consistency is good. And ... > [verse] > -'git pack-redundant' [ --verbose ] [ --alt-odb ] ( --all | ... ) > +'git pack-redundant' [--verbose] [--alt-odb] (--all | .= ..) > =20 > DESCRIPTION > ----------- > diff --git a/Documentation/git-prune-packed.txt b/Documentation/git-pru= ne-packed.txt > index 9fed59a3172..844d6f808a0 100644 > --- a/Documentation/git-prune-packed.txt > +++ b/Documentation/git-prune-packed.txt > @@ -9,7 +9,7 @@ git-prune-packed - Remove extra objects that are alread= y in pack files > SYNOPSIS > -------- > [verse] > -'git prune-packed' [-n|--dry-run] [-q|--quiet] > +'git prune-packed' [-n | --dry-run] [-q | --quiet] ... these show that they are easier to read with the proposed spacing.