install-guide/en entities.xml, 1.2, 1.3 fedora-install-guide-firstboot.xml, 1.7, 1.8

[Stuart Ellis (elliss)]

Author: elliss

Update of /cvs/docs/install-guide/en
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv23090/en

Modified Files:
	entities.xml fedora-install-guide-firstboot.xml 
Log Message:
WARNING: This is broken, due to entities issue.

- Updated First Boot section to match Rawhide. Note that screenshots for this section will have to be redone prior to release.





Index: entities.xml
===================================================================
RCS file: /cvs/docs/install-guide/en/entities.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- entities.xml	1 Mar 2006 21:45:41 -0000	1.2
+++ entities.xml	4 Mar 2006 23:56:10 -0000	1.3
@@ -14,11 +14,11 @@
     </entity>
     <entity name="DOCVERSION">
       <comment>Document version</comment>
-      <text>1.22</text>
+      <text>1.24</text>
     </entity>
     <entity name="DOCDATE">
       <comment>Document date</comment>
-      <text>2006-03-01</text>
+      <text>2006-03-04</text>
     </entity>
     <entity name="DOCID">
       <comment>Document ID string</comment>


Index: fedora-install-guide-firstboot.xml
===================================================================
RCS file: /cvs/docs/install-guide/en/fedora-install-guide-firstboot.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- fedora-install-guide-firstboot.xml	2 Mar 2006 22:57:14 -0000	1.7
+++ fedora-install-guide-firstboot.xml	4 Mar 2006 23:56:10 -0000	1.8
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
+
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
 
@@ -86,7 +87,8 @@
     </figure>
     <para>
       To proceed, select <guilabel>Yes, I agree to the License
-      Agreement</guilabel> and then select <guibutton>Next</guibutton>.
+      Agreement</guilabel> and then select
+      <guibutton>Forward</guibutton>.
     </para>
   </section>
   <section id="sn-firstboot-firewall">
@@ -107,7 +109,12 @@
     <para>
       By default the firewall is enabled, with a simple set of rules
       that allow connections to be made from your system to others, but
-      block incoming connections from other systems. You may make
+      permit only
+      <indexterm>
+        <primary>SSH (Secure SHell)</primary>
+        <secondary>firewall configuration</secondary>
+      </indexterm>
+      SSH (Secure SHell) connections from other systems. You may make
       changes on this screen to allow access to specific network
       services on your &FED; system.
     </para>
@@ -134,24 +141,38 @@
 
     <important>
       <title>SSH Provides Immediate Remote Access</title>
-       <para>
-	 By default, &FED; installs and runs the SSH service. If you enable SSH access on this screen the user and <systemitem class="username">root</systemitem> accounts may be used to access the system remotely.
-       </para>
+
+      <para>
+        All &FED; systems automatically run the SSH remote access
+        service. The default firewall configuration allows connections
+        to this service, to ensure that administrators have immediate
+        remote access to new systems through the user and
+        <systemitem class="username">root</systemitem> accounts.
+      </para>
     </important>
 
     <para>
-      To enable access to other services, enter the required ports in
-      the <guilabel>Other ports:</guilabel> field. For each port, you
-      must specify the port as TCP or UDP, in addition to the port
-      number. Use the format
-      <userinput><replaceable>portnumber</replaceable>:<replaceable>type</replaceable></userinput>.
-      The majority of services use TCP ports.
+      To enable access to other services, select <guilabel>Other
+      ports</guilabel>, and <guibutton>Add</guibutton> the details. Use
+      the <guilabel>Port(s)</guilabel> field to specify either the port
+      number, or the registered name of the service. Select the relevant
+      <guilabel>Protocol</guilabel> from the drop-down. The majority of
+      services use the TCP protocol.
     </para>
-
+    <tip>
+      <title>The Services List</title>
+      <para>
+        The <filename>services</filename> file on every system lists the
+        port numbers and names of services that are registered with IANA
+        (Internet Assigned Names Authority). &FED; systems hold this
+        file in the directory <filename>/etc</filename>.
+      </para>
+    </tip>
     <para>
-      For example, enter <userinput>143:tcp, 993:tcp</userinput> to
-      allow users to access mail from other systems with the IMAP
-      protocol, which may use both TCP port 143 and TCP port 993.
+      If a service uses more than one port number, enter each port. For
+      example, to allow users on the system to access their mail with
+      the IMAP protocol, add TCP port 143 (imap), and TCP port 993
+      (imaps).
     </para>
 
     <para>
