install-guide fedora-install-guide-diskpartitioning-en.xml, 1.3, 1.4 fedora-install-guide-en.xml, 1.10, 1.11 fedora-install-guide-installtypes-en.xml, 1.3, 1.4 fedora-install-guide-other-instmethods-en.xml, 1.5, 1.6 fedora-install-guide-upgrading-en.xml, 1.4, 1.5

Paul W. Frields (pfrields) fedora-docs-commits at redhat.com
Thu May 12 22:27:33 UTC 2005


Author: pfrields

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

Modified Files:
	fedora-install-guide-diskpartitioning-en.xml 
	fedora-install-guide-en.xml 
	fedora-install-guide-installtypes-en.xml 
	fedora-install-guide-other-instmethods-en.xml 
	fedora-install-guide-upgrading-en.xml 
Log Message:
Style editing continues, started indexing


Index: fedora-install-guide-diskpartitioning-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-diskpartitioning-en.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- fedora-install-guide-diskpartitioning-en.xml	3 May 2005 12:19:44 -0000	1.3
+++ fedora-install-guide-diskpartitioning-en.xml	12 May 2005 22:27:31 -0000	1.4
@@ -3,56 +3,92 @@
   <title>Disk Partitioning</title>
  
   <para>
-    This section describes how to use the installation program to
-    partition disks attached to your &FED; system.  If you are new to
-    Linux, you may want to simply use the automatic partitioning method.
-    If you are a more experienced Linux user, you can use the manual
-    partitioning method to have more control over your system
+    If you are new to Linux, you may want to use the automatic
+    partitioning method.  If you are a more experienced Linux user, use
+    the manual partitioning method for more control over your system
     configuration.
   </para>
 
   <section id="sn-choosing-partition-method">
     <title>Choosing a Partitioning Method</title>
-    
+
     <section id="sn-automatic-partitioning">
       <title>Setting Up Partitions Automatically</title>
 
       <para>
 	Choose <guilabel>Automatic partitioning</guilabel> at the
-	partitioning menu to have a partition scheme set up for you.
+	partitioning menu to use a preset partitioning layout.
 	<application>Disk Druid</application> then displays additional
-	options.  Select <guilabel>Remove all Linux partitions on this
-	  system</guilabel> to remove all <firstterm>ext2</firstterm>,
-	<firstterm>ext3</firstterm>, or <firstterm>Linux
-	  swap</firstterm> partitions from all hard disks.  Select
-	<guilabel>Remove all partitions on this system</guilabel> to
-	remove all partitions from all hard disks.  Select
-	<guilabel>Keep all partitions and use only existing free
-	  space</guilabel> to use only the unpartitioned space on the
-	hard disk(s) to install &FC;.
+	options:
       </para>
+
+      <variablelist>
+	<varlistentry>
+	  <term><guilabel>Remove all Linux partitions on this
+	      system</guilabel></term>
+	  <listitem>
+	    <para>
+	      Removes all <firstterm>ext2</firstterm>,
+	      <firstterm>ext3</firstterm>, and <firstterm>Linux
+		swap</firstterm> partitions from all hard disks
+	    </para>
+	  </listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term><guilabel>Remove all partitions on this
+	      system</guilabel></term>
+	  <listitem>
+	    <para>
+	      Removes <emphasis>all</emphasis> partitions from all hard
+	      disks
+	    </para>
+	  </listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term><guilabel>Keep all partitions and use only existing free
+	      space</guilabel></term>
+	  <listitem>
+	    <para>
+	      Uses only the unpartitioned space on the hard disk(s) to
+	      install &FC;
+	    </para>
+	  </listitem>
+	</varlistentry>
+      </variablelist>
+
+      <para>
+	Select the desired option.
+      </para>
+
       <para>
 	Next, select the drive(s) you wish to use for Linux partitions.
