Replace onExit() with process.addListener("exit")

- Update documentation.

- Depreciation message for onExit().

src/node.js

@@ -124,13 +124,15 @@ node.Module.prototype.load = function (callback) {
 
     self.onLoad = self.target.__onLoad;
     self.onExit = self.target.__onExit;
-
+    if (self.onLoad || self.onExit) {
-    self.waitChildrenLoad(function () {
-      if (self.onLoad) {
       node.stdio.writeError( "(node) onLoad is depreciated it will be "
                            + "removed in the future. Don't want it to "
                            + "leave? Discuss on mailing list.\n"
                            );
+    }
+
+    self.waitChildrenLoad(function () {
+      if (self.onLoad) {
         self.onLoad();
       }
       self.loaded = true;
@@ -205,6 +207,7 @@ node.Module.prototype.exit = function (callback) {
 
   node.exit = function (code) {
     root_module.exit(function () {
+      process.emit("exit");
       node.reallyExit(code);
     });
   };

test/mjsunit/fixtures/a.js

@@ -13,6 +13,6 @@ exports.D = function () {
   return c.D();
 };
 
-function onExit () {
+process.addListener("exit", function () {
   string = "A done";
-}
+});

test/mjsunit/fixtures/b/c.js

@@ -10,6 +10,6 @@ exports.D = function () {
   return d.D();
 };
 
-function onExit () {
+process.addListener("exit", function () {
   string = "C done";
-}
+});

test/mjsunit/fixtures/b/d.js

@@ -4,7 +4,7 @@ exports.D = function () {
   return string;
 };
 
-function onExit () {
+process.addListener("exit", function () {
   string = "D done";
-}
+});
 

test/mjsunit/test-event-emitter-add-listeners.js

@@ -21,9 +21,9 @@ puts("start");
 
 e.emit("hello", ["a", "b"]);
 
-function onExit () {
+process.addListener("exit", function () {
   assertArrayEquals(["hello"], events_new_listener_emited);
   assertEquals(1, times_hello_emited);
-}
+});
 
 

test/mjsunit/test-file-cat-noexist.js

@@ -16,6 +16,6 @@ promise.addErrback(function () {
   got_error = true;
 });
 
-function onExit () {
+process.addListener("exit", function () {
   assertTrue(got_error);
-}
+});

test/mjsunit/test-fs-stat.js

@@ -16,9 +16,9 @@ promise.addErrback(function () {
   got_error = true;
 });
 
-function onExit () {
+process.addListener("exit", function () {
   assertTrue(got_success);
   assertFalse(got_error);
   assertTrue(stats.mtime instanceof Date);
-}
+});
 

test/mjsunit/test-http-cat.js

@@ -28,7 +28,7 @@ node.http.cat("http://localhost:12312/", "utf8").addErrback(function () {
   bad_server_got_error = true;
 });
 
-function onExit () {
+process.addListener("exit", function () {
   assertTrue(got_good_server_content);
   assertTrue(bad_server_got_error);
-}
+});

test/mjsunit/test-http-client-race.js

@@ -35,7 +35,7 @@ client.get("/1").finish(function (res1) {
   });
 });
 
-function onExit () {
+process.addListener("exit", function () {
   assertEquals(body1_s, body1);
   assertEquals(body2_s, body2);
-}
+});

test/mjsunit/test-http-client-upload.js

@@ -43,8 +43,8 @@ req.finish(function(res) {
   });
 });
 
-function onExit () {
+process.addListener("exit", function () {
   assertEquals("1\n2\n3\n", sent_body);
   assertTrue(server_req_complete);
   assertTrue(client_res_complete);
-}
+});

test/mjsunit/test-http-proxy.js

@@ -47,6 +47,6 @@ req.finish(function (res) {
   });
 });
 
-function onExit () {
+process.addListener("exit", function () {
   assertEquals(body, "hello world\n");
-}
+});

test/mjsunit/test-http-server.js

@@ -59,7 +59,7 @@ c.addListener("close", function () {
   assertEquals(c.readyState, "closed");
 });
 
-function onExit () {
+process.addListener("exit", function () {
   assertEquals(2, request_number);
   assertEquals(2, requests_sent);
 
@@ -70,4 +70,4 @@ function onExit () {
   assertTrue(quit.exec(server_response) != null);
 
   assertTrue(client_got_eof);
-}
+});

test/mjsunit/test-http.js

@@ -56,7 +56,7 @@ setTimeout(function () {
   });
 }, 1);
 
