From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#15117: 24.3.50; doc of `(forward|backward)-*': state return value Date: Tue, 11 Feb 2014 20:05:15 +0200 Message-ID: <8338jpttic.fsf@gnu.org> 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> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1392141981 26086 80.91.229.3 (11 Feb 2014 18:06:21 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 11 Feb 2014 18:06:21 +0000 (UTC) Cc: 15117@debbugs.gnu.org, lekktu@gmail.com, larsi@gnus.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Feb 11 19:06:25 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 1WDHiq-0005oh-C7 for geb-bug-gnu-emacs@m.gmane.org; Tue, 11 Feb 2014 19:06:16 +0100 Original-Received: from localhost ([::1]:35227 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDHip-0002BK-Uc for geb-bug-gnu-emacs@m.gmane.org; Tue, 11 Feb 2014 13:06:15 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38024) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDHih-00024J-PF for bug-gnu-emacs@gnu.org; Tue, 11 Feb 2014 13:06:12 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WDHid-0003IH-2K for bug-gnu-emacs@gnu.org; Tue, 11 Feb 2014 13:06:07 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:46590) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDHic-0003IC-W0 for bug-gnu-emacs@gnu.org; Tue, 11 Feb 2014 13:06:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1WDHic-0003JK-J9 for bug-gnu-emacs@gnu.org; Tue, 11 Feb 2014 13:06:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 11 Feb 2014 18:06: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: wontfix Original-Received: via spool by 15117-submit@debbugs.gnu.org id=B15117.139214194812702 (code B ref 15117); Tue, 11 Feb 2014 18:06:02 +0000 Original-Received: (at 15117) by debbugs.gnu.org; 11 Feb 2014 18:05:48 +0000 Original-Received: from localhost ([127.0.0.1]:47772 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WDHiJ-0003If-OU for submit@debbugs.gnu.org; Tue, 11 Feb 2014 13:05:47 -0500 Original-Received: from mtaout26.012.net.il ([80.179.55.182]:33559) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WDHiA-0003IC-RG for 15117@debbugs.gnu.org; Tue, 11 Feb 2014 13:05:39 -0500 Original-Received: from conversion-daemon.mtaout26.012.net.il by mtaout26.012.net.il (HyperSendmail v2007.08) id <0N0U00A00FEXAB00@mtaout26.012.net.il> for 15117@debbugs.gnu.org; Tue, 11 Feb 2014 20:04:05 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout26.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0N0U009RYFIT0M10@mtaout26.012.net.il>; Tue, 11 Feb 2014 20:04:05 +0200 (IST) In-reply-to: <67b917ca-8b69-49fd-9e12-68da310f7567@default> X-012-Sender: halo1@inter.net.il 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:85396 Archived-At: > Date: Tue, 11 Feb 2014 09:29:24 -0800 (PST) > From: Drew Adams > Cc: lekktu@gmail.com, 15117@debbugs.gnu.org, larsi@gnus.org > > 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'). That's a different issue: you are asking to change the functions rather than to document what they currently do. Let's stay with the latter. > 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 Returns nil, so I don't see what is there to document. > forward-list ; already returns `point' > forward-page ; returns count Returns nil, not count. > forward-same-syntax Returns nil. > forward-sentence > forward-sexp Returns nil. > forward-symbol > forward-thing Always returns t, so not interesting. > forward-to-indentation The value is random, so not interesting > forward-visible-line Always nil. > forward-whitespace > forward-word Value is documented. Looks like only 4 functions of the list return something non-trivial.