From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: David Kastrup Newsgroups: gmane.emacs.devel Subject: Re: set-text-properties, remove-set-properties, add-text-properties: 1) doc string 2) return value Date: Fri, 30 Dec 2005 12:24:03 +0100 Message-ID: <85r77uhlpo.fsf@lola.goethe.zz> References: <200512300357.jBU3vL700208@raven.dms.auburn.edu> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1135947011 23449 80.91.229.2 (30 Dec 2005 12:50:11 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 30 Dec 2005 12:50:11 +0000 (UTC) Cc: rms@gnu.org, 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 13:50:09 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 1EsJhu-0006M2-G3 for ged-emacs-devel@m.gmane.org; Fri, 30 Dec 2005 13:50:07 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EsJjJ-0007YF-2Z for ged-emacs-devel@m.gmane.org; Fri, 30 Dec 2005 07:51:33 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1EsJBj-0002LX-H9 for emacs-devel@gnu.org; Fri, 30 Dec 2005 07:16:52 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1EsJ46-0001At-PQ for emacs-devel@gnu.org; Fri, 30 Dec 2005 07:08:59 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EsIPe-0001he-NP for emacs-devel@gnu.org; Fri, 30 Dec 2005 06:27:11 -0500 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1EsIQ8-00009W-B5 for emacs-devel@gnu.org; Fri, 30 Dec 2005 06:27:41 -0500 Original-Received: from localhost ([127.0.0.1] helo=lola.goethe.zz) by fencepost.gnu.org with esmtp (Exim 4.34) id 1EsILd-0006rV-Rg; Fri, 30 Dec 2005 06:23:07 -0500 Original-Received: by lola.goethe.zz (Postfix, from userid 1002) id 8C3AE1C4F93D; Fri, 30 Dec 2005 12:24:03 +0100 (CET) Original-To: Luc Teirlinck In-Reply-To: <200512300357.jBU3vL700208@raven.dms.auburn.edu> (Luc Teirlinck's message of "Thu, 29 Dec 2005 21:57:21 -0600 (CST)") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.50 (gnu/linux) 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:48547 Archived-At: Luc Teirlinck writes: > 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. Since the programmer has no way of guessing what a function might or might not know (interesting word choice, anyway), this sounds like the worst of all solutions. I'd rather have "no useful value is returned". -- David Kastrup, Kriemhildstr. 15, 44793 Bochum