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: Tue, 11 Feb 2014 09:29:24 -0800 (PST) Message-ID: <67b917ca-8b69-49fd-9e12-68da310f7567@default> References: <1dc76f7a-5481-41df-b976-ec22229d7283@default> <874n4a42f0.fsf@building.gnus.org> <1281d0fd-77cb-45e2-b99d-f4ad24b0fc4e@default> <2fefcbaf-9417-4f57-93af-490ea73aea98@default> <68a64949-d801-4d09-8dc8-4b6ae0824855@default> <8361oltxu1.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1392139819 31060 80.91.229.3 (11 Feb 2014 17:30:19 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 11 Feb 2014 17:30:19 +0000 (UTC) Cc: 15117@debbugs.gnu.org, lekktu@gmail.com, larsi@gnus.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Feb 11 18:30:26 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 1WDHA8-0001NX-S9 for geb-bug-gnu-emacs@m.gmane.org; Tue, 11 Feb 2014 18:30:25 +0100 Original-Received: from localhost ([::1]:35132 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDHA8-0001KO-F6 for geb-bug-gnu-emacs@m.gmane.org; Tue, 11 Feb 2014 12:30:24 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57048) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDH9x-0001JI-7X for bug-gnu-emacs@gnu.org; Tue, 11 Feb 2014 12:30:21 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WDH9o-0000WL-M9 for bug-gnu-emacs@gnu.org; Tue, 11 Feb 2014 12:30:13 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:46558) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDH9o-0000V0-Js for bug-gnu-emacs@gnu.org; Tue, 11 Feb 2014 12:30:04 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1WDH9n-00016P-Bb for bug-gnu-emacs@gnu.org; Tue, 11 Feb 2014 12:30:03 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 11 Feb 2014 17:30:03 +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: wontfix Original-Received: via spool by 15117-submit@debbugs.gnu.org id=B15117.13921397784171 (code B ref 15117); Tue, 11 Feb 2014 17:30:03 +0000 Original-Received: (at 15117) by debbugs.gnu.org; 11 Feb 2014 17:29:38 +0000 Original-Received: from localhost ([127.0.0.1]:47740 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WDH9N-00015C-NC for submit@debbugs.gnu.org; Tue, 11 Feb 2014 12:29:38 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:25565) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WDH9L-00014w-2S for 15117@debbugs.gnu.org; Tue, 11 Feb 2014 12:29:35 -0500 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id s1BHTS9j019402 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Tue, 11 Feb 2014 17:29:28 GMT Original-Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s1BHTPkC009479 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Tue, 11 Feb 2014 17:29:26 GMT Original-Received: from abhmp0017.oracle.com (abhmp0017.oracle.com [141.146.116.23]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s1BHTPTo013492; Tue, 11 Feb 2014 17:29:25 GMT In-Reply-To: <8361oltxu1.fsf@gnu.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] X-Source-IP: acsinet21.oracle.com [141.146.126.237] 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:85393 Archived-At: > If you (Drew) want that something productive comes out of this, > please point out specific forward/backward-* functions that return > non-trivial values, and those values are not documented. The only 2 > functions mentioned since the beginning of this discussion are > forward/backward-sexp, which always return nil, a.k.a. "nothing". I > also tried a couple of other random functions, and they seem all to > be of this "nothing" kind. So I wonder whether we have any real > problem here. I would like to see functions that are purely motion functions return `point', the destination position, unless there is a more useful return value (as is already the case for a function such as `forward-comment' or `forward-button'). IOW, some useful value is better than none. Note: I have nothing against picking a _more_ useful value than `point'. Point is just a default suggestion. For an example of a more useful value, see `forward-comment': it sets `point' but returns t or nil. And document that return value. Here are some candidates, for a start (likewise, their backward relatives, and other relatives, such as `up-list', `down-list', `backward-up-list'...). forward-char forward-list ; already returns `point' forward-page ; returns count forward-same-syntax forward-sentence forward-sexp forward-symbol forward-thing forward-to-indentation forward-visible-line forward-whitespace forward-word We can look for other motion functions to treat similarly after this start. Assuming there is any will to do this.