-	If your system contains only one disk, that disk will
-	automatically be selected.  If you are confused about the device
-	names used in this box, consult the Linux Partition-HOWTO at
-	<ulink
-	  url="http://www.tldp.org/HOWTO/Partition/partition-2.html">http://www.tldp.org/HOWTO/Partition/partition-2.html</ulink>. 
-	Any drives you select will be used for Linux partitions
-	according to the option selected above.  The option selection is
-	global, and you may not select a different option for each disk.
+	If your system contains only one disk, that disk is
+	automatically selected.  Any drives you select are used for
+	Linux partitions according to the option selected above.  The
+	option selection is global, and you may not select a different
+	option for each disk.
       </para>
+
+      <note>
+	<title>Device Names</title>
+	<para>
+	  If you are confused about the device names used in this box,
+	  consult the Linux Partition-HOWTO at <ulink
+	    url="http://www.tldp.org/HOWTO/Partition/partition-2.html">http://www.tldp.org/HOWTO/Partition/partition-2.html</ulink>.
+	</para>
+      </note>
+
       <para>
-	If you wish to review the automatic partition configuration,
-	select the <guilabel>Review</guilabel> checkbox.
+	To review the automatic partition configuration, select the
+	<guilabel>Review</guilabel> checkbox.
       </para>
       <para>
-	  If you chose to remove any existing partitions, the
-	installation program will ask you to confirm this choice. Once
-	you have reviewed and approve of the partition configuration,
-	select <guibutton>Next</guibutton> to continue to the next
-	installation step.  Proceed with <xref
-	    linkend="ch-bootloader"/>.
+	If you remove any existing partitions, the installation program
+	asks you to confirm this choice.  Once you have reviewed and
+	approve of the partition configuration, select
+	<guibutton>Next</guibutton> to continue to the next installation
+	step.  Proceed with <xref
+	  linkend="ch-bootloader"/>.
       </para>
 
     </section>
@@ -61,13 +97,12 @@
       <title>Setting Up Partitions Manually</title>
 
       <para>
-	  If you wish to manually set up all disk partitions, choose
-	<guilabel>Manually partition with Disk Druid</guilabel>.  You
-	should choose this method if you require a special partition
-	configuration.  If you are familiar with how disk partitions and
-	the Linux file system work, move on to <xref
-	    linkend="sn-disk-druid"/>.  Otherwise, read <xref
-	    linkend="sn-partitioning-general"/>.
+	To manually set up all disk partitions, choose
+	<guilabel>Manually partition with Disk Druid</guilabel>.  Choose
+	this method if you require a special partition configuration.  If
+	you are familiar with how disk partitions and the Linux file
+	system work, move on to <xref linkend="sn-disk-druid"/>.
+	Otherwise, read <xref linkend="sn-partitioning-general"/>.
       </para>
 
     </section>
@@ -78,7 +113,7 @@
     <title>General Information</title>
 
     <para>
-      A &FC; system should have at least three partitions installed:
+      A &FC; system has at least three partitions:
     </para>
     <itemizedlist>
       <listitem>
@@ -98,27 +133,44 @@
       </listitem>
     </itemizedlist>
     <para>
-	Most systems have more partitions than the minimum listed above.
+      Most systems have more partitions than the minimum listed above.
       Choose partitions based on your particular system needs.  If you
       are not sure what to choose, use the "Automatic partitioning"
       method shown in <xref linkend="sn-choosing-partition-method"/>.
     </para>
     <para>
