From 27708fe87316d11b8d99459db257d381ee049430 Mon Sep 17 00:00:00 2001
From: Chris Knight <cknight1234@gmail.com>
Date: Wed, 27 May 2020 03:12:02 +0100
Subject: doc: various runtime doc updates (#5885)

---
 docs/runtime/program_lifecycle.md | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

(limited to 'docs/runtime/program_lifecycle.md')

diff --git a/docs/runtime/program_lifecycle.md b/docs/runtime/program_lifecycle.md
index 4a94d6724..7f6035048 100644
--- a/docs/runtime/program_lifecycle.md
+++ b/docs/runtime/program_lifecycle.md
@@ -8,8 +8,9 @@ for `unload` events need to be synchronous. Both events cannot be cancelled.
 
 Example:
 
+**main.ts**
+
 ```ts
-// main.ts
 import "./imported.ts";
 
 const handler = (e: Event): void => {
@@ -29,8 +30,11 @@ window.onunload = (e: Event): void => {
 };
 
 console.log("log from main script");
+```
+
+**imported.ts**
 
-// imported.ts
+```ts
 const handler = (e: Event): void => {
   console.log(`got ${e.type} event in event handler (imported)`);
 };
@@ -68,3 +72,7 @@ got unload event in event handler (main)
 All listeners added using `window.addEventListener` were run, but
 `window.onload` and `window.onunload` defined in `main.ts` overrode handlers
 defined in `imported.ts`.
+
+In other words, you can register multiple `window.addEventListener` `"load"` or
+`"unload"` events, but only the last loaded `window.onload` or `window.onunload`
+events will be executed.
-- 
cgit v1.2.3