From: Kim F. Storm <storm@cua.dk>
Date: Sun, 9 Apr 2006 23:05:07 +0000 (+0000)
Subject: (Buffer Contents): Add NOPROPS arg to filter-buffer-substring.
X-Git-Tag: emacs-pretest-22.0.90~3241
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=1f8a33db8c92c2bae36c26588cfcdb46f8aed873;p=emacs.git

(Buffer Contents): Add NOPROPS arg to filter-buffer-substring.
---

diff --git a/lispref/text.texi b/lispref/text.texi
index 3a0d4f7a585..d506341f0d5 100644
--- a/lispref/text.texi
+++ b/lispref/text.texi
@@ -205,7 +205,7 @@ This is like @code{buffer-substring}, except that it does not copy text
 properties, just the characters themselves.  @xref{Text Properties}.
 @end defun
 
-@defun filter-buffer-substring start end &optional delete
+@defun filter-buffer-substring start end &optional delete noprops
 This function passes the buffer text between @var{start} and @var{end}
 through the filter functions specified by the variable
 @code{buffer-substring-filters}, and returns the value from the last
@@ -217,7 +217,12 @@ If @var{delete} is non-@code{nil}, this function deletes the text
 between @var{start} and @var{end} after copying it, like
 @code{delete-and-extract-region}.
 
-Lisp code should use this function instead of @code{buffer-substring}
+If @var{noprops} is non-@code{nil}, the final string returned does not
+include text properties, while the string passed through the filters
+still includes text properties from the buffer text.
+
+Lisp code should use this function instead of @code{buffer-substring},
+@code{buffer-substring-no-properties},
 or @code{delete-and-extract-region} when copying into user-accessible
 data structures such as the kill-ring, X clipboard, and registers.
 Major and minor modes can add functions to