install-guide fedora-install-guide-firstboot-en.xml, 1.14, 1.15 fedora-install-guide-nextsteps-en.xml, 1.7, 1.8

Stuart Ellis (elliss) fedora-docs-commits at redhat.com
Tue Dec 6 01:25:32 UTC 2005


Author: elliss

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

Modified Files:
	fedora-install-guide-firstboot-en.xml 
	fedora-install-guide-nextsteps-en.xml 
Log Message:
- Added admonition to update the system after installation completes
- Added section on updating Fedora Core
- Added a section on annnoucements mailing list and package updates RSS




Index: fedora-install-guide-firstboot-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-firstboot-en.xml,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- fedora-install-guide-firstboot-en.xml	4 Dec 2005 21:35:07 -0000	1.14
+++ fedora-install-guide-firstboot-en.xml	6 Dec 2005 01:25:25 -0000	1.15
@@ -29,7 +29,7 @@
     Agent</application>.
   </para>
   <note>
-    <title>GUI Required</title>
+    <title>Graphical Interface Required</title>
 
     <para>
       <application>Setup Agent</application> requires a graphical
@@ -71,13 +71,12 @@
       Agreement</guilabel> and then select <guibutton>Next</guibutton>.
     </para>
   </section>
-
   <section id="sn-firstboot-firewall">
     <title>Firewall</title>
 
     <para>
       The <indexterm>
-	<primary>firewall</primary>
+      <primary>firewall</primary>
       </indexterm> <firstterm>firewall</firstterm> built into &FC;
       checks every incoming and outgoing network connection on your
       machine against a set of rules. These rules specify which types of
@@ -87,45 +86,42 @@
     <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
+      block incoming connections from other systems. You may make
       changes on this screen to allow access to specific network
       services on your &FED; system.
     </para>
 
     <para>
       To enable access to services listed on this screen, click the
-      check box next to the service name.  After installation is
+      check box next to the service name. After installation is
       complete, you can enable access to other services as well.
     </para>
 
     <para>
-      Avoid disabling the firewall.  If you believe it is necessary to
-      do so, select <guilabel>No firewall</guilabel>.
+      Avoid disabling the firewall. If you believe it is necessary to do
+      so, select <guilabel>No firewall</guilabel>.
     </para>
-
     <tip>
       <title>Changing the Firewall Settings</title>
       <para>
-	To change these settings later, from the main menu, choose
-	<menuchoice>
-	  <guimenu>System</guimenu>
-	  <guisubmenu>Administration</guisubmenu><guimenuitem>Security
-	    Level and Firewall</guimenuitem></menuchoice>.
-      </para>   
+        To change these settings later, from the main menu, choose
+        <menuchoice> <guimenu>System</guimenu>
+        <guisubmenu>Administration</guisubmenu><guimenuitem>Security
+        Level and Firewall</guimenuitem></menuchoice>.
+      </para>
     </tip>
   </section>
-
   <section id="sn-firstboot-selinux">
     <title>&SEL;</title>
 
     <para>
       The <indexterm>
-	<primary>&SEL;</primary>
+      <primary>&SEL;</primary>
       </indexterm> <firstterm>&SEL;</firstterm> (Security Enhanced
       Linux) framework is part of &FC;. &SEL; limits the actions of both
       users and programs by enforcing security policies throughout the
       operating system. Without &SEL;, software bugs or configuration
-      changes may render a system more vulnerable.  The restrictions
+      changes may render a system more vulnerable. The restrictions
       imposed by &SEL; policies provide extra security against
       unauthorized access.
     </para>
@@ -133,69 +129,64 @@
     <para>
       Inflexible &SEL; policies might inhibit many normal activities on
       a &FED; system. For this reason, &FC; uses targeted policies,
-      which only affect specific network services.  These services
-      cannot perform actions that are not part of their normal
-      functions.  The targeted policies reduce or eliminate any
-      inconvenience &SEL; might cause users.  Set the &SEL; mode to one
-      of the following:
+      which only affect specific network services. These services cannot
+      perform actions that are not part of their normal functions. The
+      targeted policies reduce or eliminate any inconvenience &SEL;
+      might cause users. Set the &SEL; mode to one of the following:
     </para>
 
     <variablelist>
       <varlistentry>
-	<term><guilabel>Active</guilabel></term>
-	<listitem>
-	  <para>
-	    Select this mode to use the targeted &SEL; policy on your
-	    &FED; system.  This is the default mode for &FED;
-	    installations.
-	  </para>
-	</listitem>
+        <term><guilabel>Active</guilabel></term>
+        <listitem>
+          <para>
+            Select this mode to use the targeted &SEL; policy on your
+            &FED; system. This is the default mode for &FED;
+            installations.
+          </para>
+        </listitem>
       </varlistentry>
