all messages for Emacs-related lists mirrored at yhetil.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
[parent not found: <<1dc76f7a-5481-41df-b976-ec22229d7283@default>]

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 --
2013-08-17 15:59 bug#15117: 24.3.50; doc of `(forward|backward)-*': state return value 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
     [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                   ` 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

Code repositories for project(s) associated with this external index

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

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.