-      Every partition must have a <firstterm>partition type</firstterm>.
-      The partition type indicates the file system expected on that
-      partition.  The most common partition type for &FED; is
-      <firstterm>ext3</firstterm> or <firstterm>ext2</firstterm>.  The
-      ext3 file system provides more robust features for preventing data
-      loss.  Most &FED; administrators choose this type for data
-      partitions.
+      Every partition has a <indexterm>
+	<primary>partition</primary>
+	<secondary>type</secondary>
+	<seealso>file system</seealso>
+      </indexterm> <firstterm>partition type</firstterm>.  The partition
+      type indicates the <indexterm>
+	<primary>file system</primary>
+      </indexterm> <firstterm>file system</firstterm> expected on that
+      partition.  A file system allows a Linux system to more
+      effectively organize, search, and retrieve files.  The most common
+      partition type for &FED; is <indexterm>
+	<primary>ext3</primary>
+	<see>file system</see>
+      </indexterm><indexterm>
+	<primary>file system</primary>
+	<secondary>ext3</secondary>
+      </indexterm> <firstterm>ext3</firstterm>.  The ext3 file system
+      provides more robust features for preventing data loss.  Most
+      &FED; administrators choose this type for data partitions.
     </para>
     <para>
-      Most partitions have a <firstterm>mount point</firstterm>.  The
-      mount point indicates the directory whose contents will reside on
-      that partition.  Data that does not reside on any other partition
-      will be in the <filename>/</filename> (or
-      <firstterm>"root"</firstterm>) partition.  In the minimum
-      configuration shown above:
+      Most partitions have a <indexterm>
+	<primary>mount point</primary>
+      </indexterm> <firstterm>mount point</firstterm>.  The mount point
+      indicates the directory whose contents reside on that partition.  A
+      partition with no mount point is not accessible by users.  Data
+      not located on any other partition resides in the
+      <filename>/</filename> (or <indexterm>
+	<primary>partition</primary>
+	<secondary>root</secondary>
+      </indexterm> <firstterm>"root"</firstterm>) partition.  In the
+      minimum configuration shown above:
     </para>
     <itemizedlist>
       <listitem>
@@ -149,9 +201,9 @@
       <filename>/usr</filename> partition.
     </para>
     <para>
-      When you create partitions in this manner, as opposed to using one
-      large <filename>/</filename> partition, upgrades may be easier.
-      See the description of <application>Disk Druid's</application>
+      When you create many partitions instead of one large
+      <filename>/</filename> partition, upgrades become easier.  Refer
+      to the description of <application>Disk Druid's</application>
       <link linkend="disk-druid-edit">Edit option</link> for more
       information.
     </para>
@@ -183,10 +235,10 @@
     <title>Disk Druid</title>
 
     <para>
-	<application><firstterm>Disk Druid</firstterm></application>
-	<indexterm>
+      <application><firstterm>Disk Druid</firstterm></application>
+      <indexterm>
 	<primary>Disk Druid</primary>
-	</indexterm> is an interactive program for editing disk
+      </indexterm> is an interactive program for editing disk
       partitions.  It is only available within the &FC; installation
       system.  Disk Druid supports advanced technologies such as
       <firstterm>RAID</firstterm> and <firstterm>LVM</firstterm>, which
@@ -206,7 +258,7 @@
 	    to the disk.  In the <guilabel>Add partition</guilabel>
 	    dialog, choose a mount point and a partition type.  If you
 	    have more than one disk on the system, choose which disks
-	    the partition may inhabit. Indicate a size in megabytes for
+	    the partition may inhabit.  Indicate a size in megabytes for
 	    the partition.
 	  </para>
 	  <note>
@@ -224,10 +276,16 @@
 	  <important>
 	    <title>Root and <filename>/root</filename></title>
 	    <para>
-	      The <filename>/</filename> (or "root") partition is the
-	      top of the file system.  The <filename>/root</filename>
-	      (or "slash-root") directory is the home directory of the
-	      administrator.
+	      The <filename>/</filename> (or <indexterm>
+		<primary>partition</primary>
+		<secondary>root</secondary>
+	      </indexterm> "root") partition is the top of the file
+	      system.  The <indexterm>
+		<primary>partition</primary>
+		<secondary><filename>/root</filename></secondary>
+	      </indexterm> <filename>/root</filename> (sometimes
+	      pronounced "slash-root") directory is the home directory
+	      of the administrator.
 	    </para>
 	  </important>
 	  <para>
