svn commit: r44627 - head/en_US.ISO8859-1/books/handbook/boot

Dru Lavigne dru at FreeBSD.org
Tue Apr 22 16:40:50 UTC 2014


Author: dru
Date: Tue Apr 22 16:40:50 2014
New Revision: 44627
URL: http://svnweb.freebsd.org/changeset/doc/44627

Log:
  Editorial review of boot splash screen section.
  
  Sponsored by:	iXsystems

Modified:
  head/en_US.ISO8859-1/books/handbook/boot/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/boot/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/boot/chapter.xml	Tue Apr 22 15:49:54 2014	(r44626)
+++ head/en_US.ISO8859-1/books/handbook/boot/chapter.xml	Tue Apr 22 16:40:50 2014	(r44627)
@@ -653,43 +653,28 @@ console none                            
 	  </authorgroup>
       </info>
 
-      <para>The splash screen creates an alternate boot screen.  The
-	splash screen hides all the boot probe messages and service
-	startup messages before displaying either a command line or
-	graphical login prompt.</para>
+      <para>Typically when a &os; system boots, it displays its
+	progress as a series of messages at the console. A boot splash
+	screen creates an alternate boot screen that
+	hides all of the boot probe and service
+	startup messages.  A few boot loader messages, including the boot options
+	menu and a timed wait countdown prompt, are displayed at
+	boot time, even when the splash screen is enabled.  The display of the splash screen
+	can be turned off by hitting any
+	key on the keyboard during the boot process.</para>
 
       <para>There are two basic environments available in &os;.  The
 	first is the default legacy virtual console command line
 	environment.  After the system finishes booting, a console
-	login prompt is presented.  The second environment is the
-	graphical environment as described in <xref linkend="x11"/>.
-	Refer to that chapter for more information on how to install
+	login prompt is presented.  The second environment is a configured
+	graphical environment.  Refer to <xref linkend="x11"/>
+	for more information on how to install
 	and configure a graphical display manager and a graphical
 	login manager.</para>
 
-      <para>The splash screen function supports 256-colors in the
-	bitmap (<filename>.bmp</filename>), ZSoft
-	<acronym>PCX</acronym> (<filename>.pcx</filename>), or
-	TheDraw (<filename>.bin</filename>) formats.  The splash image
-	files must have a resolution of 320 by 200 pixels or less in
-	order to work on standard VGA adapters.</para>
-
-      <para>To use larger images, up to the maximum resolution of
-	1024 by 768 pixels, load the <acronym>VESA</acronym> module
-	during system boot.  For a custom kernel, as described in
-	<xref linkend="kernelconfig"/>, include the
-	<literal>VESA</literal> kernel configuration option.  Loading
-	<acronym>VESA</acronym> support provides the ability to
-	display a splash screen image that fills the whole display
-	screen.</para>
-
-      <para>While the splash screen is being displayed during the
-	booting process, it can be turned off any time by hitting any
-	key on the keyboard.</para>
-
-      <para>The splash screen also defaults to being a screen saver
-	outside.  After a time period of non-use, the splash screen
-	will be displayed and will cycle through steps of changing
+      <para>Once the system has booted, the splash screen defaults to being a screen saver.
+	After a time period of non-use, the splash screen
+	will display and will cycle through steps of changing
 	intensity of the image, from bright to very dark and over
 	again.  The configuration of the splash screen saver can be
 	overridden by adding a <literal>saver=</literal> line to
@@ -699,67 +684,60 @@ console none                            
 	consoles and has no effect on graphical display
 	managers.</para>
 
-      <para>A few boot loader messages, including the boot options
-	menu and a timed wait count down prompt, are displayed at
-	boot time, even when the splash screen is enabled.</para>
-
       <para>Sample splash screen files can be downloaded from the
 	gallery at <link
 	  xlink:href="http://artwork.freebsdgr.org/node/3/">http://artwork.freebsdgr.org</link>.
 	By installing the
-	<package>sysutils/bsd-splash-changer</package> port, splash
-	images can be chosen from a collection randomly at each
+	<package>sysutils/bsd-splash-changer</package> package or port, a random splash
+	image from a collection will display at
 	boot.</para>
 
