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: AS53758 23.128.96.0/24 X-Spam-Status: No, score=-4.1 required=3.0 tests=AWL,BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_LOW, 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 B17031F5AE for ; Thu, 20 May 2021 16:53:42 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232840AbhETQy5 (ORCPT ); Thu, 20 May 2021 12:54:57 -0400 Received: from mail-ed1-f47.google.com ([209.85.208.47]:43949 "EHLO mail-ed1-f47.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232199AbhETQy4 (ORCPT ); Thu, 20 May 2021 12:54:56 -0400 Received: by mail-ed1-f47.google.com with SMTP id s6so20164920edu.10 for ; Thu, 20 May 2021 09:53:35 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=1ActCasgI8hHTjwiPDp8bVjF8zPhgD38rLeQhYdrB38=; b=PYetLTMd/jq1ycxJYOwys+f69HzPyZrOZG4ZGQ0Sb8LBEIEO5pkRTY+YKDFtlUjJ6k GbcaJ+GTcJNtVTgMC8bVCVwwRy/VdEBk9DcqGLvpz9OT4BFhfzWS5rAqZiqaiOXMf7/+ QXOxQtfbEv96vHOUy/klL/6FJR1LkxbDRd2WyN34ToXPYY4X8INBc8WqLtWMq1f2sOaI ZPJ32TO2Lib4r8Q+DzYvQDBc4Wsm/h1GCXz7WP3tMtcscb+WsIauIoPg6TEkTE6e/C0H r8wifEAVs2Ufbl7NifZNBkVmaN8q3zuGlTxgXtdUaFW8uebGe7zUWPTV2DbZ0fBobVQi hl/w== X-Gm-Message-State: AOAM5301hPXwB4+WdxlnySSeKWAbur3sVBM5SYz2Y6bwBp0lJXOxzz/y 8a/7fmmNJ2g5XAy7rNJk09PbTg14VNAtz2HSBrQ= X-Google-Smtp-Source: ABdhPJzT3E94J3te5Jk+qQyc7AUk1qY9/EMZQ9TcVlv6VFcoibQndbhcTdDjzVTRSu/t6+onSBbFsg91UTkfLBDs01U= X-Received: by 2002:a05:6402:152:: with SMTP id s18mr5828313edu.221.1621529614232; Thu, 20 May 2021 09:53:34 -0700 (PDT) MIME-Version: 1.0 References: In-Reply-To: From: Eric Sunshine Date: Thu, 20 May 2021 12:53:23 -0400 Message-ID: Subject: Re: [PATCH] revisions(7): clarify that most commands take a single revision range To: Elijah Newren Cc: Junio C Hamano , Bagas Sanjaya , Git Mailing List Content-Type: text/plain; charset="UTF-8" Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org On Thu, May 20, 2021 at 12:45 PM Elijah Newren wrote: > On Wed, May 19, 2021 at 10:03 PM Junio C Hamano wrote: > > Well, apparently the proposed text may have failed to educate you > > about what a "revision range" is and how it works, so it is not good > > enough, so I'll postpone merging the change down further and see if > > somebody else can come up with a better description. > > > > Thanks. > > I think it's helpful and would have answered questions for users that > I've had to manually explain to folks a few times, so while it may not > be optimal, I do think your description is an improvement to the docs. > That said, it can't hurt to see if we can find out what caused Bagas' > confusion and see if we can improve it, but I wouldn't hold it up > indefinitely if no better wording comes along. For what it's worth, as a person who is far from being a revision-range expert (and who doesn't typically think about them), I found the proposed text illuminating and clearly written. I learned from it. So, I agree with Elijah[1] that it is a good improvement to have (even if it's not perfect for every reader). [1]: Extended LInear Jump AHead