From nobody@FreeBSD.org  Thu Jun 10 19:19:03 2004
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 886AA16A4CE
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 10 Jun 2004 19:19:03 +0000 (GMT)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 6E8C343D48
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 10 Jun 2004 19:19:03 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.12.11/8.12.11) with ESMTP id i5AJIZYW045532
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 10 Jun 2004 19:18:35 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.12.11/8.12.11/Submit) id i5AJIZXG045508;
	Thu, 10 Jun 2004 19:18:35 GMT
	(envelope-from nobody)
Message-Id: <200406101918.i5AJIZXG045508@www.freebsd.org>
Date: Thu, 10 Jun 2004 19:18:35 GMT
From: "Liam J. Foy" <liamfoy@sepulcrum.org>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Let 5.x users know how to boot into single user mode in cutting-edge.
X-Send-Pr-Version: www-2.3

>Number:         67806
>Category:       docs
>Synopsis:       [patch] Let 5.x users know how to boot into single user mode in cutting-edge part of handbook.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jun 10 19:20:17 GMT 2004
>Closed-Date:    Mon Nov 06 15:00:48 GMT 2006
>Last-Modified:  Mon Nov 06 15:00:48 GMT 2006
>Originator:     Liam J. Foy
>Release:        
>Organization:
Sepulcrum
>Environment:
FreeBSD liamfoy.ath.cx 5.2-RELEASE FreeBSD 5.2-RELEASE #2: Mon Mar 29 17:52:08 BST 2004     liamfoy@:/usr/obj/usr/src/sys/Ecthelion  i386

>Description:
Current documentation shows 4.x users how to reboot into single user mode, but does not mention how to in 5.x. Although it may be obvious, I still think it needs to be mentioned.
>How-To-Repeat:
      
>Fix:
Patch can be viewed at: http://liamfoy.kerneled.org/fix.diff
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-advocacy->freebsd-docs 
Responsible-Changed-By: ceri 
Responsible-Changed-When: Thu Jun 10 19:33:06 GMT 2004 
Responsible-Changed-Why:  
This is docs@ fodder. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=67806 
Responsible-Changed-From-To: freebsd-docs->freebsd-doc 
Responsible-Changed-By: ceri 
Responsible-Changed-When: Thu Jun 10 19:35:33 GMT 2004 
Responsible-Changed-Why:  
Just. Don't. Say. Anything. 

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

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: "Liam J. Foy" <liamfoy@sepulcrum.org>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/67806: Let 5.x users know how to boot into single user mode in cutting-edge.
Date: Wed, 7 Jul 2004 22:44:44 +0300

 > Patch can be viewed at: http://liamfoy.kerneled.org/fix.diff
 
 When the patch is a minor edit like this one, it usually isn't a very
 serious problem to see the entire diff as part of the PR text IMHO :)
 
 : --- /hd3/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml	Thu Jun 10 19:51:47 2004
 : +++ /hd3/chapter.sgml	Thu Jun 10 19:59:56 2004
 : @@ -749,8 +749,9 @@
 :  	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>
 : +        enter the <option>-s</option> flag (5.x users press 4 at boot 
 : +	up menu). The system will then boot single user.  At the shell 
 : +	prompt you should then run:</para>
 :  
 :        <screen>&prompt.root; <userinput>fsck -p</userinput>
 :  &prompt.root; <userinput>mount -u /</userinput>
 
 Two comments:
 
 a. Your editor seems to be inserting trailing whitespace when lines are
 wrapped.  This means that the lines starting with + in the diff above
 insert whitespace that someone will have to delete later.
 
 b. Is "just press 4" some magic key combo for the boot loader of 5.X?
 I've been using a lot of different keys: SPACE, RETURN, ESC are a few of
 those.  There is nothing different to the boot process of 5.X regarding
 single-user mode AFAIK.
 
 Did I miss/overlook  something?
 