@@ -253,9 +274,10 @@
       To adjust &SEL;, choose <guilabel>Modify SELinux
       Policy</guilabel>. To exempt a key service from &SEL;
       restrictions, select the service from the list, and choose the
-      <guilabel>Remove SELinux protection</guilabel> option. The
+      <guilabel>Disable SELinux protection</guilabel> option. The
       <guilabel>SELinux Service Protection</guilabel> item on the list
-      includes options for additional services.
+      includes options to disable &SEL; restrictions on additional
+      services.
     </para>
     <tip>
       <title>Changing the &SEL; policy</title>
@@ -352,12 +374,10 @@
     </para>
 
     <para>
-      To use an additional time server, either select it from the
-      <guilabel>Server</guilabel> drop-down box, or type the DNS name in
-      the box, and select <guilabel>Add</guilabel>. To remove a server
-      or server pool from the list, select the name and click
-      <guilabel>Delete</guilabel>. The drop-down box already has two
-      listings as examples, which are servers provided by &RH;.
+      To use an additional time server, select <guilabel>Add</guilabel>,
+      and type the DNS name of the server into the box. To remove a
+      server or server pool from the list, select the name and click
+      <guilabel>Delete</guilabel>.
     </para>
 
     <para>
@@ -494,26 +514,72 @@
 
     <para>
       After you configure login services, select
-      <guilabel>Next</guilabel> to proceed to the final screen.
+      <guilabel>Forward</guilabel> to proceed.
+    </para>
+  </section>
+  <section id="sn-firstboot-soundcard">
+    <title>Sound Card</title>
+
+    <para>
+      The <application>Setup Agent</application> automatically attempts
+      to identify the sound card in your computer.
     </para>
-    <figure id="fig-fboot-finish">
-      <title>Finish Setup Screen</title>
+    <figure id="fig-fboot-sound">
+      <title>Sound Card Screen</title>
       <mediaobject>
         <imageobject>
-          <imagedata align="center" fileref="./figs/fbootfinish.eps" format="EPS"/>
+          <imagedata align="center" fileref="./figs/fboot-sound.eps" format="EPS"/>
         </imageobject>
         <imageobject>
-          <imagedata align="center" fileref="./figs/fbootfinish.png" format="PNG"/>
+          <imagedata align="center" fileref="./figs/fboot-sound.png" format="PNG"/>
         </imageobject>
         <textobject>
           <phrase>
-	    Finish setup screen.
-	  </phrase>
+           Sound card screen.
+         </phrase>
         </textobject>
       </mediaobject>
     </figure>
     <para>
-      Click <guilabel>Next</guilabel> to proceed to the login screen.
+      Click the play button to check the sound card configuration. If
+      the configuration is correct, &FED; plays a sound sequence. You
+      may adjust the volume with the slidebar. The
+      <guilabel>Repeat</guilabel> option causes the sound to play until
+      the option is unselected, to assist you in tuning your system.
+    </para>
+
+    <para>
+      If your sound card is identified, but you do not hear the sound,
+      check your speakers and try again. In some cases, you may need to
+      alter the additional settings to obtain the best sound quality.
+    </para>
+<!-- SE: Why would you disable "Dynamic keys for software mixer" ? -->
+    <para>
+      A sound card may provide multiple audio input and output devices.
+      To change the <guilabel>Default PCM device</guilabel>, select a
+      new option from the drop-down list. By default, audio applications
+      connect to a software mixer that manages the PCM devices. To
+      enable applications to bypass the software mixer, select the
+      option to <guilabel>Disable software mixing</guilabel>.
+    </para>
+
+    <para>
+      You may manually configure a &FC; system to use unsupported sound
+      cards after the installation process is complete. Manual sound
+      hardware configuration is beyond the scope of this document.
+    </para>
+    <tip>
+      <title>Changing the Sound Card</title>
+      <para>
+        &FED; automatically attempts to detect a new sound card if you
+        add one to your system. If you need to launch the detection
+        process manually, choose <menuchoice> <guimenu>System</guimenu>
+        <guisubmenu>Administration</guisubmenu> <guimenuitem>Soundcard
+        Detection</guimenuitem> </menuchoice>.
+      </para>
+    </tip>
+    <para>
+      Click <guilabel>Forward</guilabel> to proceed to the login screen.
       Your &FC; system is now ready for use.
     </para>