-      <para>The splash screen <filename>.bmp</filename>,
+      <para>The splash screen function supports 256-colors in the
+	bitmap (<filename>.bmp</filename>), ZSoft
+	<acronym>PCX</acronym> (<filename>.pcx</filename>), or
+	TheDraw (<filename>.bin</filename>) formats.  The <filename>.bmp</filename>,
 	<filename>.pcx</filename>, or <filename>.bin</filename> image
 	has to be placed on the root partition, for example in
-	<filename>/boot</filename>.</para>
-
-      <para>For the default boot display resolution of 256-colors and
-	320 by 200 pixels or less, edit
-	<filename>/boot/loader.conf</filename> so it contains the
-	following:</para>
+	<filename>/boot</filename>.  The splash image
+	files must have a resolution of 320 by 200 pixels or less in
+	order to work on standard <acronym>VGA</acronym> adapters.
+	For the default boot display resolution of 256-colors and
+	320 by 200 pixels or less, add the following lines to
+	<filename>/boot/loader.conf</filename>.
+	Replace <replaceable>splash.bmp</replaceable> with the name of
+	the bitmap file to use:</para>
 
       <programlisting>splash_bmp_load="YES"
 bitmap_load="YES"
-bitmap_name="<replaceable>/boot/splash.bmp</replaceable>"</programlisting>
+bitmap_name="/boot/<replaceable>splash.bmp</replaceable>"</programlisting>
 
-      <para>For larger video resolutions up to the maximum of 1024 by
-	768 pixels, edit <filename>/boot/loader.conf</filename>, so it
-	contains the following:</para>
-
-      <programlisting>vesa_load="YES"
-splash_bmp_load="YES"
-bitmap_load="YES"
-bitmap_name="<replaceable>/boot/splash.bmp</replaceable>"</programlisting>
-
-      <para>This example assumes that
-	<filename><replaceable>/boot/splash.bmp</replaceable></filename>
-	is used for the splash screen.  To use a
-	<acronym>PCX</acronym> file, use the following statements,
-	plus the <literal>vesa_load="YES"</literal> line, depending on
-	the resolution:</para>
+      <para>To use a
+	<acronym>PCX</acronym> file instead of a bitmap file:</para>
 
       <programlisting>splash_pcx_load="YES"
 bitmap_load="YES"
-bitmap_name="<replaceable>/boot/splash.pcx</replaceable>"</programlisting>
+bitmap_name="/boot/<replaceable>splash.pcx</replaceable>"</programlisting>
 
-      <para>Beginning with &os; 8.3, another option is to use
-	ASCII art in <link
-	  xlink:href="https://en.wikipedia.org/wiki/TheDraw">TheDraw</link>
-	format.</para>
+      <para>To instead use
+	ASCII art in the <link
+	  xlink:href="https://en.wikipedia.org/wiki/TheDraw">https://en.wikipedia.org/wiki/TheDraw</link>
+	format:</para>
 
       <programlisting>splash_txt="YES"
 bitmap_load="YES"
-bitmap_name="<replaceable>/boot/splash.bin</replaceable>"</programlisting>
+bitmap_name="/boot/<replaceable>splash.bin</replaceable>"</programlisting>
+
+      <para>To use larger images that fill the whole display
+	screen, up to the maximum resolution of
+	1024 by 768 pixels, the <acronym>VESA</acronym> module
+	must also be loaded during system boot.  If using a custom kernel, ensure
+	that the custom kernel configuration file includes the
+	<literal>VESA</literal> kernel configuration option.  To load
+	the <acronym>VESA</acronym> module for the splash screen, add
+	this line to <filename>/boot/loader.conf</filename> before the
+	three lines mentioned in the above examples:</para>
 
-      <para>The file name is not restricted to <quote>splash</quote>
-	as shown in the above example.  It can be anything as long as
-	it is one of the supported types such as,
-	<filename><replaceable>splash_640x400</replaceable>.bmp</filename>
-	or
-	<filename><replaceable>bluewave</replaceable>.pcx</filename>.</para>
+      <programlisting>vesa_load="YES"</programlisting>
 
       <para>Other interesting <filename>loader.conf</filename> options
 	include:</para>
@@ -783,7 +761,7 @@ bitmap_name="<replaceable>/boot/splash.b
 	  <listitem>
 	    <para>This will replace the default words
 	      <quote>&os;</quote>, which are displayed to the right of
-	      the boot options menu with the colored beastie
+	      the boot options menu, with the colored beastie
 	      logo.</para>
 	  </listitem>
 	</varlistentry>


More information about the svn-doc-all mailing list