@@ -314,9 +372,16 @@
 	    <title>Windows Partitions</title>
 	    <para>
 	      You may not label Windows partitions that use the NTFS
-	      file system with a mount point in the &FC; installer. You
-	      may label <firstterm>vfat</firstterm> (FAT-16 or FAT-32)
-	      partitions with a mount point.
+	      file system with a mount point in the &FC; installer.  You
+	      may label <indexterm>
+		<primary>vfat</primary>
+		<see>file system</see>
+	      </indexterm>
+	      <indexterm>
+		<primary>file system</primary>
+		<secondary>vfat</secondary>
+	      </indexterm> <firstterm>vfat</firstterm> (FAT-16 or
+	      FAT-32) partitions with a mount point.
 	    </para>
 	  </note>
 	  <para>
@@ -329,7 +394,7 @@
 	  </para>
 	  <para>
 	    If you have many separate partitions for system and user
-	    data, it will be easier for you to upgrade your system. The
+	    data, it will be easier for you to upgrade your system.  The
 	    installation program allows you to erase or retain data on
 	    specific partitions.  If your user data is on a separate
 	    <filename>/home</filename> partition, you may retain that
@@ -423,7 +488,7 @@
 	    <para>
 	      In LVM, one or more physical volumes are combined to form
 	      a volume group.  Each volume group's total storage may be
-	      apportioned for one or more logical volumes. Logical
+	      apportioned for one or more logical volumes.  Logical
 	      volumes function much like standard data partitions.  They
 	      have a file system type, such as ext3, and a mount point.
 	      An administrator may grow or shrink logical volumes


Index: fedora-install-guide-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-en.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- fedora-install-guide-en.xml	10 May 2005 21:33:51 -0000	1.10
+++ fedora-install-guide-en.xml	12 May 2005 22:27:31 -0000	1.11
@@ -119,7 +119,9 @@
 
   &ACKNOWLEDGEMENTS;
 
-<!-- add generated index tag once the indexing is in place -->
+  <index id="generated-index">
+  </index>
+
 </book>
 
 <!--


Index: fedora-install-guide-installtypes-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-installtypes-en.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- fedora-install-guide-installtypes-en.xml	3 May 2005 12:19:44 -0000	1.3
+++ fedora-install-guide-installtypes-en.xml	12 May 2005 22:27:31 -0000	1.4
@@ -1,91 +1,107 @@
 <!-- $Id: -->
 
 <chapter id="ch-installtypes">
-  <title>First Step: Installation Type</title>
+  <title>Installation Types</title>
 
   <para>
-    Installation types enable you to ensure that your &FED; system is
-    loaded with the correct software without needing to specify
-    individual packages.  The installation type that you choose
-    determines the suggested software later on in the installation
-    process.  You can customize the package selection at that point if
-    you wish to do so.
-  </para>
-
-  <figure id="fig-install-types">
-    <title>Installation Type Screen</title>
-    <mediaobject>
-      <imageobject>
-        <imagedata fileref="./figs/install-types.eps" format="EPS"/>
-      </imageobject>
-      <imageobject>
-        <imagedata fileref="./figs/install-types.png" format="PNG"/>
-      </imageobject>
-      <textobject>
-        <para>
-	  Installation type screen.
-        </para>
-      </textobject>
-    </mediaobject>
-  </figure>
+    An <firstterm>installation type</firstterm> is a label that roughly
+    describes how you will use your &FED; system.  Several installation
+    types are already defined in the &FC; installation program. Choose
+    the appropriate installation type to streamline the installation
+    process if you are a beginner.  The installation program makes some
+    choices for you based on the type you select. These choices include
+    partitioning of your hard disks, and software packages to be
+    installed.  All installation types allow you to customize these
+    selections.
+  </para>
+
+  <section id="ch-choosing-installtype">
+    <title>Choosing an Installation Type</title>
+
+    <figure id="fig-install-types">
+      <title>Installation Type Screen</title>
+      <mediaobject>
+	<imageobject>
+	  <imagedata fileref="./figs/install-types.eps" format="EPS"/>
+	</imageobject>
+	<imageobject>
+	  <imagedata fileref="./figs/install-types.png" format="PNG"/>
+	</imageobject>
+	<textobject>
+	  <para>
+	    Installation type screen.
+	  </para>
+	</textobject>
+      </mediaobject>
+    </figure>
 
