From: Lars Magne Ingebrigtsen Date: Sun, 10 Jul 2011 14:32:19 +0000 (+0200) Subject: (Insertion): Clarify marker movements. X-Git-Tag: emacs-pretest-24.0.90~104^2~403 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=568f7b7950c3df8c27a1ddd2c9318cc495c2a28c;p=emacs.git (Insertion): Clarify marker movements. Text from Drew Adams. Fixes: debbugs:1651 --- diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index 7e8dac0cb27..10c13bc2835 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,3 +1,8 @@ +2011-07-10 Lars Magne Ingebrigtsen + + * text.texi (Insertion): Clarify marker movements (bug#1651). + Text from Drew Adams. + 2011-07-07 Lars Magne Ingebrigtsen * text.texi (Special Properties): Clarify the format of `face' diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi index 2d487352243..b91afb044f0 100644 --- a/doc/lispref/text.texi +++ b/doc/lispref/text.texi @@ -364,14 +364,13 @@ after point. Some insertion functions leave point before the inserted text, while other functions leave it after. We call the former insertion @dfn{after point} and the latter insertion @dfn{before point}. - Insertion relocates markers that point at positions after the -insertion point, so that they stay with the surrounding text -(@pxref{Markers}). When a marker points at the place of insertion, -insertion may or may not relocate the marker, depending on the marker's -insertion type (@pxref{Marker Insertion Types}). Certain special -functions such as @code{insert-before-markers} relocate all such markers -to point after the inserted text, regardless of the markers' insertion -type. + Insertion moves markers located at positions after the insertion +point, so that they stay with the surrounding text (@pxref{Markers}). +When a marker points at the place of insertion, insertion may or may +not relocate the marker, depending on the marker's insertion type +(@pxref{Marker Insertion Types}). Certain special functions such as +@code{insert-before-markers} relocate all such markers to point after +the inserted text, regardless of the markers' insertion type. Insertion functions signal an error if the current buffer is read-only or if they insert within read-only text.