-function onExit () {
+process.addListener("exit", function () {
   node.debug("responses_recvd: " + responses_recvd);
   assertEquals(2, responses_recvd);
 
@@ -65,5 +65,5 @@ function onExit () {
 
   assertEquals("The path was /hello", body0);
   assertEquals("The path was /world", body1);
-}
+});
 

test/mjsunit/test-module-loading.js

@@ -20,7 +20,7 @@ assertEquals("D", d.D());
 assertInstanceof(d2.D, Function);
 assertEquals("D", d2.D());
 
-function onExit () {
+process.addListener("exit", function () {
   assertInstanceof(a.A, Function);
   assertEquals("A done", a.A());
 
@@ -35,4 +35,4 @@ function onExit () {
 
   assertInstanceof(d2.D, Function);
   assertEquals("D done", d2.D());
-}
+});

test/mjsunit/test-node-cat.js

@@ -45,7 +45,7 @@ promise.addErrback(function () {
   errors += 1;
 });
 
-function onExit () {
+process.addListener("exit", function () {
   assertEquals(2, successes);
   assertEquals(0, errors);
-}
+});

test/mjsunit/test-process-buffering.js

@@ -24,6 +24,6 @@ pwd(function (result) {
   assertEquals("\n", result[result.length-1]);
 });
 
-function onExit () {
+process.addListener("exit", function () {
   assertTrue(pwd_called);
-}
+});

test/mjsunit/test-process-kill.js

@@ -10,6 +10,6 @@ cat.addListener("exit", function (status) { exit_status = status; });
 
 cat.kill();
 
-function onExit () {
+process.addListener("exit", function () {
   assertTrue(exit_status > 0);
-}
+});

test/mjsunit/test-process-simple.js

@@ -28,7 +28,7 @@ cat.write("hello");
 cat.write(" ");
 cat.write("world");
 
-function onExit () {
+process.addListener("exit", function () {
   assertEquals(0, exit_status);
   assertEquals("hello world", response);
-}
+});

test/mjsunit/test-process-spawn-loop.js

@@ -22,6 +22,6 @@ function spawn (i) {
 
 spawn(0);
 
-function onExit () {
+process.addListener("exit", function () {
   assertTrue(finished);
-}
+});

test/mjsunit/test-promise-wait.js

@@ -73,10 +73,10 @@ assertArrayEquals(["a","b","c"], ret4);
 
 assertTrue(p4_done);
 
-function onExit() {
+process.addListener("exit", function () {
   assertTrue(p1_done);
   assertTrue(p2_done);
   assertTrue(p3_done);
   assertTrue(p4_done);
   assertTrue(p5_done);
-}
+});

test/mjsunit/test-tcp-many-clients.js

@@ -62,7 +62,7 @@ for (var i = 0; i < concurrency; i++) {
   });
 }
 
-function onExit () {
+process.addListener("exit", function () {
   assertEquals(connections_per_client * concurrency, total_connections);
   puts("\nokay!");
-}
+});

test/mjsunit/test-tcp-pingpong-delay.js

@@ -85,6 +85,6 @@ function pingPongTest (port, host, on_complete) {
 
 pingPongTest(21988);
 
-function onExit () {
+process.addListener("exit", function () {
   assertEquals(1, tests_run);
-}
+});

test/mjsunit/test-tcp-pingpong.js

@@ -82,6 +82,6 @@ pingPongTest(20989, "localhost");
 pingPongTest(20988, null);
 pingPongTest(20997, "::1");
 
-function onExit () {
+process.addListener("exit", function () {
   assertEquals(3, tests_run);
-}
+});

test/mjsunit/test-tcp-raw.js

@@ -36,10 +36,10 @@ c.addListener("close", function () {
   echoServer.close();
 });
 
-function onExit () {
+process.addListener("exit", function () {
   var expected = [];
   for (var i = 0; i < 256; i++) {
     expected.push(i);
   }
   assertEquals(expected, recv);
-}
+});

test/mjsunit/test-tcp-reconnect.js

@@ -46,7 +46,7 @@ client.addListener("close", function (had_error) {
     server.close();
 });
 
-function onExit () {
+process.addListener("exit", function () {
   assertEquals(N+1, disconnect_count);
   assertEquals(N+1, client_recv_count);
-}
+});

test/mjsunit/test-tcp-throttle-kernel-buffer.js

@@ -49,7 +49,7 @@ client.addListener("eof", function () {
   client.close();
 });
 
-function onExit () {
+process.addListener("exit", function () {
   assertEquals(N, chars_recved);
   assertTrue(npauses > 2);
-}
+});

test/mjsunit/test-tcp-throttle.js

@@ -61,6 +61,6 @@ client.addListener("eof", function () {
   client.close();
 });
 
-function onExit () {
+process.addListener("exit", function () {
   assertEquals(N, recv.length);
-}
+});

test/mjsunit/test-timers.js

@@ -35,7 +35,7 @@ setInterval(function () {
     clearInterval(this);
 }, 1000);
 
-function onExit () {
+process.addListener("exit", function () {
   assertTrue(setTimeout_called);
   assertEquals(3, interval_count);
-}
+});

website/api.txt

@@ -258,12 +258,12 @@ puts("The area of a cirlce of radius 4 is " + area(4));
 Functions +require_async()+ and +include_async()+ also exist.
 
 
-==== +onExit()+
+==== +process.addListener("exit", function () { })+
 
-When the program exits a callback +onExit()+ will be called for each module
+When the program exits a special object called +process+ will emit an
-(children first).
++"exit"+ event.
 
-The +onExit()+ callback cannot perform I/O since the process is going to
+The +"exit"+ event cannot perform I/O since the process is going to
 forcably exit in less than microsecond. However, it is a good hook to
 perform constant time checks of the module's state. E.G. for unit tests:
 
@@ -276,13 +276,13 @@ setTimeout(function () {
   timer_executed = true
 }, 1000);
 
-function onExit () {
+process.addListener("exit", function () {
   assertTrue(timer_executed);
-}
+});
 ----------------------------------------
 
-Just to reiterate: +onExit()+, is not the place to close files or shutdown
+Just to reiterate: the +"exit"+ event, is not the place to close files or
-servers. The process will exit before they get performed. 
+shutdown servers. The process will exit before they get performed.