From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: Re: set-text-properties, remove-set-properties, add-text-properties: 1) doc string 2) return value Date: Thu, 29 Dec 2005 21:57:21 -0600 (CST) Message-ID: <200512300357.jBU3vL700208@raven.dms.auburn.edu> References: NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1135915194 28863 80.91.229.2 (30 Dec 2005 03:59:54 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 30 Dec 2005 03:59:54 +0000 (UTC) Cc: drew.adams@oracle.com, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Dec 30 04:59:52 2005 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1EsBQl-00036X-9T for ged-emacs-devel@m.gmane.org; Fri, 30 Dec 2005 04:59:51 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EsBS9-0000eM-4r for ged-emacs-devel@m.gmane.org; Thu, 29 Dec 2005 23:01:17 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1EsBRy-0000eC-7L for emacs-devel@gnu.org; Thu, 29 Dec 2005 23:01:06 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1EsBRw-0000dz-PZ for emacs-devel@gnu.org; Thu, 29 Dec 2005 23:01:05 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EsBRw-0000dw-Mz for emacs-devel@gnu.org; Thu, 29 Dec 2005 23:01:04 -0500 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.34) id 1EsBSO-0003Ar-Bm; Thu, 29 Dec 2005 23:01:32 -0500 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.13.3+Sun/8.13.3) with ESMTP id jBU3xaHA029298; Thu, 29 Dec 2005 21:59:36 -0600 (CST) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.7p1+Sun/8.11.7) id jBU3vL700208; Thu, 29 Dec 2005 21:57:21 -0600 (CST) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: rms@gnu.org In-reply-to: (rms@gnu.org) X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-2.0.1 (manatee.dms.auburn.edu [131.204.53.104]); Thu, 29 Dec 2005 21:59:36 -0600 (CST) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:48532 Archived-At: Richard Stallman wrote: I am not sure whether this is useful to document. I do not believe that the return value is very useful (given that only a nil return value provides any reliable info). But since the return value is sometimes nil and sometimes t, it might be good to document it, just to avoid a situation where a user _believes_ that he understands the return value and writes code relying on his mistaken belief. I could add: This function returns nil if it _knows_ that it did not replace any properties, non-nil otherwise. to both the docstring and the Elisp manual, if desired. Sincerely, Luc.