[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

set-text-properties, remove-set-properties, add-text-properties: 1) doc

From: Drew Adams
Subject: set-text-properties, remove-set-properties, add-text-properties: 1) doc string 2) return value
Date: Wed, 28 Dec 2005 13:59:36 -0800

1. The set-text-properties doc string should say what the function returns.

2. Wouldn't it be more useful for set-text-properties,
remove-set-properties, and add-text-properties to return the modified OBJECT
(or nil if no modification occurred)? In case OBJECT is a buffer (or nil),
the modified buffer substring could be returned.

Perhaps it's too late to make the change in #2, if existing code depends on
the current value - but maybe not:

 - In the case of set-text-properties, that value is not even documented.

 - In the case of remove-set-properties and add-text-properties, perhaps
existing code only tests whether the returned value is null (instead of
testing equality with t).

reply via email to

[Prev in Thread] Current Thread [Next in Thread]