From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id B2D55C77B75 for ; Fri, 19 May 2023 03:52:33 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229579AbjESDwc (ORCPT ); Thu, 18 May 2023 23:52:32 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39060 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229452AbjESDwa (ORCPT ); Thu, 18 May 2023 23:52:30 -0400 Received: from mail-yb1-xb2c.google.com (mail-yb1-xb2c.google.com [IPv6:2607:f8b0:4864:20::b2c]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 472071A7 for ; Thu, 18 May 2023 20:52:29 -0700 (PDT) Received: by mail-yb1-xb2c.google.com with SMTP id 3f1490d57ef6-ba81e7269a2so402138276.1 for ; Thu, 18 May 2023 20:52:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1684468348; x=1687060348; h=content-transfer-encoding:mime-version:message-id:in-reply-to:date :subject:cc:to:from:user-agent:references:from:to:cc:subject:date :message-id:reply-to; bh=xqwOdCIkmKE3hix3aAuLeCIEQ7EyMeAoX+/DvrJqeDM=; b=Oc4z7OSgO7PBoA0A7Uy8gVu7kYMM80eGree2kBOceOZyqAHJA9ZblJUcl2LS5tg8/m ZpwHAgFlOoPEEWz0Tw5tRAi5tY7jnpXQE5TGF8B5bJpCYzPoSyK+EoOOloybqEudN9MD 4oEvqC5wZNYxrov0uT4PaGwRLEqk/vKedw/wRb/1VxJiV4V5Nc6LStt0Nk7WlyDI1Ewo qZlhdpL78xwdLp6ycJ0P6QRX+qkdmnBCVduOMIzk3LhabRE12b5JNyDpI1bO7Rzzg3oj a5pmNvxGX8siODgLF02cYD9HODQ5YngFixMbwNOCoqRW0tH6+7ciqBc16LdI291jN4No Q0ZQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1684468348; x=1687060348; h=content-transfer-encoding:mime-version:message-id:in-reply-to:date :subject:cc:to:from:user-agent:references:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=xqwOdCIkmKE3hix3aAuLeCIEQ7EyMeAoX+/DvrJqeDM=; b=MafsINCetc2744GoIMpv2e/BsFysjgaPmPDjphUdisZwMyQ+kpZhjY51eP9melYT1Y LJDd2L1sKp7s7WrGQGS+seixa0dmUglYtC7vKaZNjQjSnHXUzvhub1BNu32JrXh8cWyq Axgy0UtUDjC+TOdTMX+IOjelk2EcrpWyXaGtADXhfFiMsVO7ml261rMV2rUFT38OUJ/K /JUjPuTQIv+kvkuy1bgNGUwppChcSk44NOj/XCtxx4nfTkuPsZvYopvZg59Xyroge6T9 19/qk86RUhf1veljtL4ZnRR6CVURAEhMUw9Ohvht4rUaOmqZoi0xEuBpzAVaRVQdK3Si LLkw== X-Gm-Message-State: AC+VfDwtr1jPLD/+X4RFbsjatWsUlmNMsAl/2DPeRsCxeJuC15ZtuUw3 Us1SYJgNpH/uagWwsWyQQKY= X-Google-Smtp-Source: ACHHUZ6PGAV9ZJphZFgP9Ly92FasLQgcGD2SSgMd/PZ01/kD0TLP8pgQLn1oiztq77r3d0rkcnUWqw== X-Received: by 2002:a81:9b45:0:b0:560:db2b:bc7e with SMTP id s66-20020a819b45000000b00560db2bbc7emr735032ywg.3.1684468348330; Thu, 18 May 2023 20:52:28 -0700 (PDT) Received: from epic96565.epic.com ([2620:72:0:6480::10f]) by smtp.gmail.com with ESMTPSA id m203-20020a8171d4000000b00560df23d30csm875370ywc.117.2023.05.18.20.52.27 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 18 May 2023 20:52:27 -0700 (PDT) References: User-agent: mu4e 1.11.1; emacs 29.0.91 From: Sean Allred To: Junio C Hamano Cc: Eric Sunshine , Sean Allred via GitGitGadget , git@vger.kernel.org, Sean Allred Subject: Re: [PATCH v3 1/6] show-ref doc: update for internal consistency Date: Thu, 18 May 2023 22:51:36 -0500 In-reply-to: Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Junio C Hamano writes: > Eric Sunshine writes: > >> On Mon, May 15, 2023 at 8:13=E2=80=AFAM Sean Allred via GitGitGadget >> wrote: >>> - Use inline-code syntax for options where appropriate. >>> - Use code blocks to clarify output format. >>> >>> This patch also swaps out 'SHA-1' language for the implementation- >>> agnostic 'OID' term where appropriate in preparation for supporting >>> different hashing algorithms. >>> >>> Signed-off-by: Sean Allred >>> --- >>> diff --git a/Documentation/git-show-ref.txt b/Documentation/git-show-re= f.txt >>> @@ -96,7 +96,13 @@ OPTIONS >>> -The output is in the format: '' '' ''. >>> +The output is in the format: >>> + >>> +------------ >>> + SP LF >>> +------------ >>> $ git show-ref --head --dereference >>> @@ -110,7 +116,13 @@ $ git show-ref --head --dereference >>> -When using --hash (and not --dereference) the output format is: '' >>> +When using `--hash` (and not `--dereference`), the output is in the fo= rmat: >>> + >>> +------------ >>> + LF >>> +------------ >>> $ git show-ref --heads --hash >> >> Is the difference in case ("" vs. "") intentional between >> these two examples? > > I think it is an incomplete fix based on the suggestion I made for > the previous round, > > cf. https://lore.kernel.org/git/xmqqsfdwenn3.fsf@gitster.g/ Nice catch; this has been fixed for the next iteration. -- Sean Allred