summaryrefslogtreecommitdiff
path: root/en
diff options
context:
space:
mode:
authorFrans Pop <elendil@planet.nl>2007-01-03 07:29:48 +0000
committerFrans Pop <elendil@planet.nl>2007-01-03 07:29:48 +0000
commitbb2ad3a8b8e4a3104879d0010c6375cd32058218 (patch)
tree14e854bfec38871a3264b2b03f300580c46ebc3e /en
parent220932df3113c63fbcfa1aff2d62a9a4b135ab30 (diff)
downloadinstallation-guide-bb2ad3a8b8e4a3104879d0010c6375cd32058218.zip
Document the graphical installer, including the main known issues
Diffstat (limited to 'en')
-rw-r--r--en/appendix/graphical.xml154
-rw-r--r--en/appendix/random-bits.xml1
-rw-r--r--en/boot-installer/boot-installer.xml7
-rw-r--r--en/preparing/install-overview.xml10
4 files changed, 171 insertions, 1 deletions
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