+
       <varlistentry>
-	<term><guilabel>Permissive</guilabel></term>
-	<listitem>
-	  <para>
-	    In this mode, the system is configured with
-	    &SEL;, but a breach of security policies only causes an
-	    error message to appear.  No activities are actually
-	    prohibited when &SEL; is installed in this mode. You may
-	    change the &SEL; mode to <guilabel>Active</guilabel> at any
-	    time after booting.
-	  </para>
-	</listitem>
+        <term><guilabel>Permissive</guilabel></term>
+        <listitem>
+          <para>
+            In this mode, the system is configured with &SEL;, but a
+            breach of security policies only causes an error message to
+            appear. No activities are actually prohibited when &SEL; is
+            installed in this mode. You may change the &SEL; mode to
+            <guilabel>Active</guilabel> at any time after booting.
+          </para>
+        </listitem>
       </varlistentry>
+
       <varlistentry>
-	<term><guilabel>Disabled</guilabel></term>
-	<listitem>
-	  <para>
-	    If you choose this mode for &SEL;, &FED; does not configure
-	    the access control system at all. To make &SEL; active
-	    later, from the main menu, select
-	    <menuchoice>
-	      <guimenu>System</guimenu>
-	      <guisubmenu>Administration</guisubmenu>
-	      <guimenuitem>Security Level and Firewall</guimenuitem>
-	    </menuchoice>.
-	  </para>
-	</listitem>
+        <term><guilabel>Disabled</guilabel></term>
+        <listitem>
+          <para>
+            If you choose this mode for &SEL;, &FED; does not configure
+            the access control system at all. To make &SEL; active
+            later, from the main menu, select <menuchoice>
+            <guimenu>System</guimenu>
+            <guisubmenu>Administration</guisubmenu>
+            <guimenuitem>Security Level and Firewall</guimenuitem>
+            </menuchoice>.
+          </para>
+        </listitem>
       </varlistentry>
     </variablelist>
-
     <tip>
       <title>Changing the &SEL; policy</title>
       <para>
-	&SEL; is unique in that it cannot be bypassed, even by the
-	system administrators.  To change the behavior of &SEL; after
-	installation, from the main menu, choose <menuchoice>
-	  <guimenu>System</guimenu>
-	  <guisubmenu>Administration</guisubmenu>
-	  <guimenuitem>Security Level and Firewall</guimenuitem>
-	</menuchoice>.
+        &SEL; is unique in that it cannot be bypassed, even by the
+        system administrators. To change the behavior of &SEL; after
+        installation, from the main menu, choose <menuchoice>
+        <guimenu>System</guimenu>
+        <guisubmenu>Administration</guisubmenu> <guimenuitem>Security
+        Level and Firewall</guimenuitem> </menuchoice>.
       </para>
     </tip>
-
   </section>
-
   <section id="sn-firstboot-datetime">
     <title>Date and Time</title>
 
@@ -238,8 +229,9 @@
       <title>Setting the Clock</title>
       <para>
         To change these settings later, from the main menu, choose
-        <menuchoice> <guimenu>System</guimenu> <guisubmenu>Administration</guisubmenu> <guimenuitem>Date & Time</guimenuitem>
-        </menuchoice>.
+        <menuchoice> <guimenu>System</guimenu>
+        <guisubmenu>Administration</guisubmenu> <guimenuitem>Date &
+        Time</guimenuitem> </menuchoice>.
       </para>
     </tip>
     <para>
@@ -360,8 +352,9 @@
       <para>
         To reconfigure your system after the installation has completed,
         from the main menu, choose <menuchoice>
-        <guimenu>System</guimenu> <guisubmenu>Administration</guisubmenu> <guimenuitem>Display</guimenuitem>
-        </menuchoice>.
+        <guimenu>System</guimenu>
+        <guisubmenu>Administration</guisubmenu>
+        <guimenuitem>Display</guimenuitem> </menuchoice>.
       </para>
     </tip>
   </section>
@@ -401,7 +394,8 @@
       <para>
         To add additional user accounts to your system after the
         installation is complete, from the main menu, choose
-        <menuchoice> <guimenu>System</guimenu> <guisubmenu>Administration</guisubmenu> <guimenuitem>Users &
+        <menuchoice> <guimenu>System</guimenu>
+        <guisubmenu>Administration</guisubmenu> <guimenuitem>Users &
         Groups</guimenuitem> </menuchoice>.
       </para>
     </tip>
