unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
From: Mauro Aranda <maurooaranda@gmail.com>
To: 33084@debbugs.gnu.org
Subject: bug#33084: 26.1.50; Outdated revert-buffer documentation
Date: Thu, 18 Oct 2018 12:30:42 -0300	[thread overview]
Message-ID: <CABczVwfqYePa0Wy4=emhXmeQOy0h8sW6DwNSBgzC69=4+ypc+g@mail.gmail.com> (raw)
In-Reply-To: <CABczVweX3UyBnOjW8XytSjeJJOPrSWPKiRv=5ZtCBdACHgAO0w@mail.gmail.com>

[-- Attachment #1: Type: text/plain, Size: 744 bytes --]

2018-10-18 12:11 GMT-03:00, Mauro Aranda <maurooaranda@gmail.com>:
> Hello.
>
> Regarding the Emacs manual, I think the following paragraph in the
> "Reverting a Buffer" section is outdated:
> "Reverting marks the buffer as not modified. It also clears the buffer's
> undo
> history (see Undo). Thus, the reversion cannot be undone—if you change your
> mind yet again, you can't use the undo commands to bring the reverted
> changes
> back."
>
> I think that was the previous behavior of revert-buffer, but it was changed
> a while ago, so now it is possible to do M-x revert-buffer RET yes RET
> and then do
> C-/ to bring the reverted changes back.
>
>

I propose the attached patch.  Please let me know what you think.

[-- Attachment #2: 0001-Update-revert-buffer-documentation.patch --]
[-- Type: text/x-patch, Size: 1419 bytes --]

From 1cc0b5c9533719a13dc4ead942564c8586541fdb Mon Sep 17 00:00:00 2001
From: Mauro Aranda <maurooaranda@gmail.com>
Date: Thu, 18 Oct 2018 11:28:18 -0300
Subject: [PATCH] Update revert-buffer documentation

* doc/emacs/files.texi (Reverting): Document that revert-buffer
does keep undo history.  (Bug#33084)

; Copyright-paperwork-exempt: yes
---
 doc/emacs/files.texi | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi
index c7d3b40..2fd8591 100644
--- a/doc/emacs/files.texi
+++ b/doc/emacs/files.texi
@@ -932,10 +932,10 @@ Reverting
 approximately the same part of the text as before.  But if you have
 made major changes, point may end up in a totally different location.
 
-  Reverting marks the buffer as not modified.  It also clears the
-buffer's undo history (@pxref{Undo}).  Thus, the reversion cannot be
-undone---if you change your mind yet again, you can't use the undo
-commands to bring the reverted changes back.
+  Reverting marks the buffer as not modified.  However, it adds the
+reverted changes as a single modification to the buffer's undo
+history (@pxref{Undo}).  Thus, after reverting, you can do @kbd{C-/}
+to bring the reverted changes back, if you happen to change your mind.
 
   Some kinds of buffers that are not associated with files, such as
 Dired buffers, can also be reverted.  For them, reverting means
-- 
2.7.4


  reply	other threads:[~2018-10-18 15:30 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2018-10-18 15:11 bug#33084: 26.1.50; Outdated revert-buffer documentation Mauro Aranda
2018-10-18 15:30 ` Mauro Aranda [this message]
2018-10-19  8:59   ` Eli Zaretskii

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='CABczVwfqYePa0Wy4=emhXmeQOy0h8sW6DwNSBgzC69=4+ypc+g@mail.gmail.com' \
    --to=maurooaranda@gmail.com \
    --cc=33084@debbugs.gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).