bug#31552: 27.0.50; Document that Emacs in batch mode exits with exit status -1 on error

bug#31552: 27.0.50; Document that Emacs in batch mode exits with exit status -1 on error

[Philipp]

I haven't found any documentation in the Lisp reference manual that the
exit status of an Emacs process exiting due to a nonlocal exit is -1 by
default (adjusted to 255 by Bash).  This should be documented, for users
that run Emacs in batch mode.


In GNU Emacs 27.0.50 (build 68, x86_64-apple-darwin17.4.0, NS appkit-1561.20 Version 10.13.3 (Build 17D102))
 of 2018-05-22 built on p
Repository revision: 19e642fdb07b0b6522983e2fa35872ba5fb9f75e
Windowing system distributor 'Apple', version 10.3.1561
System Description:  Mac OS X 10.13.3

Recent messages:
For information about GNU Emacs and the GNU system, type C-h C-a.

Configured using:
 'configure --with-modules --without-pop --with-mailutils
 --enable-gcc-warnings=yes --enable-checking
 --enable-check-lisp-object-type 'CFLAGS=-ggdb3 -O0''

Configured features:
NOTIFY ACL GNUTLS LIBXML2 ZLIB TOOLKIT_SCROLL_BARS NS MODULES THREADS
JSON

Important settings:
  value of $LANG: de_DE.UTF-8
  locale-coding-system: utf-8-unix

Major mode: Lisp Interaction

Minor modes in effect:
  tooltip-mode: t
  global-eldoc-mode: t
  eldoc-mode: t
  electric-indent-mode: t
  mouse-wheel-mode: t
  tool-bar-mode: t
  menu-bar-mode: t
  file-name-shadow-mode: t
  global-font-lock-mode: t
  font-lock-mode: t
  auto-composition-mode: t
  auto-encryption-mode: t
  auto-compression-mode: t
  line-number-mode: t
  transient-mark-mode: t

Load-path shadows:
None found.

Features:
(shadow sort mail-extr emacsbug message rmc puny seq byte-opt gv
bytecomp byte-compile cconv dired dired-loaddefs format-spec rfc822 mml
easymenu mml-sec password-cache epa derived epg epg-config gnus-util
rmail rmail-loaddefs mm-decode mm-bodies mm-encode mail-parse rfc2231
mailabbrev gmm-utils mailheader cl-loaddefs cl-lib sendmail rfc2047
rfc2045 ietf-drums mm-util mail-prsvr mail-utils time-date elec-pair
tooltip eldoc electric uniquify ediff-hook vc-hooks lisp-float-type
mwheel term/ns-win ns-win ucs-normalize mule-util term/common-win
tool-bar dnd fontset image regexp-opt fringe tabulated-list replace
newcomment text-mode elisp-mode lisp-mode prog-mode register page
menu-bar rfn-eshadow isearch timer select scroll-bar mouse jit-lock
font-lock syntax facemenu font-core term/tty-colors frame cl-generic
cham georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao
korean japanese eucjp-ms cp51932 hebrew greek romanian slovak czech
european ethiopic indian cyrillic chinese composite charscript charprop
case-table epa-hook jka-cmpr-hook help simple abbrev obarray minibuffer
cl-preloaded nadvice loaddefs button faces cus-face macroexp files
text-properties overlay sha1 md5 base64 format env code-pages mule
custom widget hashtable-print-readable backquote kqueue cocoa ns
multi-tty make-network-process emacs)

Memory information:
((conses 16 204643 7390)
 (symbols 48 20009 1)
 (miscs 40 56 139)
 (strings 32 28865 2011)
 (string-bytes 1 773342)
 (vectors 16 35280)
 (vector-slots 8 721688 13494)
 (floats 8 51 65)
 (intervals 56 210 0)
 (buffers 992 11))

bug#31552: 27.0.50; Document that Emacs in batch mode exits with exit status -1 on error

[Eli Zaretskii]

> From: Philipp <p.stephani2@gmail.com>
> Date: Tue, 22 May 2018 15:41:25 +0200
> 
> I haven't found any documentation in the Lisp reference manual that the
> exit status of an Emacs process exiting due to a nonlocal exit is -1 by
> default (adjusted to 255 by Bash).  This should be documented, for users
> that run Emacs in batch mode.

I'm not sure I understand what you are describing.  Can you show a
reproducer?

Thanks.

bug#31552: 27.0.50; Document that Emacs in batch mode exits with exit status -1 on error

[Philipp Stephani]

[-- Attachment #1: Type: text/plain, Size: 576 bytes --]

Eli Zaretskii <eliz@gnu.org> schrieb am Di., 22. Mai 2018 um 19:17 Uhr:

> > From: Philipp <p.stephani2@gmail.com>
> > Date: Tue, 22 May 2018 15:41:25 +0200
> >
> > I haven't found any documentation in the Lisp reference manual that the
> > exit status of an Emacs process exiting due to a nonlocal exit is -1 by
> > default (adjusted to 255 by Bash).  This should be documented, for users
> > that run Emacs in batch mode.
>
> I'm not sure I understand what you are describing.  Can you show a
> reproducer?
>
>
$ src/emacs -Q -batch -eval '(error "foo")' ; echo $?

foo
255

[-- Attachment #2: Type: text/html, Size: 1135 bytes --]

bug#31552: 27.0.50; Document that Emacs in batch mode exits with exit status -1 on error

[Lars Ingebrigtsen]

Philipp Stephani <p.stephani2@gmail.com> writes:

> Eli Zaretskii <eliz@gnu.org> schrieb am Di., 22. Mai 2018 um 19:17 Uhr:
>
>  > From: Philipp <p.stephani2@gmail.com>
>  > Date: Tue, 22 May 2018 15:41:25 +0200
>  > 
>  > I haven't found any documentation in the Lisp reference manual that the
>  > exit status of an Emacs process exiting due to a nonlocal exit is -1 by
>  > default (adjusted to 255 by Bash).  This should be documented, for users
>  > that run Emacs in batch mode.
>
>  I'm not sure I understand what you are describing.  Can you show a
>  reproducer?
>
> $ src/emacs -Q -batch -eval '(error "foo")' ; echo $?
>
> foo
>
> 255 

I've now added something like this to the Emacs 27 manual.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

bug#31552: 27.0.50; Document that Emacs in batch mode exits with exit status -1 on error

[Philipp Stephani]

Am Sa., 12. Okt. 2019 um 23:16 Uhr schrieb Lars Ingebrigtsen <larsi@gnus.org>:
>
> Philipp Stephani <p.stephani2@gmail.com> writes:
>
> > Eli Zaretskii <eliz@gnu.org> schrieb am Di., 22. Mai 2018 um 19:17 Uhr:
> >
> >  > From: Philipp <p.stephani2@gmail.com>
> >  > Date: Tue, 22 May 2018 15:41:25 +0200
> >  >
> >  > I haven't found any documentation in the Lisp reference manual that the
> >  > exit status of an Emacs process exiting due to a nonlocal exit is -1 by
> >  > default (adjusted to 255 by Bash).  This should be documented, for users
> >  > that run Emacs in batch mode.
> >
> >  I'm not sure I understand what you are describing.  Can you show a
> >  reproducer?
> >
> > $ src/emacs -Q -batch -eval '(error "foo")' ; echo $?
> >
> > foo
> >
> > 255
>
> I've now added something like this to the Emacs 27 manual.

Thanks.