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,RCVD_IN_DNSWL_HI,SPF_HELO_NONE,SPF_PASS,URIBL_CSS, URIBL_CSS_A 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 874291F59D for ; Wed, 27 Jul 2022 14:51:07 +0000 (UTC) Authentication-Results: dcvr.yhbt.net; dkim=pass (1024-bit key; unprotected) header.d=pobox.com header.i=@pobox.com header.b="ybGSwEps"; dkim-atps=neutral Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234278AbiG0Ou5 (ORCPT ); Wed, 27 Jul 2022 10:50:57 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39226 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233234AbiG0Ouz (ORCPT ); Wed, 27 Jul 2022 10:50:55 -0400 Received: from pb-smtp1.pobox.com (pb-smtp1.pobox.com [64.147.108.70]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9CD253ED58 for ; Wed, 27 Jul 2022 07:50:54 -0700 (PDT) Received: from pb-smtp1.pobox.com (unknown [127.0.0.1]) by pb-smtp1.pobox.com (Postfix) with ESMTP id A06FB144773; Wed, 27 Jul 2022 10:50:53 -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:message-id:mime-version:content-type; s=sasl; bh=FXWz9mxcxSh6UA07wvcT+rsBoHo3beLG0BsfvvKbASc=; b=ybGS wEpsgP4bpXsOGPGxyESHmoAYjLjK2P/thgYNBE5qy3strROr6IRlSWuVL02LlqR8 NnF1j3jFgmNMSdxViirsZqr0Ywo1/g0pftoEbI07b2OboHfDGlU2dDCw+2tYfVVs vuveIBNvHVa6kZOyYq/dvMalz8fEj+iRqOykisA= Received: from pb-smtp1.nyi.icgroup.com (unknown [127.0.0.1]) by pb-smtp1.pobox.com (Postfix) with ESMTP id 97E02144772; Wed, 27 Jul 2022 10:50:53 -0400 (EDT) (envelope-from junio@pobox.com) Received: from pobox.com (unknown [34.105.40.190]) (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 EF7EB144771; Wed, 27 Jul 2022 10:50:52 -0400 (EDT) (envelope-from junio@pobox.com) From: Junio C Hamano To: "Derrick Stolee via GitGitGadget" Cc: git@vger.kernel.org, me@ttaylorr.com, vdye@github.com, steadmon@google.com, Derrick Stolee Subject: Re: [PATCH 2/3] log: add default decoration filter References: <6b40b84773c70244bb13204ec566b713f1bdf865.1658844250.git.gitgitgadget@gmail.com> Date: Wed, 27 Jul 2022 07:50:51 -0700 Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Pobox-Relay-ID: 833A0D5A-0DBB-11ED-BF8E-5E84C8D8090B-77302942!pb-smtp1.pobox.com Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org "Derrick Stolee via GitGitGadget" writes: > From: Derrick Stolee > > When a user runs 'git log', they expect a certain set of helpful > decorations. This includes: > > * The HEAD ref OK. > * Branches (refs/heads/) OK. > * Notes (refs/notes/) Questionable. None of the notes commits are on the primary history, so it is unlikely to be even used for decoration, so it would not hurt to have them as part of possible decoration sources, but on the other hand, the value of using them is dubious. > * Stashes (refs/stash/) Questionable, for the same reason as 'notes'. > * Tags (refs/tags/) Abolutely useful. > * Remote branches (refs/remotes/) Ditto. > --decorate-refs=:: > --decorate-refs-exclude=:: > - If no `--decorate-refs` is given, pretend as if all refs were > - included. For each candidate, do not use it for decoration if it > + For each candidate reference, do not use it for decoration if it > matches any patterns given to `--decorate-refs-exclude` or if it > doesn't match any of the patterns given to `--decorate-refs`. The > `log.excludeDecoration` config option allows excluding refs from > the decorations, but an explicit `--decorate-refs` pattern will > override a match in `log.excludeDecoration`. > ++ > +If none of these options or config settings are given, then references are > +used as decoration if they match `HEAD`, `refs/heads/`, `refs/notes/`, > +`refs/remotes/`, `refs/stash/`, or `refs/tags/`. > > --source:: > Print out the ref name given on the command line by which each OK. Thanks.