unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#42400: 26.3; doc of `kill-emacs' optional ARG
@ 2020-07-16 15:25 Drew Adams
  2020-07-16 17:34 ` Robert Pluim
  0 siblings, 1 reply; 4+ messages in thread
From: Drew Adams @ 2020-07-16 15:25 UTC (permalink / raw)
  To: 42400

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''





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

* bug#42400: 26.3; doc of `kill-emacs' optional ARG
  2020-07-16 15:25 bug#42400: 26.3; doc of `kill-emacs' optional ARG Drew Adams
@ 2020-07-16 17:34 ` Robert Pluim
  2020-07-16 17:58   ` Drew Adams
  2020-07-17 14:55   ` Eli Zaretskii
  0 siblings, 2 replies; 4+ messages in thread
From: Robert Pluim @ 2020-07-16 17:34 UTC (permalink / raw)
  To: Drew Adams; +Cc: 42400

>>>>> On Thu, 16 Jul 2020 08:25:55 -0700 (PDT), Drew Adams <drew.adams@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





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

* bug#42400: 26.3; doc of `kill-emacs' optional ARG
  2020-07-16 17:34 ` Robert Pluim
@ 2020-07-16 17:58   ` Drew Adams
  2020-07-17 14:55   ` Eli Zaretskii
  1 sibling, 0 replies; 4+ messages in thread
From: Drew Adams @ 2020-07-16 17:58 UTC (permalink / raw)
  To: Robert Pluim; +Cc: 42400

>     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.





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

* bug#42400: 26.3; doc of `kill-emacs' optional ARG
  2020-07-16 17:34 ` Robert Pluim
  2020-07-16 17:58   ` Drew Adams
@ 2020-07-17 14:55   ` Eli Zaretskii
  1 sibling, 0 replies; 4+ messages in thread
From: Eli Zaretskii @ 2020-07-17 14:55 UTC (permalink / raw)
  To: Robert Pluim; +Cc: 42400-done

> From: Robert Pluim <rpluim@gmail.com>
> Date: Thu, 16 Jul 2020 19:34:40 +0200
> Cc: 42400@debbugs.gnu.org
> 
> >>>>> On Thu, 16 Jul 2020 08:25:55 -0700 (PDT), Drew Adams <drew.adams@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.





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

end of thread, other threads:[~2020-07-17 14:55 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2020-07-16 15:25 bug#42400: 26.3; doc of `kill-emacs' optional ARG Drew Adams
2020-07-16 17:34 ` Robert Pluim
2020-07-16 17:58   ` Drew Adams
2020-07-17 14:55   ` Eli Zaretskii

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).