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 -— often called MFM, RLL, IDE, or ATA — are supported. Very old -8–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 +— often called MFM, RLL, IDE, or ATA — 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 -— often called MFM, RLL, IDE, or ATA — are supported. SCSI disk -controllers from many different manufacturers are supported. See the +— often called MFM, RLL, IDE, or ATA — 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