From e78ea3db1b66c6ee6756d78cd0d48cb45d082076 Mon Sep 17 00:00:00 2001 From: "Richard M. Stallman" Date: Fri, 20 Jun 1997 02:23:12 +0000 Subject: [PATCH] Clarify about text props in strings and how to remove all of them. --- lispref/text.texi | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/lispref/text.texi b/lispref/text.texi index 66a53e66a0e..6ba44ecda1a 100644 --- a/lispref/text.texi +++ b/lispref/text.texi @@ -2171,15 +2171,15 @@ stored in this list is used instead. Here is an example: @subsection Changing Text Properties The primitives for changing properties apply to a specified range of -text. The function @code{set-text-properties} (see end of section) sets -the entire property list of the text in that range; more often, it is -useful to add, change, or delete just certain properties specified by -name. +text in a buffer or string. The function @code{set-text-properties} +(see end of section) sets the entire property list of the text in that +range; more often, it is useful to add, change, or delete just certain +properties specified by name. - Since text properties are considered part of the buffer's contents, and -can affect how the buffer looks on the screen, any change in the text -properties is considered a buffer modification. Buffer text property -changes are undoable (@pxref{Undo}). + Since text properties are considered part of the contents of the +buffer (or string), and can affect how a buffer looks on the screen, any +change in buffer text properties mark the buffer as modified. Buffer +text property changes are undoable also (@pxref{Undo}). @defun put-text-property start end prop value &optional object This function sets the @var{prop} property to @var{value} for the text @@ -2228,6 +2228,10 @@ For example, here's how to remove the @code{face} property. The return value is @code{t} if the function actually changed some property's value; @code{nil} otherwise (if @var{props} is @code{nil} or if no character in the specified text had any of those properties). + +To remove all text properties from certain text, use +@code{set-text-properties} and specify @code{nil} for the new property +list. @end defun @defun set-text-properties start end props &optional object -- 2.39.2