From nobody@FreeBSD.org  Wed Oct 24 05:40:55 2012
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 69C052D5
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 24 Oct 2012 05:40:55 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 519CB8FC0C
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 24 Oct 2012 05:40:55 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.5/8.14.5) with ESMTP id q9O5etMb028393
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 24 Oct 2012 05:40:55 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.5/8.14.5/Submit) id q9O5esjP028392;
	Wed, 24 Oct 2012 05:40:54 GMT
	(envelope-from nobody)
Message-Id: <201210240540.q9O5esjP028392@red.freebsd.org>
Date: Wed, 24 Oct 2012 05:40:54 GMT
From: Mehmet Erol Sanliturk <m.e.sanliturk@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: FreeBSD Boot Menu Documentation
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         173013
>Category:       docs
>Synopsis:       FreeBSD Boot Menu documentation lacks detail
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    dru
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Oct 24 05:50:01 UTC 2012
>Closed-Date:    Tue May 20 17:07:17 UTC 2014
>Last-Modified:  Tue May 20 17:10:00 UTC 2014
>Originator:     Mehmet Erol Sanliturk
>Release:        
>Organization:
>Environment:
>Description:
FreeBSD Boot Menu Documentation 


In page

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/install-start.html

there is a "Figure 2-1. FreeBSD Boot Loader Menu" .


To my knowledge , nowhere there is a sufficient information about items in that menu , 
one by one .

A good documentation of that menu ,

especially for items 
( 3 ) ( Safe Mode ) , 
( 4 ) ( Single User Mode ) , 
( 6 ) ( Loader Prompt ) ,
and what can be done if these items are selected , 

may  be a very useful addition to 

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/boot.html
Chapter 13 The FreeBSD Booting Process

Especially , if a less experienced about FreeBSD person prepares such a documentation
it may be very valuable guide to new users , because
when such documents are prepared by very experienced persons , their 
"assumed knowledge" is not reflected in the documentation .


Thank you very much .

Mehmet Erol Sanliturk



>How-To-Repeat:
See the current FreeBSD handbook .

>Fix:


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->dru 
Responsible-Changed-By: dru 
Responsible-Changed-When: Tue May 20 17:06:20 UTC 2014 
Responsible-Changed-Why:  
Take 

