--- Begin Message ---
|
Subject: |
24.1; run-hook-with-args-until-failure |
|
Date: |
Sun, 9 Sep 2012 20:37:36 +0800 |
(let ((hook 'identity)) (run-hook-with-args-until-failure 'hook 42))
returns t but the doc falsely says 42:
... If the value is a function, it is called with
the given arguments and its return value is returned.
(let ((hook nil)) (run-hook-with-args-until-failure 'hook 42))
also returns t but the doc is improperly silent on the matter.
(let ((hook '(identity not))) (run-hook-with-args-until-failure 'hook 42))
(let ((hook '(not identity))) (run-hook-with-args-until-failure 'hook 42))
(let ((hook '(not print))) (run-hook-with-args-until-failure 'hook 42))
all return nil, which is correct.
(let ((hook '(print not))) (run-hook-with-args-until-failure 'hook 42))
outputs 42 and returns nil, which is correct.
The doc should either correctly describe all three cases
(function/nil/list) or not mention return values at all.
I suggest «returns nil if a hook function returns nil,
otherwise returns t» or something like that.
Peace
--Devon
P.S. My old return address, used *only* for this list, got spammed.
I changed it but in the future please be more careful.
In GNU Emacs 24.1.1 (x86_64-apple-darwin10.8.0, NS apple-appkit-1038.36)
of 2012-06-22 on RA.local
Windowing system distributor `Apple', version 10.3.1038
Configured using:
`configure '--with-ns' 'CC=gcc''
Important settings:
value of $LC_ALL: nil
value of $LC_COLLATE: nil
value of $LC_CTYPE: nil
value of $LC_MESSAGES: nil
value of $LC_MONETARY: nil
value of $LC_NUMERIC: nil
value of $LC_TIME: nil
value of $LANG: nil
value of $XMODIFIERS: nil
locale-coding-system: nil
default enable-multibyte-characters: t
Major mode: Lisp
Minor modes in effect:
eldoc-mode: t
display-time-mode: t
slime-mode: t
shell-dirtrack-mode: t
tooltip-mode: t
mouse-wheel-mode: t
file-name-shadow-mode: t
global-font-lock-mode: t
font-lock-mode: t
blink-cursor-mode: t
auto-composition-mode: t
auto-encryption-mode: t
auto-compression-mode: t
temp-buffer-resize-mode: t
line-number-mode: t
transient-mark-mode: t
Recent input:
<right> <right> <right> <right> <right> <right> <right>
l a m b d a SPC M-( x <right> SPC 1 2 3 4 <return>
<down> <down> <right> <right> <right> <right> <right>
<right> <right> <right> <right> <right> <right> <right>
<right> <right> <right> <right> <right> <right> <right>
<right> <right> <right> M-1 M-( i f M-( c o n s p SPC
<C-M-down-mouse-1> <C-M-mouse-1> M-) C-M-o M-( l i
s t SPC <C-M-down-mouse-1> <C-M-mouse-1> M-) C-M-t
M-^ C-M-a C-M-q <down-mouse-1> <mouse-1> C-j <up> <up>
<down> <down> <down> <down> <down> <down> <up> <up>
<up> <up> <up> <right> C-e C-M-k C-M-u M-) t C-M-x
<down-mouse-1> <mouse-1> C-q C-g <backspace> C-j M-"
U <backspace> A r <backspace> t <backspace> r t <backspace>
<backspace> c t u a l , SPC n o t SPC c o <backspace>
<backspace> d o c u m e n t e d , M-b M-b M-b A s SPC
i m p l e m e n t e d M-d <right> <right> <right> <right>
<right> SPC a s <right> <right> <right> <right> <right>
<right> <right> <right> <right> <right> <right> <right>
<right> <left> <backspace> . <left> SPC - SPC n e w
<backspace> w e <backspace> <backspace> b e <backspace>
<backspace> v e r SPC r <M-backspace> <M-backspace>
r e t u r n s SPC o n l y SPC t SPC o r SPC n i l <M-backspace>
<M-backspace> <M-backspace> <M-backspace> <M-backspace>
<backspace> <backspace> <backspace> M-b M-b M-b M-b
M-b M-b M-f M-f M-b C-y , SPC M-l M-b C-b <backspace>
M-b M-b C-a M-c <backspace> M-: M-p <right> <right>
<right> <right> <right> <right> <right> <right> <right>
<right> <right> <right> <right> <left> C-M-k ' i d
e n t i t y <return> M-: M-p C-M-k C-g C-g M-x r e
p o r t SPC e <backspace> <return>
Recent messages:
Auto-saving...
Mark set
Auto-saving...
t [2 times]
Auto-saving...done
=> EMACS-LISP:RUN-HOOK-WITH-ARGS-UNTIL-FAILURE
Mark set
Auto-saving...done
t
Quit
Quit
Load-path shadows:
/Applications/Emacs.app/Contents/Resources/lisp/xml hides /Users/devon/emacs/xml
/Applications/Emacs.app/Contents/Resources/lisp/net/tramp-ftp hides
/Users/devon/emacs/tramp-ftp
/Applications/Emacs.app/Contents/Resources/lisp/textmodes/sgml-mode hides
/Users/devon/emacs/sgml-mode
/Applications/Emacs.app/Contents/Resources/lisp/mail/sendmail hides
/Users/devon/emacs/sendmail
/Applications/Emacs.app/Contents/Resources/lisp/replace hides
/Users/devon/emacs/replace
/Applications/Emacs.app/Contents/Resources/lisp/emacs-lisp/regexp-opt hides
/Users/devon/emacs/regexp-opt
/Applications/Emacs.app/Contents/Resources/lisp/rect hides
/Users/devon/emacs/rect
/Applications/Emacs.app/Contents/Resources/lisp/textmodes/picture hides
/Users/devon/emacs/picture
/Applications/Emacs.app/Contents/Resources/lisp/play/morse hides
/Users/devon/emacs/morse
/Applications/Emacs.app/Contents/Resources/lisp/lpr hides /Users/devon/emacs/lpr
/Applications/Emacs.app/Contents/Resources/lisp/emacs-lisp/lisp hides
/Users/devon/emacs/lisp
/Applications/Emacs.app/Contents/Resources/lisp/progmodes/inf-lisp hides
/Users/devon/emacs/inf-lisp
~/emacs/slime/hyperspec hides /Users/devon/emacs/hyperspec
/Applications/Emacs.app/Contents/Resources/lisp/mail/hashcash hides
/Users/devon/emacs/hashcash
/Applications/Emacs.app/Contents/Resources/lisp/forms hides
/Users/devon/emacs/forms
/Applications/Emacs.app/Contents/Resources/lisp/dired-aux hides
/Users/devon/emacs/dired-aux
/Applications/Emacs.app/Contents/Resources/lisp/comint hides
/Users/devon/emacs/comint
/Applications/Emacs.app/Contents/Resources/lisp/emacs-lisp/cl-macs hides
/Users/devon/emacs/cl-macs
/usr/share/emacs/site-lisp/bmacs/bug hides /Users/devon/emacs/bug
/Applications/Emacs.app/Contents/Resources/lisp/emacs-lisp/advice hides
/Users/devon/emacs/advice
/Users/devon/emacs/gvoice hides /Users/devon/emacs/Leda/gvoice
/Users/devon/emacs/nicferrier-elnode-ff5d553/elnode hides
/Users/devon/emacs/Leda/elnode
/Users/devon/emacs/compose hides /Users/devon/emacs/Leda/compose
Features:
(shadow mail-extr emacsbug message format-spec rfc822 mml mml-sec
mm-decode mm-bodies mm-encode mail-parse rfc2231 mailabbrev gmm-utils
mailheader sendmail goto-addr noutline outline compare-w parse-time
vc-cvs mule-util pcmpl-unix tabify man lisp-cycle server cus-edit
cus-start cus-load dired-aux newcomment reposition grep compile debug
help-mode view eldoc network-stream auth-source eieio assoc gnus-util
password-cache starttls tls vc-git hi-lock baal vt-mouse rmail rfc2047
rfc2045 ietf-drums mm-util mail-prsvr mail-utils time ange-ftp
slime-pale slime-fancy slime-fontifying-fu slime-package-fu warnings
slime-references slime-xref-browser tree-widget wid-edit slime-scratch
slime-presentations slime-highlight-edits slime-fuzzy
slime-fancy-inspector slime-c-p-c slime-editing-commands slime-autodoc
slime-parse slime-repl slime byte-opt bytecomp byte-compile cconv
macroexp derived apropos edmacro kmacro easy-mmode hideshow pp hyperspec
thingatpt browse-url which-func imenu ude-autoload bmacs-gnu-emacs bmacs
lzx new rect shell pcomplete comint ansi-color sort etags ring diary-lib
diary-loaddefs cal-menu calendar cal-loaddefs paren sgml-mode dired
advice help-fns advice-preload info-look info easymenu hy-test
regexp-opt cl time-date tooltip ediff-hook vc-hooks lisp-float-type
mwheel ns-win tool-bar dnd fontset image fringe lisp-mode register page
menu-bar rfn-eshadow timer select scroll-bar mouse jit-lock font-lock
syntax facemenu font-core frame cham georgian utf-8-lang misc-lang
vietnamese tibetan thai tai-viet lao korean japanese hebrew greek
romanian slovak czech european ethiopic indian cyrillic chinese
case-table epa-hook jka-cmpr-hook help simple abbrev minibuffer loaddefs
button faces cus-face files text-properties overlay sha1 md5 base64
format env code-pages mule custom widget hashtable-print-readable
backquote make-network-process ns multi-tty emacs)
--- End Message ---
--- Begin Message ---
|
Subject: |
Re: bug#12393: 24.1; run-hook-with-args-until-failure |
|
Date: |
Mon, 17 Sep 2012 21:08:54 -0400 |
|
User-agent: |
Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) |
Version: 24.3
Thanks; improved the doc in emacs-24 branch.
--- End Message ---