[Emacs-diffs] emacs-25 7c81a0b: Improve documentation of 'save-place-mode'

[Eli Zaretskii]

branch: emacs-25
commit 7c81a0b9c68315511b98272d0aa40962d82f6e66
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Improve documentation of 'save-place-mode'
    
    * lisp/saveplace.el (toggle-save-place): Update the doc string wrt
    turning on 'save-place-mode' globally.
    
    * etc/NEWS: Mention the need to call 'save-place-mode' for turning
    on the mode in all buffers.
---
 etc/NEWS          |    8 +++++++-
 lisp/saveplace.el |    2 +-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/etc/NEWS b/etc/NEWS
index f3bb1a6..ae34a37 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -439,7 +439,13 @@ additionally need to add `getSelection' to 
`xterm-extra-capabilities'.
 *** `xterm-mouse-mode' now supports mouse-tracking (if your xterm supports it).
 
 ---
-** The `save-place' variable is replaced by `save-place-mode'.
+** To turn on `save-place' mode globally, you must call `(save-place-mode 1)'.
+In order to have the last place in every file saved it is no longer
+sufficient to load the saveplace library and set the default value of
+`save-place' to non-nil.  You must explicitly call the function
+`save-place-mode' with a positive argument instead.  The `save-place'
+variable is now an obsolete alias for `save-place-mode', which
+replaces it.
 
 ** ERC
 
diff --git a/lisp/saveplace.el b/lisp/saveplace.el
index c9148dc..c27df15 100644
--- a/lisp/saveplace.el
+++ b/lisp/saveplace.el
@@ -155,7 +155,7 @@ the argument is positive.
 To save places automatically in all files, put this in your init
 file:
 
-\(setq-default save-place t)"
+\(save-place-mode 1)"
   (interactive "P")
   (if (not (or buffer-file-name (and (derived-mode-p 'dired-mode)
                                      (boundp 'dired-subdir-alist)