http://www.freebsd.org/cgi/query-pr.cgi?pr=173013 
State-Changed-From-To: open->closed 
State-Changed-By: dru 
State-Changed-When: Tue May 20 17:06:42 UTC 2014 
State-Changed-Why:  
Addressed in r44885. 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/173013: commit references a PR
Date: Tue, 20 May 2014 17:05:18 +0000 (UTC)

 Author: dru
 Date: Tue May 20 17:05:14 2014
 New Revision: 44885
 URL: http://svnweb.freebsd.org/changeset/doc/44885
 
 Log:
   Add images for boot loader and boot options menus.
   Describe these menus.
   The rest of this section needs to be reviewed for the boot probe and initial
   installer menu, will be in next commit.
   
   PR:	173013
   Sponsored by:	iXsystems
 
 Added:
   head/en_US.ISO8859-1/books/handbook/bsdinstall/bsdinstall-boot-options-menu.png   (contents, props changed)
   head/en_US.ISO8859-1/books/handbook/bsdinstall/bsdinstall-newboot-loader-menu.png   (contents, props changed)
 Modified:
   head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml
 
 Added: head/en_US.ISO8859-1/books/handbook/bsdinstall/bsdinstall-boot-options-menu.png
 ==============================================================================
 Binary file. No diff available.
 
 Added: head/en_US.ISO8859-1/books/handbook/bsdinstall/bsdinstall-newboot-loader-menu.png
 ==============================================================================
 Binary file. No diff available.
 
 Modified: head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml
 ==============================================================================
 --- head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml	Tue May 20 14:56:39 2014	(r44884)
 +++ head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml	Tue May 20 17:05:14 2014	(r44885)
 @@ -778,13 +778,13 @@ Ethernet address 0:3:ba:b:92:d4, Host ID
  	    <para>Once the system boots from the installation media,
  	      a menu similar to the following will be displayed:</para>
  
 -	    <figure xml:id="bsdinstall-boot-loader-menu">
 +	    <figure xml:id="bsdinstall-newboot-loader-menu">
  	      <title>&os; Boot Loader Menu</title>
  
  	      <mediaobject>
  		<imageobject>
  		  <imagedata
 -		    fileref="bsdinstall/bsdinstall-boot-loader-menu"/>
 +		    fileref="bsdinstall/bsdinstall-newboot-loader-menu"/>
  		</imageobject>
  	      </mediaobject>
  	    </figure>
 @@ -792,8 +792,106 @@ Ethernet address 0:3:ba:b:92:d4, Host ID
        <para>By default, the menu will wait ten seconds for user
  	input before booting into the &os; installer or, if &os; is
  	already installed, before booting into &os;.  To pause the
 -	boot timer, press <keycap>Space</keycap>.</para>
 -    
 +	boot timer in order to review the selections, press
 +	<keycap>Space</keycap>.  To select an option, press its
 +	highlighted number, character, or key.  The following options
 +	are available.</para>
 +
 +      <itemizedlist>
 +	<listitem>
 +	  <para><literal>Boot Multi User</literal>: This will
 +	    continue the &os; boot process.  If the boot timer has
 +	    been paused, press <keycap>1</keycap>, upper- or
 +	    lower-case <keycap>B</keycap>, or
 +	    <keycap>Enter</keycap>.</para>
 +	</listitem>
 +
 +	<listitem>
 +	  <para><literal>Boot Single User</literal>: This mode can be
 +	    used to fix an existing &os; installation as described in
 +	    <xref linkend="boot-singleuser"/>.  Press
 +	    <keycap>2</keycap> or the upper- or lower-case
 +	    <keycap>S</keycap> to enter this mode.</para>
 +	</listitem>
 +
 +	<listitem>
 +	  <para><literal>Escape to loader prompt</literal>: This will
 +	    boot the system into a repair prompt that contains a
 +	    limited number of low-level commands.  This prompt is
 +	    described in <xref linkend="boot-loader"/>.  Press
 +	    <keycap>3</keycap> or <keycap>Esc</keycap> to boot into
 +	    this prompt.</para>
 +	</listitem>
 +
 +	<listitem>
 +	  <para><literal>Reboot</literal>: Reboots the system.</para>
 +	</listitem>
 +
 +	<listitem>
 +	  <para><literal>Configure Boot Options</literal>: Opens the
 +	    menu shown in, and described under, <xref
 +	      linkend="bsdinstall-boot-options-menu"/>.</para>
 +	</listitem>
 +      </itemizedlist> 
 +
 +	    <figure xml:id="bsdinstall-boot-options-menu">
 +	      <title>&os; Boot Options Menu</title>
 +
 +	      <mediaobject>
 +		<imageobject>
 +		  <imagedata
 +		    fileref="bsdinstall/bsdinstall-boot-options-menu"/>
 +		</imageobject>
 +	      </mediaobject>
 +	    </figure>
 +
 +      <para>The boot options menu is divided into two sections.  The
 +	first section can be used to either return to the main boot
 +	menu or to reset any toggled options back to their
 +	defaults.</para>
 +
 +      <para>The next section is used to toggle the available options
 +	to <literal>On</literal> or <literal>Off</literal> by pressing
 +	the option's highlighted number or character.  The system will
 +	always boot using the settings for these options until they
 +	are modified.  Several options can be toggled using this
 +	menu:</para>
 +
 +      <itemizedlist>
 +	<listitem>
 +	  <para><literal>ACPI Support</literal>: If the system hangs
 +	    during boot, try toggling this option to
 +	    <literal>Off</literal>.</para>
 +	</listitem>
 +
 +	<listitem>
 +	  <para><literal>Safe Mode</literal>: If the system still
 +	    hangs during boot even with <literal>ACPI
 +	      Support</literal> set to <literal>Off</literal>, try
 +	    setting this option to <literal>On</literal>.</para>
 +	</listitem>
 +
 +	<listitem>
 +	  <para><literal>Single User</literal>: Toggle this option to
 +	    <literal>On</literal> to fix an existing &os; installation
 +	    as described in <xref linkend="boot-singleuser"/>.  Once
 +	    the problem is fixed, set it back to
 +	    <literal>Off</literal>.</para>
 +	</listitem>
 +
 +	<listitem>
 +	  <para><literal>Verbose</literal>: Toggle this option to
 +	    <literal>On</literal> to see more detailed messages during
 +	    the boot process. This can be useful when troubleshooting
 +	    a piece of hardware.</para>
 +	</listitem>
 +      </itemizedlist> 
 +
 +      <para>After making the needed selections, press
 +	<keycap>1</keycap> or <keycap>Backspace</keycap> to return to
 +	 the main boot menu, then press <keycap>Enter</keycap> to
 +	 continue booting into &os;.</para>
 +
        <para>The last few hundred lines that have been displayed on
  	screen are stored and can be reviewed.</para>
  
 _______________________________________________
 svn-doc-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-doc-all
 To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
 
>Unformatted:
