unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#15117: 24.3.50; doc of `(forward|backward)-*': state return value
@ 2013-08-17 15:59 Drew Adams
  2014-02-08  5:08 ` Lars Ingebrigtsen
  0 siblings, 1 reply; 27+ messages in thread
From: Drew Adams @ 2013-08-17 15:59 UTC (permalink / raw)
  To: 15117

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=/c/Devel/emacs/binary --enable-checking=yes,glyphs
 CFLAGS=-O0 -g3 LDFLAGS=-Lc:/Devel/emacs/lib
 CPPFLAGS=-Ic:/Devel/emacs/include'





^ permalink raw reply	[flat|nested] 27+ messages in thread

end of thread, other threads:[~2014-02-11 19:26 UTC | newest]

Thread overview: 27+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
     [not found] <<1dc76f7a-5481-41df-b976-ec22229d7283@default>
     [not found] ` <<874n4a42f0.fsf@building.gnus.org>
     [not found]   ` <<1281d0fd-77cb-45e2-b99d-f4ad24b0fc4e@default>
     [not found]     ` <<jwvr47b3pcw.fsf-monnier+emacsbugs@gnu.org>
     [not found]       ` <<2fefcbaf-9417-4f57-93af-490ea73aea98@default>
     [not found]         ` <<CAAeL0SRYdnYryaVzADc5L61vgM0EPQeBzG2h327YynitS18tXA@mail.gmail.com>
     [not found]           ` <<68a64949-d801-4d09-8dc8-4b6ae0824855@default>
     [not found]             ` <<8361oltxu1.fsf@gnu.org>
     [not found]               ` <<67b917ca-8b69-49fd-9e12-68da310f7567@default>
     [not found]                 ` <<8338jpttic.fsf@gnu.org>
2014-02-11 18:14                   ` bug#15117: 24.3.50; doc of `(forward|backward)-*': state return value Drew Adams
2014-02-11 18:17                     ` Eli Zaretskii
     [not found]                   ` <<5889df4e-4343-4136-ae49-4062659da625@default>
     [not found]                     ` <<831tz9tsy2.fsf@gnu.org>
2014-02-11 18:26                       ` Drew Adams
2013-08-17 15:59 Drew Adams
2014-02-08  5:08 ` Lars Ingebrigtsen
2014-02-10  0:12   ` Drew Adams
2014-02-10  2:39     ` Lars Ingebrigtsen
2014-02-10  2:45       ` Drew Adams
2014-02-10 16:27     ` Stefan Monnier
2014-02-10 21:16       ` Drew Adams
2014-02-11  1:07         ` Dmitry Gutov
2014-02-11  6:40           ` Drew Adams
2014-02-11  1:28         ` Juanma Barranquero
2014-02-11  6:43           ` Drew Adams
2014-02-11 16:31             ` Eli Zaretskii
2014-02-11 17:29               ` Drew Adams
2014-02-11 18:05                 ` Eli Zaretskii
2014-02-11 18:42                 ` Andreas Röhler
2014-02-11 18:58                   ` Eli Zaretskii
2014-02-11 19:13                     ` Drew Adams
2014-02-11 19:26                     ` Andreas Röhler
2014-02-11 17:36             ` Juanma Barranquero
2014-02-11  2:52         ` Glenn Morris
2014-02-11  4:01         ` Stefan Monnier
2014-02-11 10:52           ` Andreas Röhler
2014-02-11 11:16             ` Nicolas Richard
2014-02-11 12:10               ` Andreas Röhler

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).