From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Andreas =?UTF-8?Q?R=C3=B6hler?= Newsgroups: gmane.emacs.bugs Subject: bug#15117: 24.3.50; doc of `(forward|backward)-*': state return value Date: Tue, 11 Feb 2014 19:42:52 +0100 Message-ID: <52FA6F2C.3010602@easy-emacs.de> 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> <67b917ca-8b69-49fd-9e12-68da310f7567@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1392144024 19805 80.91.229.3 (11 Feb 2014 18:40:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 11 Feb 2014 18:40:24 +0000 (UTC) To: 15117@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Feb 11 19:40:27 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 1WDIFt-0008Fc-G4 for geb-bug-gnu-emacs@m.gmane.org; Tue, 11 Feb 2014 19:40:25 +0100 Original-Received: from localhost ([::1]:35423 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDIFt-00086s-3R for geb-bug-gnu-emacs@m.gmane.org; Tue, 11 Feb 2014 13:40:25 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45852) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDIFf-0007v6-E2 for bug-gnu-emacs@gnu.org; Tue, 11 Feb 2014 13:40:20 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WDIFV-00050C-V5 for bug-gnu-emacs@gnu.org; Tue, 11 Feb 2014 13:40:11 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:46633) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDIFV-000508-Re for bug-gnu-emacs@gnu.org; Tue, 11 Feb 2014 13:40:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1WDIFV-0004KF-Jh for bug-gnu-emacs@gnu.org; Tue, 11 Feb 2014 13:40:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Andreas =?UTF-8?Q?R=C3=B6hler?= Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 11 Feb 2014 18:40:01 +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 X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.139214395916557 (code B ref -1); Tue, 11 Feb 2014 18:40:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 11 Feb 2014 18:39:19 +0000 Original-Received: from localhost ([127.0.0.1]:47815 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WDIEp-0004Iw-0C for submit@debbugs.gnu.org; Tue, 11 Feb 2014 13:39:19 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:43873) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WDIEm-0004Ie-1T for submit@debbugs.gnu.org; Tue, 11 Feb 2014 13:39:17 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WDIEX-0004VS-DJ for submit@debbugs.gnu.org; Tue, 11 Feb 2014 13:39:10 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:50683) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDIEX-0004VO-At for submit@debbugs.gnu.org; Tue, 11 Feb 2014 13:39:01 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45566) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDIEP-0006Oh-W7 for bug-gnu-emacs@gnu.org; Tue, 11 Feb 2014 13:39:01 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WDIEI-0004RF-FN for bug-gnu-emacs@gnu.org; Tue, 11 Feb 2014 13:38:53 -0500 Original-Received: from moutng.kundenserver.de ([212.227.126.186]:51426) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDIEI-0004R1-4r for bug-gnu-emacs@gnu.org; Tue, 11 Feb 2014 13:38:46 -0500 Original-Received: from purzel.sitgens (brln-4d0c6463.pool.mediaWays.net [77.12.100.99]) by mrelayeu.kundenserver.de (node=mreue102) with ESMTP (Nemesis) id 0Lh6mt-1VRpul2mfP-00oZKb; Tue, 11 Feb 2014 19:38:45 +0100 User-Agent: Mozilla/5.0 (X11; Linux i686; rv:24.0) Gecko/20100101 Thunderbird/24.2.0 In-Reply-To: <67b917ca-8b69-49fd-9e12-68da310f7567@default> X-Provags-ID: V02:K0:IQ0yu2yGbMfPd+x/lkpxO/fcWg9g4O80gLszuyUNXe/ EQ26EJF5VqVP1POsPWTY0SGpw0E56GgKP3qBqehbhpnhA9Oc3R IgEOgEzIA3YKTWsd8uZacOILtVQGcvqTRwzIqkfG9lAc1AfZEn 09gWTeFXXQoKngYjx6o5M/gJHzCCImbmq9H/oyQiUrk5WtMMrg Dj0/M6v7/EAWzxd1XLja1CvaPqTdpU7TUL7Zz/TBXz5zzVdjjq w2FD618Uge7iDshUTH7naHJXz0tYOI69ELgjEnMONASC6dOmQb 28jzr8DRc3AgI8KbvMSD+QyuH4DzbMDUXrNSZA/6toUmMPyE+c ETltKPOzDbiwBhUGh0zYYkz0Na3S+mwXu6JnfvCwr 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:85401 Archived-At: Am 11.02.2014 18:29, schrieb Drew Adams: >> 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. IMO these functions should return point if successful, i.e. if point was moved, but nil otherwise, for example at EOB. As point --a number-- evals to `t', a respective check might be set upon from receiving function. > > 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. > > > >