From: Rich Trott Date: Wed, 16 Sep 2015 21:31:42 +0000 (-0700) Subject: doc: refine process.kill() and exit explanations X-Git-Tag: v4.1.1~22 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=b2ddf0f9a233f8f59da748166d434217db3dfa9a;p=platform%2Fupstream%2Fnodejs.git doc: refine process.kill() and exit explanations Add corrections about when exit event fires and how .kill() works on Windows. PR-URL: https://github.com/nodejs/node/pull/2918 Reviewed-By: Sam Roberts --- diff --git a/doc/api/process.markdown b/doc/api/process.markdown index 960fcc2..ee6f540 100644 --- a/doc/api/process.markdown +++ b/doc/api/process.markdown @@ -59,8 +59,8 @@ finished running the process will exit. Therefore you **must** only perform checks on the module's state (like for unit tests). The callback takes one argument, the code the process is exiting with. -This event may not be fired if the process terminates due to signals like -`SIGINT`, `SIGTERM`, `SIGKILL`, and `SIGHUP`. +This event is only emitted when node exits explicitly by process.exit() or +implicitly by the event loop draining. Example of listening for `exit`: @@ -240,12 +240,12 @@ Note: - `SIGKILL` cannot have a listener installed, it will unconditionally terminate Node.js on all platforms. - `SIGSTOP` cannot have a listener installed. -- Sending `SIGINT`, `SIGTERM`, and `SIGKILL` cause the unconditional exit of the - target process. Note that Windows does not support sending Signals, but Node.js offers some emulation with `process.kill()`, and `child_process.kill()`. Sending signal `0` -can be used to test for the existence of a process +can be used to test for the existence of a process. Sending `SIGINT`, +`SIGTERM`, and `SIGKILL` cause the unconditional termination of the target +process. ## process.stdout