@@ -450,6 +444,11 @@
     </para>
 
     <para>
+      <remark role="FIXME">Explain the option to <guilabel>Use only the hardware device</guilabel>
+      </remark>
+    </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.
@@ -460,7 +459,8 @@
         &FC; will automatically attempt to detect a new sound card if
         you add one to your system. If you need to launch the detection
         process manually, from the main menu, choose <menuchoice>
-        <guimenu>System</guimenu> <guisubmenu>Administration</guisubmenu> <guimenuitem>Soundcard
+        <guimenu>System</guimenu>
+        <guisubmenu>Administration</guisubmenu> <guimenuitem>Soundcard
         Detection</guimenuitem> </menuchoice>.
       </para>
     </tip>
@@ -487,6 +487,17 @@
       Click <guilabel>Next</guilabel> to proceed to the login screen.
       Your &FC; system is now ready for use.
     </para>
+
+    <important>
+      <title>Update Your System</title>
+
+      <para>
+        To ensure the security of your system, run a package update
+        after the installation completes.
+        <xref linkend="ch-next-steps" /> explains how to update your
+        &FED; system.
+      </para>
+    </important>
   </section>
 </chapter>
 


Index: fedora-install-guide-nextsteps-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-nextsteps-en.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- fedora-install-guide-nextsteps-en.xml	9 Jun 2005 21:04:39 -0000	1.7
+++ fedora-install-guide-nextsteps-en.xml	6 Dec 2005 01:25:25 -0000	1.8
@@ -2,34 +2,165 @@
 
 <chapter id="ch-next-steps">
   <title>Your Next Steps</title>
-
   <para>
     &FC; provides you with a complete operating system with a vast range
     of capabilities, supported by a large community.
   </para>
+  <section id="sn-system-updating">
+    <title>Updating Your &FED; System</title>
 
+    <para>
+      The &FP; releases updated software packages for &FC; throughout
+      the support period of each version. Updated packages add new
+      features, improve reliability, resolve bugs, or remove security
+      vulnerabilities. To ensure the security of your system, carry out
+      an update when the installation process completes. You should then
+      update regularly, and as soon as possible after a security
+      announcement. Refer to <xref linkend="sn-news-subscriptions"/> for
+      information on the &FED; announcements services.
+    </para>
+
+    <para>
+      To update your system with the latest packages, use the
+      <application>Package Updater</application>:
+    </para>
+    <orderedlist>
+      <listitem>
+        <para>
+          Choose <menuchoice><guimenu>System</guimenu>
+          <guisubmenu>Administration</guisubmenu> <guimenuitem>Package
+          Updater</guimenuitem> </menuchoice>.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          When prompted, enter the
+          <systemitem class="username">root</systemitem> password.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Review the list of updated packages. If your system uses a
+          slow network connection the <application>Package
+          Updater</application> may require several seconds to download
+          the information for all of the updated packages.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Click <guibutton>Apply Updates</guibutton> to begin the update
+          process.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Restart any active programs or network services listed in the
+          update window. If the updates include a
+          <filename>kernel</filename> package, restart your system as
+          soon as possible to load the new kernel.
+        </para>
+      </listitem>
+    </orderedlist>
+    <para>
+      <remark role="FIXME">Check this procedure on test2</remark>
+    </para>
 
-    <section id="sn-web-help">
-      <title>Documentation on the Web</title>
+    <para>
+      To update packages from the command-line, use the
+      <command>yum</command> utility. Type this command to begin a full
+      update of your system with <command>yum</command>:
+    </para>
+<screen>
+<userinput>su -c 'yum update'</userinput>
+</screen>
+    <para>
+      Enter the <systemitem
+	class="username">root</systemitem> password
+      when prompted.
+    </para>
 
+    <para>
+      Refer to <ulink url="http://fedora.redhat.com/docs/yum/"/> for
+      more information on <command>yum</command>.
+    </para>
+    <tip>
+      <title>Automating Updates</title>
       <para>