-  <para>
-    A <guilabel>Personal Desktop</guilabel> installation is the default.
-    It provides a graphical working environment with an office suite,
-    Internet applications and multimedia software.
-  </para>
+    <para>
+      The default installation type is a <guilabel>Personal
+	Desktop</guilabel>.  It provides a graphical working environment
+      with an office suite, Internet applications and multimedia
+      software.
+    </para>
 
-  <para>
-    A <guilabel>Workstation</guilabel> installation includes the same
-    software as a <guilabel>Personal Desktop</guilabel>.  Extra software
-    will also be installed for development and systems administration.
-    Choose this installation type if you will be compiling software from
-    source code.
-  </para>
+    <para>
+      A <guilabel>Workstation</guilabel> installation includes the
+      software installed on a <guilabel>Personal Desktop</guilabel>, and
+      adds software for development and systems administration.  Choose
+      this installation type if you plan to compile software from source
+      code.
+    </para>
 
-  <para>
-    A <guilabel>Server</guilabel> installation automatically provides
-    the Apache Web server and the Samba suite of services, along with
-    administration tools.  By default, no graphical environment is
-    included.
-  </para>
+    <para>
+      A <guilabel>Server</guilabel> installation provides network
+      servers such as the Apache Web server and the Samba suite of
+      services, and administration tools.  The
+      <guilabel>Server</guilabel> installation type provides no
+      graphical environment by default.
+    </para>
 
-  <para>
-    If you choose to perform a <guilabel>Custom</guilabel> installation
-    then you will automatically be presented with the <guilabel>Package
-      Group Selection</guilabel> screen later on in the installation
-    process.
-  </para>
+    <para>
+      The <guilabel>Custom</guilabel> installation type does not provide
+      any disk partitioning layout for you.  It also does not include
+      any additional software beyond a <guilabel>Personal
+	Desktop</guilabel>. If you perform a <guilabel>Custom</guilabel>
+      installation, the installation program will present dialogs for
+      these selections during the installation process.
+    </para>
 
-  <note>
-    <title>Default network services</title>
     <para>
-      All &FC; installations include e-mail (SMTP), file sharing (NFS),
-      printing (CUPS) and remote login (SSH) services.  Various
-      automated processes on your &FED; system use the e-mail service to
-      send reports and messages to the system administrator.  By default
-      the e-mail and printing services do not accept connections from
-      other systems.
+      Click <guibutton>Next</guibutton> once you have made a selection.
     </para>
-  </note>  
 
-  <para>
-    Click <guibutton>Next</guibutton> once you have made a selection.
-  </para>
+  </section>
+
+  <section id="installtype-notes">
+    <title>Special Considerations</title>
 
-  <tip>
-    <title>Minimal installations</title>
     <para>
-      To install a system with the minimum of software choose the
-      <guilabel>Custom</guilabel> installation type.  On the
-      <guilabel>Package Group Selection</guilabel> screen select the
-      <guilabel>Minimal</guilabel> package group.  A small command-line
-      only system will then be installed.  The only services that are
-      included in a <guilabel>Minimal</guilabel> installation are CUPS,
-      NFS, SMTP and SSH.  This type of installation is useful as a basis
-      for preparing specialized systems.
+      All &FC; installations include email (SMTP), file sharing (NFS),
+      printing (CUPS) and remote login (SSH) services.  Some automated
+      processes on your &FED; system use the email service to send
+      reports and messages to the system administrator.  By default, the
+      email and printing services do not accept connections from other
+      systems.  If you want your &FED; system to function as an email or
+      print server, you may configure it after installation.
     </para>
