[Emacs-diffs] trunk r116633: * markers.texi (Moving Marker Positions): Clarify guidance about

[Barry O'Reilly]

------------------------------------------------------------
revno: 116633
revision-id: address@hidden
parent: address@hidden
committer: Barry O'Reilly <address@hidden>
branch nick: trunk
timestamp: Sun 2014-03-02 12:49:02 -0500
message:
  * markers.texi (Moving Marker Positions): Clarify guidance about
  when to move markers and when to create a new one, as discussed at
  http://debbugs.gnu.org/cgi/bugreport.cgi?bug=16818#17
modified:
  doc/lispref/ChangeLog          changelog-20091113204419-o5vbwnq5f7feedwu-6155
  doc/lispref/markers.texi       
markers.texi-20091113204419-o5vbwnq5f7feedwu-6198

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2014-03-02 03:34:36 +0000
+++ b/doc/lispref/ChangeLog     2014-03-02 17:49:02 +0000
@@ -1,3 +1,9 @@
+2014-03-02  Barry O'Reilly <address@hidden>
+
+       * markers.texi (Moving Marker Positions): Clarify guidance about
+       when to move markers and when to create a new one, as discussed at
+       http://debbugs.gnu.org/cgi/bugreport.cgi?bug=16818#17
+
 2014-03-02  Glenn Morris  <address@hidden>
 
        * text.texi (Decompression): New node.

=== modified file 'doc/lispref/markers.texi'
--- a/doc/lispref/markers.texi  2014-01-01 07:43:34 +0000
+++ b/doc/lispref/markers.texi  2014-03-02 17:49:02 +0000
@@ -344,10 +344,12 @@
 @section Moving Marker Positions
 
   This section describes how to change the position of an existing
-marker.  When you do this, be sure you know whether the marker is used
-outside of your program, and, if so, what effects will result from
-moving it---otherwise, confusing things may happen in other parts of
-Emacs.
+marker.  When you do this, be sure you know how the marker is used
+outside of your program.  For example, moving a marker to an unrelated
+new position can cause undo to later adjust the marker incorrectly.
+Often when you wish to relocate a marker to an unrelated position, it
+is preferable to make a new marker and set the prior one to point
+nowhere.
 
 @defun set-marker marker position &optional buffer
 This function moves @var{marker} to @var{position}