GNU bug report logs - #42400
26.3; doc of `kill-emacs' optional ARG

Previous Next

Package: emacs;

Reported by: Drew Adams <drew.adams <at> oracle.com>

Date: Thu, 16 Jul 2020 15:27:01 UTC

Severity: minor

Found in version 26.3

Done: Eli Zaretskii <eliz <at> gnu.org>

Bug is archived. No further changes may be made.

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 42400 in the body.
You can then email your comments to 42400 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

View this report as an mbox folder, status mbox, maintainer mbox


Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#42400; Package emacs. (Thu, 16 Jul 2020 15:27:01 GMT) Full text and rfc822 format available.

Acknowledgement sent to Drew Adams <drew.adams <at> oracle.com>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Thu, 16 Jul 2020 15:27:01 GMT) Full text and rfc822 format available.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 26.3; doc of `kill-emacs' optional ARG
Date: Thu, 16 Jul 2020 08:25:55 -0700 (PDT)
Both the Emacs and Elisp manuals describe the behavior of ARG as an
integer or a string.  But what about anything else?

In `startup.el', `edt-mapper.el', and `tpu-edt.el', for example, we find
(kill-emacs t).  How is someone to understand this code?

In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
 of 2019-08-29
Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
Windowing system distributor `Microsoft Corp.', version 10.0.18362
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#42400; Package emacs. (Thu, 16 Jul 2020 17:35:02 GMT) Full text and rfc822 format available.

Message #8 received at 42400 <at> debbugs.gnu.org (full text, mbox):

From: Robert Pluim <rpluim <at> gmail.com>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 42400 <at> debbugs.gnu.org
Subject: Re: bug#42400: 26.3; doc of `kill-emacs' optional ARG
Date: Thu, 16 Jul 2020 19:34:40 +0200
>>>>> On Thu, 16 Jul 2020 08:25:55 -0700 (PDT), Drew Adams <drew.adams <at> oracle.com> said:

    Drew> Both the Emacs and Elisp manuals describe the behavior of ARG as an
    Drew> integer or a string.  But what about anything else?

    Drew> In `startup.el', `edt-mapper.el', and `tpu-edt.el', for example, we find
    Drew> (kill-emacs t).  How is someone to understand this code?

Itʼs equivalent to exit'ing with EXIT_SUCCESS, without having to worry
about the value of '0' on your platform :-) Not sure how weʼd express
that in the docstring.

Robert




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#42400; Package emacs. (Thu, 16 Jul 2020 17:59:02 GMT) Full text and rfc822 format available.

Message #11 received at 42400 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Robert Pluim <rpluim <at> gmail.com>
Cc: 42400 <at> debbugs.gnu.org
Subject: RE: bug#42400: 26.3; doc of `kill-emacs' optional ARG
Date: Thu, 16 Jul 2020 10:58:49 -0700 (PDT)
>     Drew> Both the Emacs and Elisp manuals describe the behavior of ARG
> as an
>     Drew> integer or a string.  But what about anything else?
> 
>     Drew> In `startup.el', `edt-mapper.el', and `tpu-edt.el', for
> example, we find
>     Drew> (kill-emacs t).  How is someone to understand this code?
> 
> Itʼs equivalent to exit'ing with EXIT_SUCCESS, without having to worry
> about the value of '0' on your platform :-) Not sure how weʼd express
> that in the docstring.

Maybe just like that?  Is this true only for `t',
or is it true for any non-string, non-number value?

However we say it, I think it should be doc'd.  Thx.




Reply sent to Eli Zaretskii <eliz <at> gnu.org>:
You have taken responsibility. (Fri, 17 Jul 2020 14:56:02 GMT) Full text and rfc822 format available.

Notification sent to Drew Adams <drew.adams <at> oracle.com>:
bug acknowledged by developer. (Fri, 17 Jul 2020 14:56:02 GMT) Full text and rfc822 format available.

Message #16 received at 42400-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Robert Pluim <rpluim <at> gmail.com>
Cc: 42400-done <at> debbugs.gnu.org, drew.adams <at> oracle.com
Subject: Re: bug#42400: 26.3; doc of `kill-emacs' optional ARG
Date: Fri, 17 Jul 2020 17:55:17 +0300
> From: Robert Pluim <rpluim <at> gmail.com>
> Date: Thu, 16 Jul 2020 19:34:40 +0200
> Cc: 42400 <at> debbugs.gnu.org
> 
> >>>>> On Thu, 16 Jul 2020 08:25:55 -0700 (PDT), Drew Adams <drew.adams <at> oracle.com> said:
> 
>     Drew> Both the Emacs and Elisp manuals describe the behavior of ARG as an
>     Drew> integer or a string.  But what about anything else?
> 
>     Drew> In `startup.el', `edt-mapper.el', and `tpu-edt.el', for example, we find
>     Drew> (kill-emacs t).  How is someone to understand this code?
> 
> Itʼs equivalent to exit'ing with EXIT_SUCCESS, without having to worry
> about the value of '0' on your platform :-) Not sure how weʼd express
> that in the docstring.

I've documented it now, thanks.




bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Sat, 15 Aug 2020 11:24:04 GMT) Full text and rfc822 format available.

This bug report was last modified 4 years and 360 days ago.

Previous Next


GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.