-  </tip>
+
+    <tip>
+      <title>Minimal installations</title>
+      <para>
+	To install a minimum of software, choose the
+	<guilabel>Custom</guilabel> installation type.  On the
+	<guilabel>Package Group Selection</guilabel> screen, select the
+	<guilabel>Minimal</guilabel> package group.  The only services
+	included in a <guilabel>Minimal</guilabel> installation are
+	printing, email (SMTP), secure remote login (SSH), and network
+	file access (NFS).  This type of installation may be useful for
+	firewalls or other specialized systems on which limited service
+	is an advantage.
+      </para>
+    </tip>
+
+  </section>
 
 </chapter>
 


Index: fedora-install-guide-other-instmethods-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-other-instmethods-en.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- fedora-install-guide-other-instmethods-en.xml	8 May 2005 23:33:13 -0000	1.5
+++ fedora-install-guide-other-instmethods-en.xml	12 May 2005 22:27:31 -0000	1.6
@@ -169,7 +169,7 @@
     <title>Installation from a Hard Drive</title>
 
     <para>
-      You may install from a hard drive containing the ISO image files
+      You can install from a hard drive containing the ISO image files
       for the &FED; discs.  The hard drive can be either internal to the
       computer, or attached by USB.  The partition on the hard drive
       holding the ISO files must be formatted with either ext2, ext3 or
@@ -200,16 +200,18 @@
 
     <para>
       Select the partition containing the ISO files from the list of
-      available partitions.  Each drive is assigned a unique letter.
-      Each partition on a drive is numbered.  Internal IDE drive device
-      names begin with <filename>/dev/hd</filename>.  SCSI or USB drive
-      device names begin with <filename>/dev/sd</filename>.
+      available partitions.  Internal IDE drive device names begin with
+      <filename>/dev/hd</filename>.  SCSI or USB drive device names
+      begin with <filename>/dev/sd</filename>.  Each individual drive
+      has its own letter, for example <filename>/dev/hda</filename>.
+      Each partition on a drive is numbered, for example
+      <filename>/dev/sda1</filename>.
     </para>
 
     <para>
-      You must also specify the <guilabel>Directory holding
-	images</guilabel>.  Enter the full directory path on the drive
-      that contains the ISO image files.
+      Also specify the <guilabel>Directory holding images</guilabel>.
+      Enter the full directory path on the drive that contains the ISO
+      image files.
     </para>
 
     <para>


Index: fedora-install-guide-upgrading-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-upgrading-en.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- fedora-install-guide-upgrading-en.xml	9 May 2005 21:28:28 -0000	1.4
+++ fedora-install-guide-upgrading-en.xml	12 May 2005 22:27:31 -0000	1.5
@@ -34,20 +34,20 @@
   </para>
 
   <para>
-    An upgrade consists of updating the existing &FC; or &RHL;
-    installation with the software packages for the new version.  Your
-    data is not lost, and the existing partition structure on your hard
-    drives does not change.  Your system configuration changes only if a
-    package upgrade demands it.  The upgrade process does not delete any
-    files in the <filename>/home/</filename> and the
-    <filename>/usr/local/</filename> directories.
+    The upgrade process updates the existing &FC; or &RHL; software with
+    new versions.  The process does not remove any data from users' home
+    directories.  The existing partition structure on your hard drives
+    does not change.  Your system configuration changes only if a
+    package upgrade demands it.  Most package upgrades do not change
+    system configuration, but rather install an additional configuration
+    file for you to examine later.
   </para>
 
   <note>
     <title>Manually Installed Software</title>
     <para>
-      Software which you installed manually on your existing &FC; or
-      &RHL; system may behave differently after an upgrade.  You may
+      Software which you have installed manually on your existing &FC;
+      or &RHL; system may behave differently after an upgrade.  You may
       manually recompile this software after an upgrade to ensure it
       performs correctly on the updated system.
     </para>




More information about the Fedora-docs-commits mailing list