docs/67806: Let 5.x users know how to boot into single user mode in cutting-edge.

[Peter Pentchev]

Synopsis: Let 5.x users know how to boot into single user mode in cutting-edge.

State-Changed-From-To: open->feedback
State-Changed-By: roam
State-Changed-When: Thu Jul 22 14:39:18 GMT 2004
State-Changed-Why: 
What do y'all think about the following patch?  In case GNATS mangles
it, you can fetch it from
http://people.FreeBSD.org/~roam/doc/boot-single.patch

Index: doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml,v
retrieving revision 1.203
diff -u -r1.203 chapter.sgml
--- doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml	6 Jul 2004 15:09:54 -0000	1.203
+++ doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml	22 Jul 2004 14:34:13 -0000
@@ -748,9 +748,24 @@
       <para>from a running system, which will drop it to single user
 	mode.</para>
 
-      <para>Alternatively, reboot the system, and at the boot prompt,
-        enter the <option>-s</option> flag.  The system will then boot
-	single user.  At the shell prompt you should then run:</para>
+      <para>Alternatively, reboot the system.  When the <link
+	linkend="boot-loader">boot loader</link> starts and displays the
+	message <quote>Booting [<filename>/kernel</filename>] in 10
+	seconds</quote>, press <keycap>Space</keycap> (or any key but
+	<keycap>Enter</keycap>) to interrupt the countdown and display the
+	loader prompt, then enter the <command>boot -s</command> command.
+	The system will then boot in single user mode.</para>
+
+      <note>
+	<para>If you are using &os.current;, the loader does not display a
+	  countdown, but a full-screen menu instead.  Press the appropriate
+	  key to invoke the <quote>Boot &os; in single user mode</quote>
+	  option; it is usually <keycap>4</keycap>, but may differ if you
+	  have customized your loader menu.</para>
+      </note>
+
+      <para>Once you have dropped the system into single user mode, run the
+	following commands at the shell prompt:</para>
 
       <screen>&prompt.root; <userinput>fsck -p</userinput>
 &prompt.root; <userinput>mount -u /</userinput>

http://www.freebsd.org/cgi/query-pr.cgi?pr=67806