aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRandy Pratt <rpratt@FreeBSD.org>2001-09-01 07:27:25 +0000
committerRandy Pratt <rpratt@FreeBSD.org>2001-09-01 07:27:25 +0000
commitcfed927960959cb19c4d26585b20e25e78ebd9cc (patch)
treebc6180a23133c1684273802653546173fa627455
parent1f29c99f7cd4dd78b648e34a0dea6652ffb76145 (diff)
downloaddoc-cfed927960959cb19c4d26585b20e25e78ebd9cc.tar.gz
doc-cfed927960959cb19c4d26585b20e25e78ebd9cc.zip
Finish the cleanup of sgml markup for <guibutton> and <guimenuitem>.
Revision of text to a more formal tone. Revise parts to reflect the new menus in 4.4 Reviewed by: murray
Notes
Notes: svn path=/head/; revision=10522
-rw-r--r--en_US.ISO8859-1/books/handbook/install/chapter.sgml517
1 files changed, 334 insertions, 183 deletions
diff --git a/en_US.ISO8859-1/books/handbook/install/chapter.sgml b/en_US.ISO8859-1/books/handbook/install/chapter.sgml
index e2bcd06107..2a50d1facf 100644
--- a/en_US.ISO8859-1/books/handbook/install/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/install/chapter.sgml
@@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
- $FreeBSD: doc/en_US.ISO8859-1/books/handbook/install/chapter.sgml,v 1.104 2001/08/30 22:55:47 chern Exp $
+ $FreeBSD: doc/en_US.ISO8859-1/books/handbook/install/chapter.sgml,v 1.105 2001/08/31 14:35:16 rpratt Exp $
-->
<chapter id="install">
@@ -1068,7 +1068,8 @@ Mounting root from ufs:/dev/md0c
<sect2 id="select-doc">
<title>Selecting The Documentation Menu</title>
- <para>From the Main Menu, select "Doc" with the arrow keys and
+ <para>From the Main Menu, select <guimenuitem>Doc</guimenuitem> with
+ the arrow keys and
press <keycap>Enter</keycap>.</para>
<figure id="main-doc">
@@ -1100,7 +1101,8 @@ Mounting root from ufs:/dev/md0c
pressing <keycap>Enter</keycap> will return to the Documentation
Menu.</para>
- <para>To return to the Main Installation Menu, select "Exit" with the
+ <para>To return to the Main Installation Menu, select
+ <guimenuitem>Exit</guimenuitem> with the
arrow keys and press <keycap>Enter</keycap>.</para>
</sect2>
@@ -1108,7 +1110,8 @@ Mounting root from ufs:/dev/md0c
<title>Selecting The Keymap Menu</title>
<para>To change the keyboard mapping, use the arrow keys to select
- "Keymap" from the menu and press <keycap>Enter</keycap></para>
+ <guimenuitem>Keymap</guimenuitem> from the menu and press
+ <keycap>Enter</keycap></para>
<figure id="sysinstall-keymap">
<title>Sysinstall Main Menu</title>
@@ -1123,12 +1126,13 @@ Mounting root from ufs:/dev/md0c
<para>A different keyboard mapping may be chosen by selecting the
menu item using up/down arrow keys and pressing <keycap>Space</keycap>.
Pressing <keycap>Space</keycap> again will unselect the item. When
- finished, choose the [OK] item using the arrow keys and press
+ finished, choose the <guibutton>[ OK ]</guibutton> using the
+ arrow keys and press
<keycap>Enter</keycap>.</para>
<para>Only a partial list is shown in this screen representation.
- Selecting [CANCEL] will use the default keymap and return to the
- Main Install Menu.</para>
+ Selecting <guibutton>[Cancel]</guibutton> will use the default
+ keymap and return to the Main Install Menu.</para>
<figure id="sysinstall-keymap-menu">
<title>Sysinstall Keymap Menu</title>
@@ -1145,7 +1149,8 @@ Mounting root from ufs:/dev/md0c
<sect2 id="viewsetoptions">
<title>Installation Options Screen</title>
- <para>Select "Options" and press <keycap>Enter</keycap></para>
+ <para>Select <guimenuitem>Options</guimenuitem> and press
+ <keycap>Enter</keycap></para>
<figure id="sysinstall-options">
<title>Sysinstall Main Menu</title>
@@ -1172,8 +1177,8 @@ Mounting root from ufs:/dev/md0c
<para>The description of the selected item will appear at the
bottom of the screen highlighted in blue. Notice that one of the
- options is "Use Defaults" to reset all values to startup
- defaults.</para>
+ options is <guimenuitem>Use Defaults</guimenuitem> to reset all
+ values to startup defaults.</para>
<para>Press <keycap>F1</keycap> to read the help screen about the
various options.</para>
@@ -1185,8 +1190,9 @@ Mounting root from ufs:/dev/md0c
<sect2 id="start-install">
<title>Begin A Standard Installation</title>
- <para>The "Standard" installation is the option recommended for those
- new to Unix or FreeBSD. Use the arrow keys to select "Standard" and
+ <para>The <guimenuitem>Standard</guimenuitem> installation is the
+ option recommended for those new to Unix or FreeBSD. Use the arrow
+ keys to select <guimenuitem>Standard</guimenuitem> and
then press <keycap>Enter</keycap> to start the installation.</para>
<figure id="sysinstall-standard">
@@ -1847,7 +1853,8 @@ Mounting root from ufs:/dev/md0c
</mediaobject>
</figure>
- <para>Make sure [OK] is highlighted, then press <keycap>Enter</keycap>
+ <para>Make sure <guibutton>[ OK ]</guibutton> is highlighted, then
+ press <keycap>Enter</keycap>
to continue with the installation.</para>
</sect2>
@@ -2209,9 +2216,15 @@ Mounting root from ufs:/dev/md0c
<para>If a graphical user interface is desired then a distribution
set that is preceded by an <literal>X</literal> should be
chosen. The configuration of XFree86 and selection of a default
- desktop is part of the post-installation steps. For more
- information on the XFree86 distribution see
- <xref linkend="x11">.</para>
+ desktop is part of the post-installation steps.</para>
+
+ <para>The default XFree86 version installed is the 3.x branch. You
+ should check to see whether your video card is supported at the
+ <ulink url="http://www.xfree86.org/">XFree86</ulink> web site.
+ If it is only supported under the 4.x branch, then you will need
+ to install and configure XFree86 4.x after installation. Select a
+ distribution without X and refer to <xref linkend="x11"> for
+ more information.<para>
<para>If compiling a custom kernel is anticipated, select an option
which includes the source code. For more information on why a
@@ -3176,35 +3189,52 @@ To change any of these settings later, edit /etc/rc.conf
<sect2 id="x-server">
<title>Configure X-Server</title>
+ <para>In order to use a graphical user interface such as KDE, GNOME,
+ or others, the X server will need to be configured.</para>
+
+ <para>To see whether your video card is supported, check the
+ <ulink url="http://www.xfree86.org/">XFree86</ulink> web site.
+ If your video card is only supported under XFree86 4.x, refer to
+ <xref linkend="x11"> for installation and configuration.</para>
+
<screen> User Confirmation Requested
Would you like to configure your X server at this time?
[ Yes ] No</screen>
- <para>This can be done later using /stand/sysinstall if you do not
- have graphics card and monitor information handy. Equipment
- damage can occur if settings are incorrect. Select [Yes] and
- press <keycap>Enter</keycap> to proceed with configuring the
- X server.</para>
+ <warning>
+ <para>It is necessary to know your monitor specifications and
+ video card information. Equipment damage can occur if settings
+ are incorrect. If you do not have this information, select
+ <guibutton>[ No ]</guibutton> and perform the configuration
+ after installation when you have the information using
+ <command>/stand/sysinstall</command>, selecting
+ <guimenuitem>Configure</guimenuitem> and then
+ <guimenuitem>XFree86</guimenuitem>.
+ </para>
+ </warning>
- <sect3 id="x-server-config-method">
- <title>Select Configuration Method</title>
- <figure id="xserver2">
- <title>Select Configuration Method Menu</title>
+ <para>If you have graphics card and monitor information, select
+ <guibutton>[ Yes ]</guibutton> and press <keycap>Enter</keycap>
+ to proceed with configuring the X server.</para>
- <mediaobject>
- <imageobject>
- <imagedata fileref="install/xf86setup" format="PNG">
- </imageobject>
- </mediaobject>
- </figure>
+ <figure id="xserver2">
+ <title>Select Configuration Method Menu</title>
- <para>There are several ways to configure the X
- server. <command>XF86Setup</command> is fully graphical and
- probably the easiest. Use the arrow keys to select the
- "XF86Setup" option and press <keycap>Enter</keycap>.</para>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="install/xf86setup" format="PNG">
+ </imageobject>
+ </mediaobject>
+ </figure>
- <screen> Message
+ <para>There are several ways to configure the X
+ server. <application>XF86Setup</application> is fully graphical and
+ probably the easiest. Use the arrow keys to select the
+ <guimenuitem>XF86Setup</guimenuitem> and press
+ <keycap>Enter</keycap>.</para>
+
+ <screen> Message
You have configured and been running the mouse daemon.
Choose "/dev/sysmouse" as the mouse port and "SysMouse" or
"MouseSystems" as the mouse protocol in the X configuration utility.
@@ -3213,165 +3243,251 @@ To change any of these settings later, edit /etc/rc.conf
[ Press enter to continue ]</screen>
- <para>The mouse daemon previously configured has been
- detected. Press <keycap>Enter</keycap> to continue.</para>
+ <para>The indicates that the mouse daemon previously configured has been
+ detected. Press <keycap>Enter</keycap> to continue.</para>
- <screen> Press [Enter] to switch to graphics mode.
+ <screen> Press [Enter] to switch to graphics mode.
This may take a while...
[ OK ]</screen>
- <para>Press <keycap>Enter</keycap> to switch to the graphics mode and
- continue. It will <emphasis>not</emphasis> try to switch to the
- graphics mode until <keycap>Enter</keycap> is pressed. The screen
- will go black and then shortly a screen with a large "X" in the
- center will appear. Be patient and wait.</para>
+ <para>Press <keycap>Enter</keycap> to switch to the graphics mode and
+ continue. It will <emphasis>not</emphasis> try to switch to the
+ graphics mode until <keycap>Enter</keycap> is pressed. The screen
+ will go black and then shortly a screen with a large X in the
+ center will appear. Be patient and wait.</para>
- <para>After a few more moments, the XF86 Setup Introduction will
- appear. Read all instructions <emphasis>carefully</emphasis>.
- Press <keycap>Enter</keycap> to continue.</para>
- </sect3>
+ <para>After a few more moments, the <application>XF86Setup</application>
+ introduction will display. Read all instructions
+ <emphasis>carefully</emphasis>. Press <keycap>Enter</keycap> to
+ continue.</para>
- <sect3 id="x-mouse">
- <title>X-Mouse</title>
+ <procedure>
+ <title><application>XF86Setup</application> Overview</title>
- <para>The mouse is the first item to be configured. The mouse daemon
- was already running and "Emulate3Buttons" was added for my mouse
- type. Click on "Apply" and check the mouse actions are working
- properly.</para>
- </sect3>
+ <para>There are several areas of configuration to be completed.
+ The configuration choices you make will depend on the hardware
+ in the system so only a general overview can be given here.</para>
- <sect3 id="x-keyboard">
- <title>X-Keyboard</title>
+ <para>Along the top of the configuration tool there are buttons
+ indicating the areas to be configured. You should be able to use
+ the mouse if it was previously configured and select each item by
+ clicking on it. Review each area and make appropriate selections
+ for your system.</para>
- <para>Click on the "Keyboard" menu item.</para>
+ <step>
+ <title><guimenuitem>Mouse</guimenuitem></title>
+
+ <para>The mouse is the first item to be configured. If you
+ previously configured your mouse, the mouse daemon will already
+ be running and should indicate <guimenuitem>SysMouse</guimenuitem>
+ automatically for the mouse protocol. If you are use a two
+ button mouse, you should also select
+ <guimenuitem>Emulate3Buttons</guimenuitem>. There are other
+ settings that can be tweaked if necessary.</para>
+
+ <para>After completing your selections, click on the
+ <guimenuitem>Apply</guimenuitem> and check the mouse actions are
+ working properly. If further adjustment is needed, make them
+ and recheck the operation by clicking on
+ <guimenuitem>Apply</guimenuitem> again. When finished, move
+ on to the next item.</para>
+ </step>
- <para>The default settings were fine for my keyboard. Select the
- options appropriate for your situation then click on "Apply".</para>
- </sect3>
+ <step>
+ <title><guimenuitem>Keyboard</guimenuitem></title>
- <sect3 id="x-card">
- <title>Video Card</title>
+ <para>Select the appropriate keyboard model. The default
+ keyboard is <guimenuitem>Generic 101-key PC</guimenuitem>.</para>
- <para>Click on the "Card" menu item.</para>
+ <para>Select the language layout for your keyboard. The default
+ layout is <guimenuitem>U.S. English</guimenuitem>. If you are
+ not using a U.S. keyboard, you may need to additionally
+ select a variant.</para>
- <para>Select the appropriate video card from the list using the
- scrollbar. Clicking on your card will show as "Card selected:"
- above the list box.</para>
+ <para>There are other options under Group Shift/Lock behavior and
+ Control Key Position that can be selected if desired. Generally
+ the default settings are fine.</para>
- <para>Next, the "Detailed Setup" was selected just to check any
- details.</para>
- </sect3>
+ <para>After completing the keyboard configuration, click on
+ <guimenuitem>Apply</guimenuitem> and move on to the next
+ item.</para>
+ </step>
- <sect3 id="x-monitor">
- <title>Monitor</title>
+ <step>
+ <title><guimenuitem>Card</guimenuitem></title>
- <para>Click on the "Monitor" menu item.</para>
+ <para>Click on <guimenuitem>Read README file</guimenuitem> for
+ additional help in configuring your video card.</para>
- <para>There are two ways to proceed. One method requires that you
- enter the horizontal and vertical sweep capabilities of your
- monitor. Choosing one of the options listed that the monitor is
- the method used in the illustration.</para>
+ <para>Select the appropriate video card from the list using the
+ scrollbar. Clicking on your card will show as
+ <quote>Card selected:</quote> above the list box.</para>
- <para>Do not exceed the ratings of your monitor. Damage could
- occur. If you have doubts select "ABORT" and get the
- information. The remainder of the installation process will be
- unaffected and configuring the X-Server can be done later using
- <filename>/stand/sysinstall</filename>.</para>
+ <para>Next, the <guimenuitem>Detailed Setup</guimenuitem> was
+ selected just to check details. Typically, if your video
+ card was in the list, no changes will be needed here.</para>
- <para>After selecting a listed option, the screen will display the
- horizontal and vertical sweep rates that will be used. Compare
- those to the monitor specifications. The monitor must be capable
- of using those ranges.</para>
- </sect3>
+ <para>When finished, move on to the next item.</para>
+ </step>
- <sect3 id="x-modes">
- <title>Video Mode Selection</title>
+ <step>
+ <title><guimenuitem>Monitor</guimenuitem></title>
- <para>Click on the "Modeselection" menu item.</para>
+ <para>There are two ways to proceed. One method requires that you
+ enter the horizontal and vertical sweep capabilities of your
+ monitor in the text boxes.</para>
- <para>Selected the modes and color depth appropriate for the
- system.</para>
- </sect3>
+ <para>Choosing one of the monitor options listed that the monitor
+ is the other method. After selecting a listed option, the
+ horizontal and vertical sweep rates that will be used will
+ display. Compare those to your monitor specifications. The
+ monitor must be capable of using those ranges.</para>
- <sect3 id="x-other">
- <title>Other</title>
+ <para>Do not exceed the ratings of your monitor. Damage could
+ occur. If you have doubts select <guimenuitem>ABORT</guimenuitem>
+ and get the information. The remainder of the installation process
+ will be unaffected and configuring the X-Server can be done
+ later using <command>/stand/sysinstall</command>.</para>
- <para>These are generally reasonable values.</para>
+ <para>When finished, move on to the next item.
+ </step>
- <para>Verify all the settings once again and select "Done".</para>
+ <step>
+ <title><guimenuitem>Mode</guimenuitem></title>
- <para>It will then attempt to switch to x-mode to verify the
- settings. If nothing appears or appears wrong, kill the x-server
- using
- <keycombo action='simul'>
- <keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>Backspace</keycap>
- </keycombo>
- and adjust the settings or revisit them after installation.</para>
- </sect3>
+ <para>Select the video mode(s) that you want to use. You can select
+ more than one option. Typically, useful ranges are 640x480,
+ 800x600, and 1024x768 but those are a function of video card
+ capability, monitor size, and eye comfort.</para>
+
+ <para>Next, select the default color depth you want to use. Your
+ choices are 8bpp, 16bpp, 24bpp, and 32bpp. Select the highest
+ color depth that your video card will support.</para>
+
+ <para>When finished, move on to the next item.</para>
+ </step>
- <sect3 id="x-save">
- <title>Saving Configuration</title>
+ <step>
+ <title><guimenuitem>Other</guimenuitem></title>
+
+ <para>There default settings are reasonable values so you
+ probably won't need to change anything here.</para>
+
+ <para>The default setting which allows the server to be killed
+ with the hotkey sequence <keycombo action='simul'>
+ <keycap>Ctrl</keycap><keycap>Alt</keycap>
+ <keycap>Backspace</keycap></keycombo> should be left on. This
+ can be executed if somthing is wrong with the server settings and
+ prevent hardware damage.</para>
+
+ <para>The default setting that allows video mode switching will
+ permit changing of the mode while running X with the hotkey
+ sequence
+ <keycombo action='simul'>
+ <keycap>Alt</keycap><keycap>+</keycap>
+ </keycombo> or
+ <keycombo action='simul'>
+ <keycap>Alt</keycap><keycap>-</keycap>
+ </keycombo>.
+
+ </para>
+ </step>
+
+ <step>
+ <title>Testing the Server</title>
- <para>After selecting [DONE] the following message will display:</para>
+ <para>Verify all the settings once again and select
+ <guibutton>Done</guibutton> and the following message will
+ display :</para>
- <screen>If you've finished configuring everything press the
+ <screen>If you've finished configuring everything press the
Okay button to start the X server using the configuration
you've selected. If you still wish to configure some things,
press one of the buttons at the top and then press "Done" again,
when you've finished.</screen>
- <para>After selecting [OKAY], some messages will briefly appear
- advising to wait and attempting to start the x-server. This
- process takes a few moments, so be patient. The screen will go
- blank for a short period of time and then the following should
- appear: "Congratulations, you've got a running server!</para>
-
- <para>The configuration can now be saved in the location indicated
- and continue with the installation.</para>
-
- <para>If the monitor display needs adjusted,
- <application>xvidtune</application> can be ran
- to adjust them. There are warnings that improper settings can
- damage your equipment. Heed them. If in doubt, do not do
- it. Instead, use the monitor controls to adjust the display for
- x-windows. There may be some display differences when switching
- back to text mode, but it is better than damaging equipment. The
- <application>xvidtune</application> can be ran later using
- <command>/stand/sysinstall</command>.</para>
-
- <para>If it does not appear or is distorted, kill the server with
- <keycombo action='simul'>
- <keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>Backspace</keycap>
- </keycombo>
- to continue and configure the x-server after installation using
- <command>/stand/sysinstall</command>.</para>
-
- <para>The installation program will create the 'X' link to the
- server by selecting [Yes]:</para>
-
- <screen> Do you want to create an 'X' link to the SVGA server?
+ <para>After selecting <guibutton>Okay</guibutton>, some messages
+ will briefly appear advising to wait and attempting to start
+ the x-server. This process takes a few moments, so be
+ patient.</para>
+
+ <para>The screen will go blank for a short period of time and
+ then a screen will appear with the message
+ <quote>Congratulations, you've got a running server!</quote></para>
+
+ <para>If nothing appears or is distorted, kill the x-server using
+ <keycombo action='simul'>
+ <keycap>Ctrl</keycap>
+ <keycap>Alt</keycap>
+ <keycap>Backspace</keycap>
+ </keycombo>
+ and adjust the settings or revisit them after installation.</para>
+ </step>
+
+ <step>
+ <title>Running <command>xvidtune</command></title>
+
+ <para>The display can be adjusted for height, width, or centering
+ by using <application>xvidtune</application>.</para>
+
+ <para>There are warnings that improper settings can
+ damage your equipment. Heed them. If in doubt, do not do
+ it. Instead, use the monitor controls to adjust the display for
+ x-windows. There may be some display differences when switching
+ back to text mode, but it is better than damaging equipment. The
+ <application>xvidtune</application> can be ran later using
+ <command>/stand/sysinstall</command>.</para>
+
+ <para>Read the <application>xvidtune</application> before making
+ any adjustments.</para>
+ </step>
+
+ <step>
+ <title>Saving Configuration</title>
+
+ <para>When you are satisfied, the configuration can now be saved.
+ Select <guimenuitem>Save the configuration and Exit</guimenuitem>
+ The configuration file will be saved to
+ <filename>/etc/XF86Config</filename>.</para>
+ </step>
+ </procedure>
+
+ <para>Once the configuration is done, the installation program will
+ need to create a link to the server :</para>
+
+ <screen> Do you want to create an 'X' link to the SVGA server?
(the link will be created in the directory:
/usr/X11R6/bin) Okay?
[ Yes ] No</screen>
- <screen> Link created successfully.
+ <para>Select <guibutton>[ Yes ]</guibutton> and press
+ <keycap>Enter</keycap> to create the link.</para>
+
+ <screen> Link created successfully.
[ OK ]</screen>
- <para>Press <keycap>Enter</keycap> to continue configuration.</para>
- </sect3>
+ <para>Press <keycap>Enter</keycap> to continue configuration.</para>
</sect2>
<sect2 id="default-desktop">
<title>Select Default X Desktop</title>
- <para>I selected the K Desktop Environment with the arrow keys and
- then pressed <keycap>Enter</keycap> to set it as my default window
- manager.</para>
+ <para>There are a variety of window managers available. They range
+ from very basic environments to full desktop environments with a
+ large suite of software. Some require only minimal disk space and
+ low memory while others with more features require much more. The
+ best way to determine which is most suitable for you is to try a few
+ different ones. Those are available from the ports collection or as
+ packages and can be added after installation.</para>
+
+ <para>You can select one of the popular desktops to be installed
+ and configured as the default desktop. This will allow you
+ to start it right after installation.</para>
<figure id="x-desktop">
<title>Select Default Desktop</title>
@@ -3383,14 +3499,18 @@ when you've finished.</screen>
</mediaobject>
</figure>
- <para>The selected desktop package will then be loaded on they
- system.</para>
+ <para>Use the arrow keys to select a desktop and press
+ <keycap>Enter</keycap>. Installation of the selected desktop will
+ proceed.</para>
</sect2>
<sect2 id="packages">
<title>Install Packages</title>
- <para>Only one package is shown being added for purposes of
+ <para>The packages are pre-compiled binaries and are a convenient
+ way to install software.</para>
+
+ <para>Installation of one package is shown for purposes of
illustration. Additional packages can also be added at this
time if desired. After installation
<command>/stand/sysinstall</command> can be used to add additional
@@ -3403,7 +3523,8 @@ when you've finished.</screen>
[ Yes ] No</screen>
- <para>Selecting [Yes] and pressing <keycap>Enter</keycap> will be
+ <para>Selecting <guimenuitem>[ Yes ]</guimenuitem> and pressing
+ <keycap>Enter</keycap> will be
followed by the Package Selection screens:</para>
<figure id="package-category">
@@ -3416,15 +3537,13 @@ when you've finished.</screen>
</mediaobject>
</figure>
- <para>All packages available will be displayed if "All" is
- chosen. Additional packages may be on other CDs. These can also
- be added later using
- <filename>/stand/sysinstall</filename>.</para>
+ <para>All packages available will be displayed if
+ <guimenuitem>All</guimenuitem> is selected or you can select a
+ particular category. Highlight your selection with the arrow
+ keys and press <keycap>Enter</keycap>.</para>
- <para>The bash shell is shown selected. Select as many as desired
- by highlighting the item and pressing the <keycap>Space</keycap>.
- A short description of each package will appear in the lower left
- corner of the screen.</para>
+ <para>A menu will display showing all the packages available for
+ the selection made.</para>
<figure id="package-select">
<title>Select Packages</title>
@@ -3436,7 +3555,14 @@ when you've finished.</screen>
</mediaobject>
</figure>
- <para>When the package(s) are selected, select [OK] and then press
+ <para>The <application>bash</application> shell is shown selected.
+ Select as many as desired by highlighting the package and pressing
+ the <keycap>Space</keycap>.
+ A short description of each package will appear in the lower left
+ corner of the screen.</para>
+
+ <para>When you have finished marking the packages for installation,
+ select <guibutton>[ OK ]</guibutton> and press
<keycap>Enter</keycap> to return to the Package Selection menu.</para>
<figure id="package-install">
@@ -3449,8 +3575,9 @@ when you've finished.</screen>
</mediaobject>
</figure>
- <para>Use the arrow keys to select [INSTALL] and pressing
- <keycap>Enter</keycap> will ask for confirmation.</para>
+ <para>Use the arrow keys to select <guibutton>[ Install ]</guibutton>
+ and press <keycap>Enter</keycap>. You will then need to confirm
+ that you want to install the packages.</para>
<figure id="package-install-confirm">
<title>Confirm Package Installation</title>
@@ -3462,7 +3589,8 @@ when you've finished.</screen>
</mediaobject>
</figure>
- <para>Selecting [OK] and pressing <keycap>Enter</keycap> will start
+ <para>Selecting <guibutton>[ OK ]</guibutton> and pressing
+ <keycap>Enter</keycap> will start
the package installation. Installing messages will appear until
completed. Make note if there are any error messages.</para>
@@ -3473,6 +3601,11 @@ when you've finished.</screen>
<sect2 id="addusers">
<title>Add User/Groups</title>
+ <para>You should add at least one user during the installation so
+ that you can use the system without being logged in as root. The
+ root partition is generally small and running applications as
+ root can quickly fill it. A bigger danger is noted below :</para>
+
<screen> User Confirmation Requested
Would you like to add any initial user accounts to the system? Adding
at least one account for yourself at this stage is suggested since
@@ -3481,8 +3614,8 @@ when you've finished.</screen>
[ Yes ] No</screen>
- <para>Select "Add User" with the arrow keys then and press
- <keycap>Enter</keycap>.</para>
+ <para>Select <guibutton>[ Yes ]</guibutton> and press
+ <keycap>Enter</keycap> to continue with adding a user.</para>
<figure id="add-user2">
<title>Select Add User</title>
@@ -3494,6 +3627,9 @@ when you've finished.</screen>
</mediaobject>
</figure>
+ <para>Select <guimenuitem>Add User</guimenuitem> with the arrow keys
+ and press <keycap>Enter</keycap>.</para>
+
<figure id="add-user3">
<title>Add User Information</title>
@@ -3505,7 +3641,8 @@ when you've finished.</screen>
</figure>
<para>The following descriptions will appear in the lower part of
- the screen as the items are selected with <keycap>Tab</keycap></para>
+ the screen as the items are selected with <keycap>Tab</keycap>
+ to assist with entering the required information.</para>
<variablelist>
<varlistentry>
@@ -3580,16 +3717,17 @@ when you've finished.</screen>
<para>The login shell was changed from
<filename>/bin/sh</filename> to
- <filename>/usr/local/bin/bash</filename> to use the bash shell
- that was previously installed as a package.</para>
+ <filename>/usr/local/bin/bash</filename> to use the
+ <application>bash</application> shell
+ that was previously installed as a package. Do not try to
+ use a shell that does not exist or you will not be able to
+ login.</para>
<para>The user was also added to the group "wheel" to be able to
become a superuser with root privileges.</para>
- <para>Groups could also be added at this time if specific needs
- are known. Otherwise, this may be accessed through using
- <filename>/stand/sysinstall</filename> after installation is
- completed.</para>
+ <para>When you are satisfied, press <keycap>[ OK ]</keycap> and
+ the User and Group Management menu will redisplay.</para>
<figure id="add-user4">
<title>Exit User and Group Management</title>
@@ -3601,7 +3739,13 @@ when you've finished.</screen>
</mediaobject>
</figure>
- <para>I selected [Exit] with the arrow keys then [OK] and pressed
+ <para>Groups could also be added at this time if specific needs
+ are known. Otherwise, this may be accessed through using
+ <filename>/stand/sysinstall</filename> after installation is
+ completed.</para>
+
+ <para>When you are finished adding users, select
+ <guimenuitem>Exit</guimenuitem> with the arrow keys and press
<keycap>Enter</keycap> to continue the installation.</para>
</sect2>
@@ -3616,6 +3760,8 @@ when you've finished.</screen>
[ Press enter to continue ]</screen>
+ <para>Press <keycap>Enter</keycap> to set the root password.</para>
+
<para>The password will need to be typed in twice
correctly. Needless to say, make sure you have a way of finding
the password if you forget.</para>
@@ -3631,14 +3777,19 @@ when you've finished.</screen>
<sect2 id="exit-inst">
<title>Exiting Install</title>
+ <para>If you need to configure additional network devices or to
+ do any other configurations, you can do it at this point or
+ after installation with <filename>/stand/sysinstall</filename>.</para>
+
<screen> User Confirmation Requested
Visit the general configuration menu for a chance to set any last
options?
Yes [ No ]</screen>
- <para>Selecting [No] with the arrow keys and pressing
- <keycap>Enter</keycap> returns to the Main Installation Menu</para>
+ <para>Selecting <guibutton>[ No ]</guibutton> with the arrow keys
+ and pressing <keycap>Enter</keycap> returns to the Main
+ Installation Menu</para>
<figure id="final-main">
<title>Exit Install</title>
@@ -3650,8 +3801,9 @@ when you've finished.</screen>
</mediaobject>
</figure>
- <para>Select [EXIT INSTALL] with the arrow keys and press
- <keycap>Enter</keycap>.</para>
+ <para>Select <guibutton>[X Exit Install]</guibutton> with the arrow
+ keys and press <keycap>Enter</keycap>. You will be asked to
+ confirm exiting the installation :</para>
<screen> User Confirmation Requested
Are you sure you wish to exit? The system will reboot (be sure to
@@ -3659,9 +3811,9 @@ when you've finished.</screen>
[ Yes ] No</screen>
- <para>Select [Yes] and remove floppy if booting from floppy. The
- CDROM drive is locked until you select yes to exit and press
- <keycap>Enter</keycap>. The CDROM drive is then unlocked and can
+ <para>Select <guibutton>[ Yes ]</guibutton> and remove floppy if
+ booting from floppy. The CDROM drive is locked until the machine
+ starts to reboot. The CDROM drive is then unlocked and can
be removed from drive (quickly).</para>
<para>The system will reboot so watch for any error messages that
@@ -3671,7 +3823,7 @@ when you've finished.</screen>
<sect2 id="freebsdboot">
<title>FreeBSD Bootup</title>
- <para>If everything goes well, you will see similar messages scroll
+ <para>If everything went well, you will see messages scroll
off the screen and you will arrive at a login prompt. You can view
the content of the messages by pressing <keycap>Scroll-Lock</keycap>
and using <keycap>PgUp</keycap> and <keycap>PgDn</keycap>.
@@ -3679,11 +3831,10 @@ when you've finished.</screen>
to the prompt.</para>
<para>The entire message may not display (buffer limitation) but
- can be viewed from the command line after logging in by typing
- <command>dmesg</command> at the prompt will get similar
- information.</para>
+ it can be viewed from the command line after logging in by typing
+ <command>dmesg</command> at the prompt.</para>
- <para>Login using the user/password you set during installation
+ <para>Login using the username/password you set during installation
(rpratt, in this example). Avoid logging in as root except when
necessary.</para>