-	Documentation for &FC; is available from the &FP;
-	Website:
-      </para>
-    <!-- institutional shyness of the word official, odd legal standing -->
+        If your &FED; system has a permanent network connection, you may
+        choose to enable daily system updates. To enable automatic
+        updates, follow the instructions on the webpage
+        <ulink url="http://fedora.redhat.com/docs/yum/sn-updating-your-system.html"/>.
+      </para>
+    </tip>
+  </section>
+  <section id="sn-news-subscriptions">
+    <title>Subscribing to &FED; Announcements and News</title>
+
+    <para>
+      To receive information about package updates, subscribe to either
+      the announcements mailing list, or the RSS feeds.
+    </para>
+
+    <variablelist>
+      <varlistentry>
+        <term>
+	    &FP; announcements mailing list
+	  </term>
+        <listitem>
+          <para>
+            <ulink url="https://www.redhat.com/mailman/listinfo/fedora-announce-list"/>
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>
+	    &FP; RSS feeds
+	  </term>
+        <listitem>
+          <para>
+            <ulink url="http://fedoraproject.org/infofeed/"/>
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+
+    <para>
+      The annnouncements mailing list also provides you with news on the
+      &FP;, and the &FED; community.
+    </para>
+
+    <important>
+      <title>Security Announcements</title>
+
       <para>
-	<ulink
+        Announcements with the keyword
+        <wordasword>[SECURITY]</wordasword> in the title identify
+        package updates that remove security vulnerabilities.
+      </para>
+    </important>
+  </section>
+  <section id="sn-web-help">
+    <title>Finding Documentation on the Web</title>
+
+    <para>
+      Documentation for &FC; is available from the &FP; Website:
+    </para>
+
+    <para>
+      <ulink
 	  url="http://fedora.redhat.com/docs/">http://fedora.redhat.com/docs/</ulink>
-      </para>
+    </para>
 
-      <para>
-	The Linux Documentation Project (LDP) produces books and tutorials:
-      </para>
+    <para>
+      The Linux Documentation Project (LDP) produces books and
+      tutorials:
+    </para>
 
-      <para>
-	<ulink
+    <para>
+      <ulink
 	  url="http://www.tldp.org/">http://www.tldp.org/</ulink>
-      </para>
+    </para>
 
     <para>
       For many parts of &FC;, you may find the &RHEL; documentation
@@ -41,63 +172,54 @@
 	url="http://www.redhat.com/docs/manuals/enterprise/">http://www.redhat.com/docs/manuals/enterprise/</ulink>
     </para>
 
-      <para>
-	Many other organizations and individuals also provide tutorials
-	and HOWTOs for &FED; on their Websites.  You can locate
-	information on any topic by using Google:
-      </para>
+    <para>
+      Many other organizations and individuals also provide tutorials
+      and HOWTOs for &FED; on their Websites. You can locate information
+      on any topic by using Google:
+    </para>
 
-      <para>
-	<ulink
+    <para>
+      <ulink
 	  url="http://www.google.com/linux/">http://www.google.com/linux/</ulink>
-      </para>
-
-    </section>
-
-
+    </para>
+  </section>
   <section id="sn-community-help">
-   <title>Community Support</title>
-
-   <para>
-	Members of the &FED; community provides support through mailing
-	lists, web forums and Linux User Groups (LUGs) across the world.
-   </para>
-
-   <para>
-	The Website for the official forums is:
-   </para>
+    <title>Getting Community Support</title>
 
-   <para>
-	<ulink
-	  url="http://forums.fedoraforum.org/">http://forums.fedoraforum.org/</ulink>
-   </para>
-
-    </section>
+    <para>
+      Members of the &FED; community provides support through mailing
+      lists, web forums and Linux User Groups (LUGs) across the world.
+    </para>
 
+    <para>
+      The Website for the official forums is:
+    </para>
 
+    <para>
+      <ulink
+	  url="http://forums.fedoraforum.org/">http://forums.fedoraforum.org/</ulink>
+    </para>
+  </section>
   <section id="sn-community">
-   <title>Joining The &FED; Community</title>
+    <title>Joining The &FED; Community</title>
 
-   <para>
-      The &FP; is driven by the individuals that contribute to it.  Community
-      members provide support and documentation to other users, help to improve the
-      software included in &FC; by testing, and develop new software
-      alongside the programmers employed by &RH;.  The results of this
-      work are available to all.
-   </para>
+    <para>
+      The &FP; is driven by the individuals that contribute to it.
+      Community members provide support and documentation to other
+      users, help to improve the software included in &FC; by testing,
+      and develop new software alongside the programmers employed by
+      &RH;. The results of this work are available to all.
+    </para>
 
-      <para>
-	To make a difference, start here: 
-      </para>
+    <para>
+      To make a difference, start here:
+    </para>
 
-      <para>
-	<ulink
+    <para>
+      <ulink
 	  url="http://fedora.redhat.com/participate/">http://fedora.redhat.com/participate/</ulink>
-      </para>
-
-    </section>
-
-
+    </para>
+  </section>
 </chapter>
 
 <!--




More information about the Fedora-docs-commits mailing list