From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#35702: xref revert-buffer Date: Sun, 26 May 2019 19:44:53 +0300 Message-ID: <83ef4l2mii.fsf@gnu.org> References: <87tvdzv4m2.fsf@mail.linkov.net> <838suw5jvh.fsf@gnu.org> <835zq059az.fsf@gnu.org> <710f0ac1-80d7-6db8-7653-c58f93b6f4ab@yandex.ru> <831s0o54g7.fsf@gnu.org> <9869e4ac-1b36-b605-22a8-b8bab4910132@yandex.ru> <83r28n4pdn.fsf@gnu.org> <2103dba2-60ec-9752-1ab8-71ed66fafe63@yandex.ru> <83h89j3rus.fsf@gnu.org> <28666899-1fcd-947b-8b2d-528f786302a9@yandex.ru> <831s0m4iz1.fsf@gnu.org> <83y32u32eb.fsf@gnu.org> Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="21781"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 35702@debbugs.gnu.org, juri@linkov.net To: Dmitry Gutov Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun May 26 18:46:11 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hUwHj-0005Xj-8m for geb-bug-gnu-emacs@m.gmane.org; Sun, 26 May 2019 18:46:11 +0200 Original-Received: from localhost ([127.0.0.1]:57438 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hUwHh-000771-UB for geb-bug-gnu-emacs@m.gmane.org; Sun, 26 May 2019 12:46:09 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:45872) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hUwHb-00075Q-Mq for bug-gnu-emacs@gnu.org; Sun, 26 May 2019 12:46:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hUwHa-00063h-OR for bug-gnu-emacs@gnu.org; Sun, 26 May 2019 12:46:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:38044) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hUwHa-00063b-LX for bug-gnu-emacs@gnu.org; Sun, 26 May 2019 12:46:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hUwHa-0004Z4-HE for bug-gnu-emacs@gnu.org; Sun, 26 May 2019 12:46:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 26 May 2019 16:46:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 35702 X-GNU-PR-Package: emacs Original-Received: via spool by 35702-submit@debbugs.gnu.org id=B35702.155888910317440 (code B ref 35702); Sun, 26 May 2019 16:46:02 +0000 Original-Received: (at 35702) by debbugs.gnu.org; 26 May 2019 16:45:03 +0000 Original-Received: from localhost ([127.0.0.1]:51588 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hUwGd-0004X5-4H for submit@debbugs.gnu.org; Sun, 26 May 2019 12:45:03 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:59549) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hUwGa-0004WE-RQ for 35702@debbugs.gnu.org; Sun, 26 May 2019 12:45:01 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:46555) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hUwGT-00054g-B4; Sun, 26 May 2019 12:44:53 -0400 Original-Received: from [176.228.60.248] (port=3617 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hUwGS-0007mg-35; Sun, 26 May 2019 12:44:53 -0400 In-reply-to: (message from Dmitry Gutov on Sun, 26 May 2019 00:33:33 +0300) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:159790 Archived-At: > Cc: 35702@debbugs.gnu.org, juri@linkov.net > From: Dmitry Gutov > Date: Sun, 26 May 2019 00:33:33 +0300 > > On 25.05.2019 19:49, Eli Zaretskii wrote: > > > Then I already asked those questions. The most important one is what > > values can the fetcher variable have, and in what situations (i.e., > > triggered by what command(s)) will we see each value. > > It's akin to asking what values could revert-buffer-function have: > different ones. Although in theory there could indeed be an infinite number of values, in practice the current actual set is very small, and can be easily described. If you want to avoid the (IMO imaginary) danger of implying there could be no other values, you can say explicitly that other values are possible. IOW, useful documentation should be general, but not too general. If being general means refraining saying something that could potentially help the reader understand the software and use it, then you are probably on the wrong side of "too general". > I have added some more docstrings and a comment, though. Hope they clear > up a few things. Thanks.