[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[RFC] Some updates to the installation guide



Hi!

Attached you will find some updates that I would like to make to the
installation guide.  Reviews welcome.

Cheers,
-- 
Jérémy Bobbio                        .''`. 
lunar@debian.org                    : :Ⓐ  :  # apt-get install anarchism
                                    `. `'` 
                                      `-   
commit 70141489b502f43c35930a528906c838b7511fd7
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sat Aug 16 19:32:55 2008 +0000

    Explicitely mention than preseeded keymaps must be known to d-i
    
    (Closes: #493720)

diff --git a/manual/debian/changelog b/manual/debian/changelog
index 0e7d2b1..cfebc19 100644
--- a/manual/debian/changelog
+++ b/manual/debian/changelog
@@ -17,6 +17,10 @@ installation-guide (2008xxxx) UNRELEASED; urgency=medium
     automatically work w/o it if there's just 1 disk. Closes: #490287
   * Document hw-detect/load_firmware. Closes: #493845
 
+  [ Jérémy Bobbio ]
+  * Explicitely mention than preseeded keymaps must be known to d-i.
+    Closes: #493720
+
  -- Frans Pop <fjp@debian.org>  Wed, 02 Jul 2008 17:06:28 +0200
 
 installation-guide (20080520) unstable; urgency=medium
diff --git a/manual/en/appendix/preseed.xml b/manual/en/appendix/preseed.xml
index e96adeb..a51fb07 100644
--- a/manual/en/appendix/preseed.xml
+++ b/manual/en/appendix/preseed.xml
@@ -727,7 +727,7 @@ d-i debian-installer/locale string en_US
 Keyboard configuration consists of selecting a keyboard architecture and a
 keymap. In most cases the correct keyboard architecture is selected by
 default, so there's normally no need to preseed it. The keymap must
-be valid for the selected  keyboard architecture.
+be known to the debian-installer for the selected keyboard architecture.
 
 <informalexample role="example"><screen>
 # Keyboard selection.

commit 33d5685a138f449fb1577860d7f19c4f62802361
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Tue Aug 19 18:08:39 2008 +0000

    Mention parman-md/device_remove_md in preseeding appendix

diff --git a/manual/debian/changelog b/manual/debian/changelog
index cfebc19..69277bb 100644
--- a/manual/debian/changelog
+++ b/manual/debian/changelog
@@ -20,6 +20,7 @@ installation-guide (2008xxxx) UNRELEASED; urgency=medium
   [ Jérémy Bobbio ]
   * Explicitely mention than preseeded keymaps must be known to d-i.
     Closes: #493720
+  * Mention parman-md/device_remove_md in preseeding appendix.
 
  -- Frans Pop <fjp@debian.org>  Wed, 02 Jul 2008 17:06:28 +0200
 
diff --git a/manual/en/appendix/preseed.xml b/manual/en/appendix/preseed.xml
index a51fb07..36cac12 100644
--- a/manual/en/appendix/preseed.xml
+++ b/manual/en/appendix/preseed.xml
@@ -940,6 +940,8 @@ d-i partman-auto/method string lvm
 # contains an old LVM configuration, the user will normally receive a
 # warning. This can be preseeded away...
 d-i partman-lvm/device_remove_lvm boolean true
+# The same can be applied to previous software RAID array:
+d-i parman-md/device_remove_md boolean true
 # And the same goes for the confirmation to write the lvm partitions.
 d-i partman-lvm/confirm boolean true
 

commit cca60d068fa861553b41fe53a33bfb819e0805c1
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 09:32:13 2008 +0000

    Don't capitalize for in preface title

diff --git a/manual/en/preface.xml b/manual/en/preface.xml
index b5ffe44..9aadad5 100644
--- a/manual/en/preface.xml
+++ b/manual/en/preface.xml
@@ -2,7 +2,7 @@
 <!-- $Id$ -->
 
 <preface>
- <title>Installing &debian; &release; For &architecture;</title>
+ <title>Installing &debian; &release; for &architecture;</title>
 <para>
 
 We are delighted that you have decided to try Debian, and are

commit 106eb89ff5d286f43d0905b266b3aaae4d53d7f1
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 09:49:37 2008 +0000

    Remove MCA, VLB; add PCIe in i386 bus list

diff --git a/manual/en/hardware/supported/i386.xml b/manual/en/hardware/supported/i386.xml
index 60a2b71..f53eab4 100644
--- a/manual/en/hardware/supported/i386.xml
+++ b/manual/en/hardware/supported/i386.xml
@@ -69,10 +69,8 @@ be easily used by most Debian packages; now they can.
 
 The system bus is the part of the motherboard which allows the CPU to
 communicate with peripherals such as storage devices.  Your computer
-must use the ISA, EISA, PCI, the Microchannel Architecture (MCA, used
-in IBM's PS/2 line), or VESA Local Bus (VLB, sometimes called the VL
-bus).  Essentially all personal computers sold in recent years use one
-of these.
+must use the ISA, EISA, PCI, PCIe.  Essentially all personal computers sold in
+recent years use one of these.
 
 </para>
    </sect3>

commit 62ff748d6cfd029749cbfc558686737c115411cf
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 09:58:55 2008 +0000

    Remove mention of obsolete CD drivers on i386

diff --git a/manual/en/hardware/installation-media.xml b/manual/en/hardware/installation-media.xml
index 7348d5e..e114f23 100644
--- a/manual/en/hardware/installation-media.xml
+++ b/manual/en/hardware/installation-media.xml
@@ -52,13 +52,9 @@ up by other means; see <xref linkend="boot-installer"/>.
 
 </para><para arch="x86">
 
-Both SCSI and IDE/ATAPI CD-ROMs are supported.  In addition, all
-non-standard CD interfaces supported by Linux are supported by the
-boot disks (such as Mitsumi and Matsushita drives).  However, these
-models might require special boot parameters or other massaging to get
-them to work, and booting off these non-standard interfaces is
-unlikely.  The <ulink url="&url-cd-howto;">Linux CD-ROM HOWTO</ulink>
-contains in-depth information on using CD-ROMs with Linux.
+Both SCSI and IDE/ATAPI CD-ROMs are supported.  The <ulink
+url="&url-cd-howto;">Linux CD-ROM HOWTO</ulink> contains in-depth information
+on using CD-ROMs with Linux.
 
 </para><para arch="x86">
 

commit 7b149b1f0765f05fb4d429b70da98d7a2e75da26
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 10:07:14 2008 +0000

    Remove mention of XT drive interface on i386

diff --git a/manual/en/hardware/installation-media.xml b/manual/en/hardware/installation-media.xml
index e114f23..93fe9c2 100644
--- a/manual/en/hardware/installation-media.xml
+++ b/manual/en/hardware/installation-media.xml
@@ -189,10 +189,8 @@ Win-32 FAT extensions (VFAT) and NTFS.
 </para><para arch="i386">
 
 Disk interfaces that emulate the <quote>AT</quote> hard disk interface
-&mdash; often called MFM, RLL, IDE, or ATA &mdash; are supported.  Very old
-8&ndash;bit hard disk controllers used in the IBM XT computer are supported
-only as a module. SCSI disk controllers from many different manufacturers
-are supported. See the
+&mdash; often called MFM, RLL, IDE, or ATA &mdash; are supported.  SCSI disk
+controllers from many different manufacturers are supported. See the
 <ulink url="&url-hardware-howto;">Linux Hardware Compatibility HOWTO</ulink>
 for more details.
 

commit f6ed20c3d8978829d74dcaee1f8411f00ee7f3be
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 10:29:09 2008 +0000

    Fix minimum memory requirement for graphical installations

diff --git a/manual/en/hardware/memory-disk-requirements.xml b/manual/en/hardware/memory-disk-requirements.xml
index 7adc696..b1922fd 100644
--- a/manual/en/hardware/memory-disk-requirements.xml
+++ b/manual/en/hardware/memory-disk-requirements.xml
@@ -19,7 +19,7 @@ Installation on systems with less memory<footnote condition="gtk">
 
 Installation images that support the graphical installer require more
 memory than images that support only the textual installer and should
-not be used on systems with less than &minimum-memory; of memory. If
+not be used on systems with less than &minimum-memory-gtk; of memory. If
 there is a choice between booting the regular and the graphical installer,
 the former should be selected.
 

commit f17acfacb94d9429ba2002bf230fc5bfb3878aaf
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 10:39:25 2008 +0000

    Mention SATA along IDE

diff --git a/manual/en/hardware/installation-media.xml b/manual/en/hardware/installation-media.xml
index 93fe9c2..879f965 100644
--- a/manual/en/hardware/installation-media.xml
+++ b/manual/en/hardware/installation-media.xml
@@ -52,7 +52,7 @@ up by other means; see <xref linkend="boot-installer"/>.
 
 </para><para arch="x86">
 
-Both SCSI and IDE/ATAPI CD-ROMs are supported.  The <ulink
+SCSI, SATA and IDE/ATAPI CD-ROMs are supported.  The <ulink
 url="&url-cd-howto;">Linux CD-ROM HOWTO</ulink> contains in-depth information
 on using CD-ROMs with Linux.
 
@@ -182,15 +182,15 @@ installed on the widest array of hardware.
 </para><para arch="x86">
 
 Generally, the Debian installation system includes support for floppies,
-IDE drives, IDE floppies, parallel port IDE devices, SCSI controllers and
-drives, USB, and FireWire.  The supported file systems include FAT,
-Win-32 FAT extensions (VFAT) and NTFS.
+IDE drives, IDE floppies, parallel port IDE devices, SATA and SCSI controllers
+and drives, USB, and FireWire.  The supported file systems include FAT, Win-32
+FAT extensions (VFAT) and NTFS.
 
 </para><para arch="i386">
 
 Disk interfaces that emulate the <quote>AT</quote> hard disk interface
-&mdash; often called MFM, RLL, IDE, or ATA &mdash; are supported.  SCSI disk
-controllers from many different manufacturers are supported. See the
+&mdash; often called MFM, RLL, IDE, or ATA &mdash; are supported.  SATA and
+SCSI disk controllers from many different manufacturers are supported. See the
 <ulink url="&url-hardware-howto;">Linux Hardware Compatibility HOWTO</ulink>
 for more details.
 
diff --git a/manual/en/preparing/needed-info.xml b/manual/en/preparing/needed-info.xml
index 04574e7..235ec2a 100644
--- a/manual/en/preparing/needed-info.xml
+++ b/manual/en/preparing/needed-info.xml
@@ -216,7 +216,7 @@ networking and e-mail.
 <row arch="not-s390"><entry>Their order on the system.</entry></row>
 <!-- "not-m68k;not-s390" would really turn out to be everything... -->
 <row arch="alpha;arm;hppa;x86;ia64;mips;mipsel;powerpc;sparc">
-  <entry>Whether IDE or SCSI (most computers are IDE).</entry>
+  <entry>Whether IDE, SATA or SCSI (most computers are IDE).</entry>
 </row>
 <row arch="m68k">
   <entry>Whether IDE or SCSI (most m68k computers are SCSI).</entry>

commit 886f1bd1ad4ca781491d1746c8e5ecd21c9bbd2d
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 14:05:46 2008 +0200

    Emphase that not all CDs are DVDs are needed.

diff --git a/manual/en/install-methods/official-cdrom.xml b/manual/en/install-methods/official-cdrom.xml
index 3b8c449..87aa1a4 100644
--- a/manual/en/install-methods/official-cdrom.xml
+++ b/manual/en/install-methods/official-cdrom.xml
@@ -15,10 +15,11 @@ detailed instructions). If you have a Debian CD set and CDs are
 bootable on your machine, you can skip right to
 <xref linkend="boot-installer"/>; much effort has been expended to ensure
 the files most people need are there on the CD. Although a full set of
-binary packages requires several CDs, it is unlikely you will need
-packages on the third CD and above. You may also consider using the
+binary packages requires several CDs, <emphasis>it is unlikely you will need
+packages on the third CD and above</emphasis>. You may also consider using the
 DVD version, which saves a lot of space on your shelf and you avoid
-the CD shuffling marathon.
+the CD shuffling marathon. Likewise, the <emphasis>first DVD should be
+sufficient for most installations</emphasis>.
 
 </para><para>
 

commit 556bd4b93c33f5b454fb4a267f8e7da0ec5c16a3
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 14:08:55 2008 +0200

    Binary mode only applies to FTP

diff --git a/manual/en/install-methods/downloading-files.xml b/manual/en/install-methods/downloading-files.xml
index c557c1b..6629862 100644
--- a/manual/en/install-methods/downloading-files.xml
+++ b/manual/en/install-methods/downloading-files.xml
@@ -11,9 +11,8 @@ To find the nearest (and thus probably the fastest) mirror, see the
 
 </para><para>
 
-When downloading files from a Debian mirror, be sure to download the
-files in <emphasis>binary</emphasis> mode, not text or automatic
-mode.
+When downloading files from a Debian mirror using FTP, be sure to download the
+files in <emphasis>binary</emphasis> mode, not text or automatic mode.
 
 </para>
 

commit a3dd1ac85238f15f9cfb582e84ce9622e63427e3
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 15:06:02 2008 +0200

    The character-based frontend is 'usual', not 'normal'

diff --git a/manual/en/using-d-i/using-d-i.xml b/manual/en/using-d-i/using-d-i.xml
index 3936c80..9c6e410 100644
--- a/manual/en/using-d-i/using-d-i.xml
+++ b/manual/en/using-d-i/using-d-i.xml
@@ -58,7 +58,7 @@ Expert mode gives you full control over &d-i;.
 
 </para><para>
 
-The normal installer display is character-based (as opposed to the now
+The usual installer display is character-based (as opposed to the now
 more familiar graphical interface). The mouse is not operational in
 this environment. Here are the keys you can use to navigate within the
 various dialogs.  The <keycap>Tab</keycap> or <keycap>right</keycap>

commit 1a571aacf477dbe03bc5e8b3c4d175b10b236c13
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 15:28:01 2008 +0200

    apache2 will be installed in Lenny

diff --git a/manual/en/using-d-i/modules/pkgsel.xml b/manual/en/using-d-i/modules/pkgsel.xml
index 84d8dbe..cbbcf12 100644
--- a/manual/en/using-d-i/modules/pkgsel.xml
+++ b/manual/en/using-d-i/modules/pkgsel.xml
@@ -81,7 +81,7 @@ Mail server: <classname>exim4</classname>, <classname>spamassassin</classname>,
 <classname>uw-imap</classname>;
 Print server: <classname>cups</classname>;
 SQL database: <classname>postgresql</classname>;
-Web server: <classname>apache</classname>.
+Web server: <classname>apache2</classname>.
 
 </para></note>
 <para>

commit 5b94068cefdfb0b140b7f26dbb35bab6ee000217
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 15:30:15 2008 +0200

    Resize issue in network-console is no more

diff --git a/manual/en/using-d-i/modules/network-console.xml b/manual/en/using-d-i/modules/network-console.xml
index a16b0c4..b20f2b0 100644
--- a/manual/en/using-d-i/modules/network-console.xml
+++ b/manual/en/using-d-i/modules/network-console.xml
@@ -129,12 +129,6 @@ Doing so may corrupt the database that holds the configuration of
 the new system. This in turn may result in a failed installation or
 problems with the installed system.
 
-</para><para>
-
-Also, if you are running the SSH session from an X terminal, you should
-not resize the window as that will result in the connection being
-terminated.
-
 </para></warning>
 
    </sect3>

commit ab1115b9aa7df6c2e3198726ee02ed398f9d296f
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 15:41:13 2008 +0200

    Add references to partman-{auto,manual} in howto

diff --git a/manual/en/howto/installation-howto.xml b/manual/en/howto/installation-howto.xml
index 2a8133d..8e75405 100644
--- a/manual/en/howto/installation-howto.xml
+++ b/manual/en/howto/installation-howto.xml
@@ -249,9 +249,9 @@ installer will only ask to select one if a country has multiple zones.
 
 Now it is time to partition your disks. First you will be given the
 opportunity to automatically partition either an entire drive, or available
-free space on a drive (guided partitioning).
-This is recommended for new users or anyone in a hurry. If you do not want
-to autopartition, choose <guimenuitem>Manual</guimenuitem> from the menu.
+free space on a drive (see <xref linkend="partman-auto" />).  This is
+recommended for new users or anyone in a hurry.  If you do not want to
+autopartition, choose <guimenuitem>Manual</guimenuitem> from the menu.
 
 </para><para arch="x86">
 
@@ -268,7 +268,8 @@ delete it. If you did automatic partitioning, you should just be able to choose
 <guimenuitem>Finish partitioning and write changes to disk</guimenuitem>
 from the menu to use what it set up. Remember to assign at least one partition
 for swap space and to mount a partition on <filename>/</filename>.
-<xref linkend="partitioning" /> has more information about partitioning.
+<xref linkend="partitioning" /> has more information about partitioning and
+<xref linkend="partman-manual" /> more details on how to use the partitioner.
 
 </para><para>
 

commit 3bd5991e3ea21e828a29d6ed03209d644847154b
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 15:44:00 2008 +0200

    user-setup runs after base-installer not partman

diff --git a/manual/en/howto/installation-howto.xml b/manual/en/howto/installation-howto.xml
index 8e75405..832f3a6 100644
--- a/manual/en/howto/installation-howto.xml
+++ b/manual/en/howto/installation-howto.xml
@@ -290,9 +290,10 @@ See <xref linkend="pkgsel"/> for additional information about this step.
 
 </para><para>
 
-Partitioning is followed by setting up user accounts. By default you will
-need to provide a password for the <quote>root</quote> (administrator)
-account and information necessary to create one regular user account.
+Installation of the base system is followed by setting up user accounts. By
+default you will need to provide a password for the <quote>root</quote>
+(administrator) account and information necessary to create one regular user
+account.
 
 </para><para>
 

commit da1e24e161ddf09e96da007e959f4bd0876b17d7
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 15:55:30 2008 +0200

    XT is dead

diff --git a/manual/en/partitioning/device-names.xml b/manual/en/partitioning/device-names.xml
index 5f3b3c1..7034eb6 100644
--- a/manual/en/partitioning/device-names.xml
+++ b/manual/en/partitioning/device-names.xml
@@ -67,16 +67,6 @@ up as <filename>/dev/hda</filename> in Debian).
 
 </para></listitem>
 
-<listitem arch="x86"><para>
-
-The first XT disk is named <filename>/dev/xda</filename>.
-
-</para></listitem>
-<listitem arch="x86"><para>
-
-The second XT disk is named <filename>/dev/xdb</filename>.
-
-</para></listitem>
 <listitem arch="m68k"><para>
 
 The first ACSI device is named <filename>/dev/ada</filename>, the

commit 0e87fac59712edce1738341b22eb419ae01ce7f4
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 15:59:00 2008 +0200

    Partitioning screens are now aligned in g-i

diff --git a/manual/en/appendix/graphical.xml b/manual/en/appendix/graphical.xml
index 9ea7527..4f95f69 100644
--- a/manual/en/appendix/graphical.xml
+++ b/manual/en/appendix/graphical.xml
@@ -128,7 +128,7 @@ that there are some known issues. We continue to work on resolving these.
 <listitem><para>
 
 Information on some screens is not yet nicely formatted into columns as it
-should be. This is most visible during partitioning.
+should be.
 
 </para></listitem>
 <listitem><para>

commit 5772b3a60bcb145f333900ab2b97f3ba4e741d21
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 15:59:33 2008 +0200

    Deadkeys issues have been fixed in g-i

diff --git a/manual/en/appendix/graphical.xml b/manual/en/appendix/graphical.xml
index 4f95f69..08cef30 100644
--- a/manual/en/appendix/graphical.xml
+++ b/manual/en/appendix/graphical.xml
@@ -133,13 +133,6 @@ should be.
 </para></listitem>
 <listitem><para>
 
-Typing some characters may not work and in some cases the wrong character
-may be printed. For example, "composing" a character by typing an accent and
-then the letter over/under which the accent should appear does not work.
-
-</para></listitem>
-<listitem><para>
-
 Support for touchpads is not yet optimal.
 
 </para></listitem>

commit 86356469f40a5c78e903cc5b0357756dd553e75d
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 16:00:16 2008 +0200

    Support for shells have been added in g-i

diff --git a/manual/en/appendix/graphical.xml b/manual/en/appendix/graphical.xml
index 08cef30..9bb933f 100644
--- a/manual/en/appendix/graphical.xml
+++ b/manual/en/appendix/graphical.xml
@@ -136,27 +136,6 @@ should be.
 Support for touchpads is not yet optimal.
 
 </para></listitem>
-<listitem><para>
-
-Starting a shell from the graphical frontend is currently not supported.
-This means that relevant options to do that (which are available when you
-use the textual frontend), will not be shown in the main menu of the
-installation system and in the menu for the rescue mode. You will instead
-have to switch (as described above) to the shells that are available on
-virtual consoles VT2 and VT3.
-
-</para><para>
-
-After booting the installer in rescue mode, it may be useful to start a shell
-in the root partition of an already installed system. This is possible (after
-you have selected the partition to be mounted as the root partition) by
-switching to VT2 or VT3 and entering the following command:
-
-<informalexample><screen>
-# chroot /target
-</screen></informalexample>
-
-</para></listitem>
 </itemizedlist>
 
   </sect2>

Attachment: signature.asc
Description: Digital signature


Reply to: