[deployment-guide/comm-rel: 131/727] Updated the /etc/sysconfig/firstboot section.

[Jaromir Hradilek]

commit b610cab1d68def7b8df16ed5bd13199779ffb07b
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Fri Jul 23 13:46:59 2010 +0200

    Updated the /etc/sysconfig/firstboot section.

 en-US/The_sysconfig_Directory.xml |   22 ++++++++++++++++++++--
 1 files changed, 20 insertions(+), 2 deletions(-)
---
diff --git a/en-US/The_sysconfig_Directory.xml b/en-US/The_sysconfig_Directory.xml
index dc2394a..953a59e 100644
--- a/en-US/The_sysconfig_Directory.xml
+++ b/en-US/The_sysconfig_Directory.xml
@@ -469,11 +469,29 @@
         <secondary><filename>/etc/sysconfig/firstboot</filename></secondary>
       </indexterm>
       <para>
-        The first time the system boots, the <command>/sbin/init</command> program calls the <filename>etc/rc.d/init.d/firstboot</filename> script, which in turn launches the <application> Setup Agent</application>. This application allows the user to install the latest updates as well as additional applications and documentation.
+        The <filename>/etc/sysconfig/firstboot</filename> file defines whether to run the <command>firstboot</command> utility. By default, it contains the following option:
       </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>RUN_FIRSTBOOT=<replaceable>boolean</replaceable></option></term>
+          <listitem>
+            <para>
+              A boolean to enable (<option>YES</option>) or disable (<option>NO</option>) running the <command>firstboot</command> program. For example:
+            </para>
+            <screen>RUN_FIRSTBOOT=NO</screen>
+          </listitem>
+        </varlistentry>
+      </variablelist>
       <para>
-        The <filename>/etc/sysconfig/firstboot</filename> file tells the <application> Setup Agent</application> application not to run on subsequent reboots. To run it the next time the system boots, remove <filename>/etc/sysconfig/firstboot</filename> and execute <command>chkconfig --level 5 firstboot on</command>.
+        The first time the system boots, the <command>init</command> program calls the <filename>/etc/rc.d/init.d/firstboot</filename> script, which looks for the <filename>/etc/sysconfig/firstboot</filename> file. If this file does not contain the <option>RUN_FIRSTBOOT=NO</option> option, the <command>firstboot</command> program is run, guiding a user through the initial configuration of the system.
       </para>
+      <note>
+        <title>Tip: You Can Run the <command>firstboot</command> Program Again</title>
+        <para>
+          To start the <command>firstboot</command> program the next time the system boots, change the value of <command>RUN_FIRSTBOOT</command> option to <option>YES</option>, and type the following at a shell prompt:
+        </para>
+        <screen>~]# <command>chkconfig firstboot on</command></screen>
+      </note>
     </section>
     <section id="s2-sysconfig-i18n">
       <title><filename>/etc/sysconfig/i18n</filename></title>