State-Changed-From-To: open->feedback 
State-Changed-By: keramida 
State-Changed-When: Thu Jul 8 16:09:31 GMT 2004 
State-Changed-Why:  
I don't think there is any significant difference when booting 5.X into 
single-user mode.  Have I misunderstood your suggestion or the text of 
your proposed change? 

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

From: des@des.no (=?iso-8859-1?q?Dag-Erling_Sm=F8rgrav?=)
To: Giorgos Keramidas <keramida@FreeBSD.org>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/67806: Let 5.x users know how to boot into single user
 mode in cutting-edge.
Date: Thu, 08 Jul 2004 23:48:54 +0200

 Giorgos Keramidas <keramida@FreeBSD.org> writes:
 > I don't think there is any significant difference when booting 5.X into
 > single-user mode.  Have I misunderstood your suggestion or the text of
 > your proposed change?
 
 There *is* a difference.  First of all, the original text is incorrect
 even for 4.x (it should say "wait until the countdown, press enter,
 type 'boot -s' and press enter again" since 4.x has /boot/loader).
 Second, a default 5.x installation has the horrid daemon menu, where
 you press 4 to get single-user mode (or 6 to get the loader prompt, at
 which point you type 'boot -s' as in 4.x)
 
 DES
 --=20
 Dag-Erling Sm=F8rgrav - des@des.no
State-Changed-From-To: feedback->open 
State-Changed-By: keramida 
State-Changed-When: Thu Jul 8 22:10:33 GMT 2004 
State-Changed-Why:  
Doug-Erling explained to me what I was missing.  Put this back into 
the pool of open PRs. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=67806 
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 

From: "Simon L. Nielsen" <simon@FreeBSD.org>
To: Peter Pentchev <roam@FreeBSD.org>
Cc: freebsd-gnats-submit@FreeBSD.org, liamfoy@sepulcrum.org
Subject: Re: docs/67806: Let 5.x users know how to boot into single user mode in cutting-edge.
Date: Thu, 22 Jul 2004 20:40:16 +0200

 --E13BgyNx05feLLmH
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 On 2004.07.22 14:41:18 +0000, Peter Pentchev wrote:
 
 > What do y'all think about the following patch?
 
 Since we are getting closer and closer to 5.X as -STABLE I personally
 prefer to start making 4.X the exception, rather than the other way
 around, so 5.X is described and the 4.X behavior is in a "<note>", but
 that might just be me...
 
 > Index: doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml
 > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 > RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chap=
 ter.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 20=
 04 15:09:54 -0000	1.203
 > +++ doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml	22 Jul 2=
 004 14:34:13 -0000
 > @@ -748,9 +748,24 @@
 >        <para>from a running system, which will drop it to single user
 >  	mode.</para>
 > =20
 > -      <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=3D"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
 
 I think "&os;&nbsp;5.X" is better since hopefully we should have
 5.3-STABLE in a few months.
 
 --=20
 Simon L. Nielsen
 FreeBSD Documentation Team
 
 --E13BgyNx05feLLmH
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.2.4 (FreeBSD)
 
 iD8DBQFBAAoPh9pcDSc1mlERArpiAJ4wZ8SSbYsBz9dnIb1oNeeZFIKHiQCbBC/m
 Iu4nkAymR8eel0pcHgVPbwY=
 =Z6Pe
 -----END PGP SIGNATURE-----
 
 --E13BgyNx05feLLmH--
State-Changed-From-To: feedback->closed 
State-Changed-By: trhodes 
State-Changed-When: Mon Nov 6 14:59:53 UTC 2006 
State-Changed-Why:  
Closed.  The handbook no longer documents FreeBSD 4.X or 
5.X behavior.  Older versions of the handbook are available 
at http://docs.FreeBSD.org.  Thanks! 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Mon Nov 6 14:59:53 UTC 2006 
Responsible-Changed-Why:  
Over to me. 

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