diff options
| -rw-r--r-- | build/arch-options/amd64 | 1 | ||||
| -rw-r--r-- | build/arch-options/i386 | 1 | ||||
| -rw-r--r-- | build/arch-options/powerpc | 1 | ||||
| -rwxr-xr-x | build/buildone.sh | 1 | ||||
| -rw-r--r-- | build/templates/docstruct.ent | 1 | ||||
| -rw-r--r-- | debian/changelog | 3 | ||||
| -rw-r--r-- | en/appendix/graphical.xml | 154 | ||||
| -rw-r--r-- | en/appendix/random-bits.xml | 1 | ||||
| -rw-r--r-- | en/boot-installer/boot-installer.xml | 7 | ||||
| -rw-r--r-- | en/preparing/install-overview.xml | 10 |
10 files changed, 178 insertions, 2 deletions
diff --git a/build/arch-options/amd64 b/build/arch-options/amd64 index 14722a043..ccb4f0803 100644 --- a/build/arch-options/amd64 +++ b/build/arch-options/amd64 @@ -6,6 +6,7 @@ archspec="amd64;x86;not-s390;not-m68k;not-powerpc;not-alpha" kernelversion="2.6.18" arch_listname="amd64" minimum_memory=48 +minimum_memory_gtk=96 # These two options should be set if condition 'smp' is set below smp_config_section="Processor type and features" smp_config_option="Symmetric multi-processing support" diff --git a/build/arch-options/i386 b/build/arch-options/i386 index 97b3d79e4..353b9e1fc 100644 --- a/build/arch-options/i386 +++ b/build/arch-options/i386 @@ -6,6 +6,7 @@ archspec="i386;x86;not-s390;not-m68k;not-powerpc;not-alpha" kernelversion="2.6.18" arch_listname="boot" minimum_memory=48 +minimum_memory_gtk=96 # These two options should be set if condition 'smp' is set below smp_config_section="Processor type and features" smp_config_option="Symmetric multi-processing support" diff --git a/build/arch-options/powerpc b/build/arch-options/powerpc index 69ad17303..392647d04 100644 --- a/build/arch-options/powerpc +++ b/build/arch-options/powerpc @@ -6,6 +6,7 @@ archspec="powerpc;not-s390;not-m68k;not-x86;not-alpha" kernelversion="2.6.18" arch_listname="powerpc" minimum_memory=32 +minimum_memory_gtk=128 # These two options should be set if condition 'smp' is set below smp_config_section="Platform support" smp_config_option="Symmetric multi-processing support" diff --git a/build/buildone.sh b/build/buildone.sh index 37a6d8278..775139863 100755 --- a/build/buildone.sh +++ b/build/buildone.sh @@ -90,6 +90,7 @@ create_profiled () { echo "<!ENTITY smp-config-section \"${smp_config_section}\">" >> $dynamic echo "<!ENTITY smp-config-option \"${smp_config_option}\">" >> $dynamic echo "<!ENTITY minimum-memory \"${minimum_memory}¬ation-megabytes;\">" >> $dynamic + echo "<!ENTITY minimum-memory-gtk \"${minimum_memory_gtk}¬ation-megabytes;\">" >> $dynamic sed "s:##SRCPATH##:$source_path:" templates/docstruct.ent >> $dynamic diff --git a/build/templates/docstruct.ent b/build/templates/docstruct.ent index 076c767ba..010464bb8 100644 --- a/build/templates/docstruct.ent +++ b/build/templates/docstruct.ent @@ -188,5 +188,6 @@ <!ENTITY files.xml SYSTEM "##SRCPATH##/appendix/files.xml"> <!ENTITY chroot-install.xml SYSTEM "##SRCPATH##/appendix/chroot-install.xml"> <!ENTITY plip.xml SYSTEM "##SRCPATH##/appendix/plip.xml"> + <!ENTITY graphical.xml SYSTEM "##SRCPATH##/appendix/graphical.xml"> <!ENTITY administrivia.xml SYSTEM "##SRCPATH##/administrivia/administrivia.xml"> <!ENTITY gpl.xml SYSTEM "##SRCPATH##/appendix/gpl.xml"> diff --git a/debian/changelog b/debian/changelog index 3cfaa6aa5..b41b0361b 100644 --- a/debian/changelog +++ b/debian/changelog @@ -106,6 +106,7 @@ installation-guide (2006xxxx) UNRELEASED; urgency=low * Update number of developers, packages and mailing lists. * General revision of minimum hardware requirements throughout the manual. * Update of installed/download size of tasks. + * Document the graphical installer, including the main known issues. * bookinfo: - Add note for m68k that it is not a release architecture for Etch. * hardware: @@ -154,7 +155,7 @@ installation-guide (2006xxxx) UNRELEASED; urgency=low * appendix/chroot-install: - Changes suggested in review by Wiktor Wandachowicz. Closes: #394929. - -- Frans Pop <fjp@debian.org> Mon, 1 Jan 2007 11:49:34 +0100 + -- Frans Pop <fjp@debian.org> Wed, 3 Jan 2007 08:28:18 +0100 installation-guide (20060726) unstable; urgency=low diff --git a/en/appendix/graphical.xml b/en/appendix/graphical.xml new file mode 100644 index 000000000..6cb605c8f --- /dev/null +++ b/en/appendix/graphical.xml @@ -0,0 +1,154 @@ +<!-- retain these comments for translator revision tracking --> +<!-- $Id$ --> + + <sect1 condition="gtk" id="graphical"> + <title>Using the Graphical Installer</title> +<para> + +The graphical version of the installer is only available for a limited +number of architectures, including &arch-title;. The functionality of +the graphical installer is essentially the same as that of the regular +installer as it basically uses the same programs, but with a different +frontend. + +</para><para> + +Although the functionality is identical, the graphical installer still has +a few significant advantages. The main advantage is that it supports more +languages, namely those that use a character set that cannot be displayed +with the regular <quote>newt</quote> frontend. It also has a few usability +advantages such as the option to use a mouse, and in some cases several +questions can be displayed on a single screen. + +</para><para arch="x86"> + +The graphical installer is available with all CD images and with the +hd-media installation method. As the graphical installer uses a separate +(much larger) initrd than the regular installer, it has to be booted using +<userinput>installgui</userinput> instead of <userinput>install</userinput>. +Analogous, the expert and rescue modes are booted using +<userinput>expertgui</userinput> and <userinput>rescuegui</userinput> +respectively. + +</para><para arch="x86"> + +It is also available as a special <quote>mini</quote> ISO +image<footnote id="gtk-miniiso"> + +<para> +The mini ISO image can be downloaded from a Debian mirror as described +in <xref linkend="downloading-files"/>. Look for <quote>gtk-miniiso</quote>. +</para> + +</footnote>, which is mainly useful for testing; in this case the image is +booted just using <userinput>install</userinput>. There is no graphical +installer image that can be netbooted. + +</para><para arch="powerpc"> + +For &arch-title;, currently only an experimental <quote>mini</quote> ISO +image is available<footnote id="gtk-miniiso"> + +<para> +The mini ISO image can be downloaded from a Debian mirror as described +in <xref linkend="downloading-files"/>. Look for <quote>gtk-miniiso</quote>. +</para> + +</footnote>. It should work on almost all PowerPC systems that have +an ATI graphical card, but is unlikely to work on other systems. + +</para><para> + +The graphical installer requires significantly more memory to run than +the regular installer: &minimum-memory-gtk;. If insufficient memory is +available, it will automatically fall back to the regular +<quote>newt</quote> frontend. + +</para><para> + +You can add boot parameters when starting the graphical installer, just as +with the regular installer. One of those parameters allows you to configure +the mouse for left-handed use. See <xref linkend="boot-parms"/> for valid +parameters. + +</para> + + <sect2> + <title>Using the graphical installer</title> +<para> + +As already mentioned, the graphical installer basically works the same as +the regular installer and thus the rest of this manual can be used to guide +you through the installation process. + +</para><para> + +If you prefer using the keyboard over the mouse, there are two things you +need to know. To expand a collapsed list (used for example for the selection +of countries within continents), you can use the <keycap>+</keycap> and +<keycap>-</keycap> keys. For questions where more than one item can be +selected (e.g. task selection), you first need to tab to the +<guibutton>Continue</guibutton> button after making your selections; hitting +enter will toggle a selection, not activate <guibutton>Continue</guibutton>. + +</para><para> + +To switch to another console, you will also need to use the +<keycap>Ctrl</keycap> key, just as with the X Window System. For example, +to switch to VT1 you would use: <keycombo> <keycap>Ctrl</keycap> +<keycap>Left Alt</keycap> <keycap>F1</keycap> </keycombo>. + +</para> + </sect2> + + <sect2 id="gtk-issues"> + <title>Known issues</title> +<para> + +Etch is the first release that includes the graphical installer and uses +some relatively new technology. There are a few known issues that you may +run into during the installation. We expect to be able to fix these issues +for the next release of &debian;. + +</para> + +<itemizedlist> +<listitem><para> + +Information on some screens is not nicely formatted into columns as it +should be. The most obvious example is the first screen where you select +your language. Another example is the main screen of partman. + +</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> +<listitem><para> + +You should not switch to a different console while the installer is busy; +this may cause the frontend to crash. The frontend will be restarted +automatically, but this may still cause problems with the installation. +Switching to another console while the installer is waiting for input +should work without causing any problems. + +</para></listitem> +<listitem><para> + +Support for creating encrypted partitions is limited as it is not possible +to generate a random encryption key. It is possible to set up an encrypted +partition using a passphrase as encryption key. + +</para></listitem> +</itemizedlist> + + </sect2> + </sect1> diff --git a/en/appendix/random-bits.xml b/en/appendix/random-bits.xml index a3e3be487..e19709b0b 100644 --- a/en/appendix/random-bits.xml +++ b/en/appendix/random-bits.xml @@ -6,5 +6,6 @@ &files.xml; &chroot-install.xml; &plip.xml; +&graphical.xml; </appendix> diff --git a/en/boot-installer/boot-installer.xml b/en/boot-installer/boot-installer.xml index cf6f83f3d..92ac79012 100644 --- a/en/boot-installer/boot-installer.xml +++ b/en/boot-installer/boot-installer.xml @@ -12,6 +12,13 @@ <!-- structure inside out for this chapter. Each arch has a document. --> <!-- Note: archs hppa and mipsel are currently missing --> +<note condition="gtk"><para> + +For information on how to boot the graphical installer, see +<xref linkend="graphical"/>. + +</para></note> + &boot-installer-alpha.xml; &boot-installer-arm.xml; <!-- &boot-installer-hppa.xml; --> diff --git a/en/preparing/install-overview.xml b/en/preparing/install-overview.xml index 4cb767edf..a616cbf08 100644 --- a/en/preparing/install-overview.xml +++ b/en/preparing/install-overview.xml @@ -124,7 +124,15 @@ Load the newly installed system for the first time. </para></listitem> </orderedlist> -<para> +<para condition="gtk"> + +For &arch-title; you have the option of using +<phrase arch="x86">a</phrase> +<phrase arch="powerpc">an experimental</phrase> +graphical version of the installation system. For more information about +this graphical installer, see <xref linkend="graphical"/>. + +</para><para> If you have problems during the installation, it helps to know which packages are involved in which steps. Introducing the leading software |