From ef34881158cd05335f7a3dd9de506d31e45c59e8 Mon Sep 17 00:00:00 2001
From: Laurent Bercot <ska-skaware@skarnet.org>
Date: Tue, 28 Jun 2022 20:54:28 +0000
Subject:  Doc obfuscation: does init have 3 or 4 stages?

Signed-off-by: Laurent Bercot <ska@appnovation.com>
---
 doc/s6-svscan-1.html | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

(limited to 'doc/s6-svscan-1.html')

diff --git a/doc/s6-svscan-1.html b/doc/s6-svscan-1.html
index c168c4d..c947637 100644
--- a/doc/s6-svscan-1.html
+++ b/doc/s6-svscan-1.html
@@ -38,7 +38,13 @@ bit of understanding of what is going on.
 </a>
 
 <p>
- The life of a Unix machine has four stages:
+<small> Okay, it's actually four, but the fourth stage is an implementation
+detail that users don't care about, so we'll stick with three. </small>
+</p>
+
+<p>
+ The life of a Unix machine has three stages.
+ <small>Yes, three.</small>
 </p>
 
 <ol>
@@ -68,6 +74,11 @@ filesystems are unmounted, and the system call that reboots the machine or
 powers it off is called. </li>
 </ol>
 
+<p>
+<small> Unless you're implementing a shutdown procedure over a supervision
+tree, you can absolutely consider that the hardware shutdown is part of stage 3. </small>
+</p>
+
 <p>
  As you can see, process 1's duties are <em>radically different</em> from
 one stage to the next, and init has the most work when the machine
-- 
cgit v1.2.3