From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Mauro Aranda Newsgroups: gmane.emacs.bugs Subject: bug#35290: 27.0.50; Outdated vc-revert documentation Date: Mon, 15 Apr 2019 19:25:52 -0300 Message-ID: References: <83bm17i6u7.fsf@gnu.org> <835zrfi122.fsf@gnu.org> <0690f9fc-e460-8778-64ff-023c0a7ca83d@yandex.ru> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="0000000000005868260586992397" Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="231458"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 35290@debbugs.gnu.org To: Eli Zaretskii , dgutov@yandex.ru Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Apr 16 00:27: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 1hGA4F-000y5J-6n for geb-bug-gnu-emacs@m.gmane.org; Tue, 16 Apr 2019 00:27:11 +0200 Original-Received: from localhost ([127.0.0.1]:56191 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hGA4D-0005b1-Tb for geb-bug-gnu-emacs@m.gmane.org; Mon, 15 Apr 2019 18:27:09 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:44342) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hGA47-0005al-LY for bug-gnu-emacs@gnu.org; Mon, 15 Apr 2019 18:27:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hGA46-0006kr-QP for bug-gnu-emacs@gnu.org; Mon, 15 Apr 2019 18:27:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:50387) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hGA46-0006ki-N2 for bug-gnu-emacs@gnu.org; Mon, 15 Apr 2019 18:27:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hGA46-0006mk-F3 for bug-gnu-emacs@gnu.org; Mon, 15 Apr 2019 18:27:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Mauro Aranda Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 15 Apr 2019 22:27:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 35290 X-GNU-PR-Package: emacs Original-Received: via spool by 35290-submit@debbugs.gnu.org id=B35290.155536717326015 (code B ref 35290); Mon, 15 Apr 2019 22:27:02 +0000 Original-Received: (at 35290) by debbugs.gnu.org; 15 Apr 2019 22:26:13 +0000 Original-Received: from localhost ([127.0.0.1]:35698 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hGA3I-0006lV-Nc for submit@debbugs.gnu.org; Mon, 15 Apr 2019 18:26:13 -0400 Original-Received: from mail-lj1-f177.google.com ([209.85.208.177]:39030) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hGA3G-0006lG-MN for 35290@debbugs.gnu.org; Mon, 15 Apr 2019 18:26:11 -0400 Original-Received: by mail-lj1-f177.google.com with SMTP id l7so17179713ljg.6 for <35290@debbugs.gnu.org>; Mon, 15 Apr 2019 15:26:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=FlG2LjoFUHZEIPMH/cqMlDC3Yau+acsaMXRWCPQ9kZU=; b=ZDaJwwVpfgbFTiFalTYutoLfuHaoAF/BnJZUn2J77ZPI21riNFKSZ/4Yrf+mH4m9T/ o1y59tDgb34GBZy9RMAVO634YBjcGbz8xV0DlzJk08RTt1RK7avpJvswzIMg2aF42pnr rPSwYYg1swaQpBtpfJ3Kl3xfi8dJvizIs2hhqd+AsEmbrypuiXS2KA4oVATsvy1t9wRK yuOi3ATV2xt2F2MWTn0anCRtl8zfO8inI7Lf8w5WWPGz0FA9kbeCiD7lcoWmEy1iBXxm dyXcU+iuIpGyymLw+/PuPuog6g2EmjnYQ/TzjMt89MI+ZRtYSDV9VKGqYJw8deRAlbEu t9hA== 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=FlG2LjoFUHZEIPMH/cqMlDC3Yau+acsaMXRWCPQ9kZU=; b=lAVpGz96ZBSYrTftaVVtP+34OQuockgYcNJcZ5usfN/lbPmvRFdrga9T9BzjEiHdpK kmHpJH3jyads5fxJYnNOrq5/xufjI+FqWa1fubNmlI0aAT9kjOpVCk4CfaJ6mXwSsgVi QWTMU6FwV64nCXI8D8sdveke3sOsyv5WmYhIDEFDeE4t+XWY2CA6vVkp+vOD9vhA7ppB MFDp8qBuEyGm9BU+7Jk7Qmc4RDjY+8x0tzoZHSzkJNt+Xu4wZ4MAaF/Ogneuitp9W1I5 NmIObBq2BpYEnU4VGHnFj5S0YIqft/OQ5n76DcCH6Q5rkDA4kSu+BHWSqCNcMyfjlD9I 2epA== X-Gm-Message-State: APjAAAWx3xGE7YNfClp481XUSZ1PeWyH/QA083AIL+fLtFt4cOUwAYWC dcM3BslW/yK+/ZzXZlNwiW71Ju23zFUd7LE0WF8= X-Google-Smtp-Source: APXvYqyEWDXl29Vr7qxCl2fz/dXQfGO1mJrVoEb7Eekmg2LtOFTDnVuaFq3avC9CCOSgtCwg6Gccdsr4KmsEDxXjBqA= X-Received: by 2002:a2e:8703:: with SMTP id m3mr41012134lji.107.1555367164666; Mon, 15 Apr 2019 15:26:04 -0700 (PDT) In-Reply-To: <0690f9fc-e460-8778-64ff-023c0a7ca83d@yandex.ru> 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:157684 Archived-At: --0000000000005868260586992397 Content-Type: text/plain; charset="UTF-8" > Because the section is called "VC Undo", I guess. OK. But I fail to see a reason why a user, after reading the Undo section, would expect that M-x undo acts upon anything that is not buffer text. That is what made me think (perhaps wrongly) that the sentence is about the old behavior of revert-buffer. At the least, I think the documentation could be improved. Some of the things vc-revert does can be reversed (e.g., bring back the reverted changes in the affected buffers) and other changes cannot (or might not, I'm not sure of the right wording here). If that is correct, then both the current text and my proposed patch fail to make that clear. --0000000000005868260586992397 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
> Be= cause the section is called "VC Undo", I guess.

OK.=C2=A0 But I fail to see a reason wh= y a user, after reading the Undo
section, would expect that M-x undo act= s upon anything that is not
buffer text.=C2=A0 That is what made me thin= k (perhaps wrongly) that the
sentence is about the old behavior of rever= t-buffer.

At the least, I think the documentation could be improved.= =C2=A0 Some of the
things vc-revert does can be reversed (e.g., bring ba= ck the reverted
changes in the affected buffers) and other changes canno= t (or might not,
I'm not sure of the right wording here).=C2=A0 If t= hat is correct, then both the
current text and my proposed patch fail to= make that clear.
--0000000000005868260586992397--