From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#15117: 24.3.50; doc of `(forward|backward)-*': state return value Date: Sat, 17 Aug 2013 08:59:27 -0700 (PDT) Message-ID: <1dc76f7a-5481-41df-b976-ec22229d7283@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1376755301 4869 80.91.229.3 (17 Aug 2013 16:01:41 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 17 Aug 2013 16:01:41 +0000 (UTC) To: 15117@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Aug 17 18:01:42 2013 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 1VAiwg-0005fo-BG for geb-bug-gnu-emacs@m.gmane.org; Sat, 17 Aug 2013 18:01:42 +0200 Original-Received: from localhost ([::1]:36406 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VAiwf-0005SB-8I for geb-bug-gnu-emacs@m.gmane.org; Sat, 17 Aug 2013 12:01:41 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48586) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VAiwD-0004kX-BY for bug-gnu-emacs@gnu.org; Sat, 17 Aug 2013 12:01:23 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VAiw3-0007RM-9Q for bug-gnu-emacs@gnu.org; Sat, 17 Aug 2013 12:01:13 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:42611) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VAiw3-0007RG-6m for bug-gnu-emacs@gnu.org; Sat, 17 Aug 2013 12:01:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1VAiw2-0004cy-Mo for bug-gnu-emacs@gnu.org; Sat, 17 Aug 2013 12:01:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 17 Aug 2013 16:01:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 15117 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.137675521417721 (code B ref -1); Sat, 17 Aug 2013 16:01:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 17 Aug 2013 16:00:14 +0000 Original-Received: from localhost ([127.0.0.1]:36927 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VAivE-0004bi-0s for submit@debbugs.gnu.org; Sat, 17 Aug 2013 12:00:13 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:46616) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VAiv9-0004aX-FA for submit@debbugs.gnu.org; Sat, 17 Aug 2013 12:00:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VAiuu-0006z5-5S for submit@debbugs.gnu.org; Sat, 17 Aug 2013 12:00:02 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:56759) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VAiuu-0006z1-2B for submit@debbugs.gnu.org; Sat, 17 Aug 2013 11:59:52 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48248) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VAiul-0003ED-C3 for bug-gnu-emacs@gnu.org; Sat, 17 Aug 2013 11:59:52 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VAiuZ-0006uc-ID for bug-gnu-emacs@gnu.org; Sat, 17 Aug 2013 11:59:43 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:46874) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VAiuZ-0006uT-8P for bug-gnu-emacs@gnu.org; Sat, 17 Aug 2013 11:59:31 -0400 Original-Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by aserp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r7HFxT3x009801 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 17 Aug 2013 15:59:30 GMT Original-Received: from aserz7021.oracle.com (aserz7021.oracle.com [141.146.126.230]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r7HFxSHG014358 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sat, 17 Aug 2013 15:59:29 GMT Original-Received: from abhmt111.oracle.com (abhmt111.oracle.com [141.146.116.63]) by aserz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r7HFxSSS012578 for ; Sat, 17 Aug 2013 15:59:28 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). 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:77463 Archived-At: 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. 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'. In GNU Emacs 24.3.50.1 (i686-pc-mingw32) of 2013-08-07 on ODIEONE Bzr revision: 113750 lekktu@gmail.com-20130808011911-0jzpc9xuncegg6x9 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/Devel/emacs/binary --enable-checking=3Dyes,glyphs CFLAGS=3D-O0 -g3 LDFLAGS=3D-Lc:/Devel/emacs/lib CPPFLAGS=3D-Ic:/Devel/emacs/include'