From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.devel Subject: Re: master 2ed2999: Improve documentation of new Xref options Date: Mon, 6 Sep 2021 15:47:57 +0300 Message-ID: <7fe2eafb-e15a-beab-f485-9c80b2913121@yandex.ru> References: <20210905075953.20536.20920@vcs0.savannah.gnu.org> <20210905075955.0F6B720A0A@vcs0.savannah.gnu.org> <6f1fcbee-1825-1219-88fb-e6f28d00ab4d@yandex.ru> <831r62tjf3.fsf@gnu.org> <0eaa7dc7-a3f2-5319-bf09-629f9949e416@yandex.ru> <834kaxsxb8.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="38214"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.13.0 Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Sep 06 14:49:41 2021 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mNE4D-0009ln-EA for ged-emacs-devel@m.gmane-mx.org; Mon, 06 Sep 2021 14:49:41 +0200 Original-Received: from localhost ([::1]:57792 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mNE4C-0007lH-Ci for ged-emacs-devel@m.gmane-mx.org; Mon, 06 Sep 2021 08:49:40 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:52756) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mNE2f-0005Tq-7t for emacs-devel@gnu.org; Mon, 06 Sep 2021 08:48:06 -0400 Original-Received: from mail-wr1-x433.google.com ([2a00:1450:4864:20::433]:42893) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mNE2b-0004dP-K2; Mon, 06 Sep 2021 08:48:04 -0400 Original-Received: by mail-wr1-x433.google.com with SMTP id q11so9691065wrr.9; Mon, 06 Sep 2021 05:48:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=sender:subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=rbVPzjAv5oMbXSxEyNlvVksHXUOwyRvB/dV70zHYc9c=; b=Tw4AyGC8R7kogjN2eveLFyogi9kON0BCAYSZU096uhU+l4bFZdnn/tv3OBqvL0Ascn Itht0i2mxH212x+zX8vErFSXpVrpcrDTiTbEqLwJhuV39c6/9IvFnfMCzqzMcBZWYeXa 248BpL/reGcggn8XP7WRSRQwAMUKKvnL2ID2XNXm6Go6bBz9SqSicZ7X7hJqRaZ1W8dH I8o0k2J+B9Sh12nADlbHXQKvWP1ICb0Kchb3MPCnSwVtGYUmbCBn0ma6/cJezrPXtcmK J5MhojErkQp9lCh2UnwPPXeIBFpSOSOttvLY2zckB0v0N3Ke+phMoI+3JJEXhuekjt6l xw6A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:subject:to:cc:references:from:message-id :date:user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=rbVPzjAv5oMbXSxEyNlvVksHXUOwyRvB/dV70zHYc9c=; b=UFxXcJOF3mmzu/bMkhv+Lm7jO3MbRRDf8PHrv0bVvG2BOm8LjARO1sBmYFtELp6mIa ajbC28nubdeY3u+vmsBhMzW17FAuVwk1B2lWprQi0ad+aMM7SDdq74twv746OZDpMiuz Dy5wNfAwwRMtyK0tHnRj2iWU5KtbUWhIl+MyjPd0qsJdWqJPuoKP8iIOg9l5zFxd9Kvj WRyY58HiSkL02lB/3+dR+0eTUkB9ey5dyzGpLLUuUTI2tc63Nzx7ChATX8dMSD0gULih lVzdL5Ty95pSESil87p+b7FGfaD59wGzErM7QvLFirVuo49XZCiHRU8vduV0mt7AHRBr 69FQ== X-Gm-Message-State: AOAM532Nuh2zP+PNVxjk2WxxtyVY9tDTibz4N2rW4EAaYzoAWXdNJVEz 0eEmmOuDcQjSXciTchHJDR0WtEUefAg= X-Google-Smtp-Source: ABdhPJwAwPexxGg6q7oNaplXMl/e33gLfuDomjlAoN8QeDMNLqWvCiP9ErTq3+vB+ddWggHgh3MICg== X-Received: by 2002:adf:c3c3:: with SMTP id d3mr13313745wrg.373.1630932479785; Mon, 06 Sep 2021 05:47:59 -0700 (PDT) Original-Received: from [192.168.0.6] ([46.251.119.176]) by smtp.googlemail.com with ESMTPSA id k4sm7936969wrm.74.2021.09.06.05.47.58 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 06 Sep 2021 05:47:59 -0700 (PDT) In-Reply-To: <834kaxsxb8.fsf@gnu.org> Content-Language: en-US Received-SPF: pass client-ip=2a00:1450:4864:20::433; envelope-from=raaahh@gmail.com; helo=mail-wr1-x433.google.com X-Spam_score_int: -37 X-Spam_score: -3.8 X-Spam_bar: --- X-Spam_report: (-3.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FORGED_FROMDOMAIN=0.25, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, NICE_REPLY_A=-2.332, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:274121 Archived-At: On 06.09.2021 15:28, Eli Zaretskii wrote: > My responses were only about a separate boolean option for > xref-find-references. AFAIU, that's not what you described, > disregarding the "boolean" part. We already differentiate between the -definitions[-*] commands and all other Xref commands, e.g. we have xref-show-definitions-function and xref-show-xrefs-function. This change follows the same pattern. We could have gone the one-defcustom-per-command route, but that's a lot of micromanagement for the users, with seemingly little benefit. > So, bottom line: which commands are affected by each option? E.g., > what about the -other-window and -at-mouse etc. variants: I guess they > are affected by the corresponding options? Also, what other commands > are affected, in addition to the "families" of xref-find-definitions Right. To clarify: all of xref-find-definitions-* are affected by xref-auto-jump-to-first-definition. > and xref-find-references? Also xref-find-apropos, project-find-regexp, dired-do-find-regexp and any other third-party or future callers of xref-show-xrefs-function will be affected by xref-auto-jump-to-first-xref. > And what about stuff like > dired-do-find-regexp-and-replace -- is that affected by any of these? dired-do-find-regexp-and-replace is affected as well right now, but that's a bug to be fixed (thanks for bringing it up).