changeset 72598:070fe1ef3250

* buffers.texi (Buffer Modification): Document buffer-chars-modified-tick.
author Chong Yidong <cyd@stupidchicken.com>
date Fri, 01 Sep 2006 13:41:33 +0000
parents 63df36f810bc
children e4e2d953e61c
files lispref/ChangeLog lispref/buffers.texi
diffstat 2 files changed, 22 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/ChangeLog	Fri Sep 01 13:36:35 2006 +0000
+++ b/lispref/ChangeLog	Fri Sep 01 13:41:33 2006 +0000
@@ -1,3 +1,8 @@
+2006-09-01  Chong Yidong  <cyd@stupidchicken.com>
+
+	* buffers.texi (Buffer Modification): Document
+	buffer-chars-modified-tick.
+
 2006-08-31  Richard Stallman  <rms@gnu.org>
 
 	* modes.texi (Syntactic Font Lock): Mention specific faces once again.
--- a/lispref/buffers.texi	Fri Sep 01 13:36:35 2006 +0000
+++ b/lispref/buffers.texi	Fri Sep 01 13:41:33 2006 +0000
@@ -573,7 +573,6 @@
 echo area; use @code{set-buffer-modified-p} (above) instead.
 @end deffn
 
-@c Emacs 19 feature
 @defun buffer-modified-tick &optional buffer
 This function returns @var{buffer}'s modification-count.  This is a
 counter that increments every time the buffer is modified.  If
@@ -581,6 +580,23 @@
 The counter can wrap around occasionally.
 @end defun
 
+@defun buffer-chars-modified-tick &optional buffer
+This function returns @var{buffer}'s character-change modification-count.
+Changes to text properties leave this counter unchanged; however, each
+time text is inserted or removed from the buffer, the counter is reset
+to the value that would be returned @code{buffer-modified-tick}.
+By comparing the values returned by two @code{buffer-chars-modified-tick}
+calls, you can tell whether a character change occurred in that buffer
+in between the calls.  If @var{buffer} is @code{nil} (or omitted), the
+current buffer is used.
+@end defun
+
+This function returns @var{buffer}'s modification-count.  This is a
+counter that increments every time the buffer is modified.  If
+@var{buffer} is @code{nil} (or omitted), the current buffer is used.
+The counter can wrap around occasionally.
+@end defun
+
 @node Modification Time
 @comment  node-name,  next,  previous,  up
 @section Comparison of Modification Time