From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#15117: 24.3.50; doc of `(forward|backward)-*': state return value Date: Fri, 07 Feb 2014 21:08:19 -0800 Message-ID: <874n4a42f0.fsf@building.gnus.org> References: <1dc76f7a-5481-41df-b976-ec22229d7283@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1391836212 16529 80.91.229.3 (8 Feb 2014 05:10:12 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 8 Feb 2014 05:10:12 +0000 (UTC) Cc: 15117@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Feb 08 06:10:17 2014 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1WC0BD-0000SF-MC for geb-bug-gnu-emacs@m.gmane.org; Sat, 08 Feb 2014 06:10:15 +0100 Original-Received: from localhost ([::1]:44956 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WC0BD-0002B3-0a for geb-bug-gnu-emacs@m.gmane.org; Sat, 08 Feb 2014 00:10:15 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:34149) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WC0B5-00027l-PI for bug-gnu-emacs@gnu.org; Sat, 08 Feb 2014 00:10:12 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WC0B0-0001iF-Q6 for bug-gnu-emacs@gnu.org; Sat, 08 Feb 2014 00:10:07 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:42016) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WC0B0-0001hn-LV for bug-gnu-emacs@gnu.org; Sat, 08 Feb 2014 00:10:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1WC0B0-0000I1-7t for bug-gnu-emacs@gnu.org; Sat, 08 Feb 2014 00:10:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 08 Feb 2014 05:10:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 15117 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 15117-submit@debbugs.gnu.org id=B15117.13918361841066 (code B ref 15117); Sat, 08 Feb 2014 05:10:02 +0000 Original-Received: (at 15117) by debbugs.gnu.org; 8 Feb 2014 05:09:44 +0000 Original-Received: from localhost ([127.0.0.1]:56032 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WC0Ai-0000H8-5O for submit@debbugs.gnu.org; Sat, 08 Feb 2014 00:09:44 -0500 Original-Received: from hermes.netfonds.no ([80.91.224.195]:48149) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WC0Ag-0000H0-3l for 15117@debbugs.gnu.org; Sat, 08 Feb 2014 00:09:42 -0500 Original-Received: from [204.14.154.233] (helo=building.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1WC0AS-0005Qr-1P; Sat, 08 Feb 2014 06:09:28 +0100 In-Reply-To: <1dc76f7a-5481-41df-b976-ec22229d7283@default> (Drew Adams's message of "Sat, 17 Aug 2013 08:59:27 -0700 (PDT)") User-Agent: Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.50 (gnu/linux) X-MailScanner-ID: 1WC0AS-0005Qr-1P MailScanner-NULL-Check: 1392440968.53874@nYImfxE8vBSimrmn9dK3hQ X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:84886 Archived-At: Drew Adams writes: > These are motion functions, just like `goto-char' and > `skip-chars-forward'. Their doc should specify the return value > (regardless of whether it is a position, a Boolean, always nil, or > anything else). > > If, for some special (good) reason, code should not rely on the return > value of some function then this fact should be stated explicitly in > the doc: "This function is used only for its side effects; the return > value is undefined." This is Lisp, not C - return values are the norm, > not the exception. No, in Emacs we seldom say that. Functions used for side effect are quite normal. > The doc of `(forward|backward)-(word|line)' already correctly specifies > the return value. Not so for other `(forward|backward)-*' functions, > such as `(forward|backward)-sexp'. They don't seem to return anything useful. Closing. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/