From f06854bfdb15d536c8f5b184979d437d07a6fcc6 Mon Sep 17 00:00:00 2001
From: Frans Pop <elendil@planet.nl>
Date: Sat, 19 Apr 2008 12:56:39 +0000
Subject: Document new boot parameters to define mouse protocol and device
 (port) for the graphical installer.

---
 debian/changelog                 |  4 +++-
 en/appendix/graphical.xml        | 18 +++++++++++++-----
 en/boot-installer/parameters.xml | 35 +++++++++++++++++++++++++++++++++++
 3 files changed, 51 insertions(+), 6 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index 81b3594a3..d63288b17 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -20,11 +20,13 @@ installation-guide (2008xxxx) UNRELEASED; urgency=low
   * Warn about boot issues when using RAID on the root file system.
   * Update task selection section for changes in desktop task preseeding.
   * Fix double / in links, spotted by Stanislav Gromov. Closes: #472813.
+  * Document new boot parameters to define mouse protocol and device (port)
+    for the graphical installer.
 
   [ Joey Hess ]
   * Remove autopartkit from the module list.
 
- -- Frans Pop <fjp@debian.org>  Thu, 27 Mar 2008 00:44:19 +0100
+ -- Frans Pop <fjp@debian.org>  Sat, 19 Apr 2008 14:53:10 +0200
 
 installation-guide (20080211) unstable; urgency=low
 
diff --git a/en/appendix/graphical.xml b/en/appendix/graphical.xml
index 7ccb34fb0..82738f6cc 100644
--- a/en/appendix/graphical.xml
+++ b/en/appendix/graphical.xml
@@ -61,6 +61,14 @@ an ATI graphical card, but is unlikely to work on other systems.
 
 </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>
+<note><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
@@ -68,12 +76,12 @@ available, it will automatically fall back to the regular
 
 </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.
+If the amount of memory in your system is close to &minimum-memory;,
+the graphical installer may fail to boot at all while booting the
+regular installer would still work. Using the regular installer is
+recommended for systems with low memory.
 
-</para>
+</para></note>
 
   <sect2 id="gtk-using">
   <title>Using the graphical installer</title>
diff --git a/en/boot-installer/parameters.xml b/en/boot-installer/parameters.xml
index d9928a639..9dedaccca 100644
--- a/en/boot-installer/parameters.xml
+++ b/en/boot-installer/parameters.xml
@@ -398,6 +398,41 @@ could not be loaded completely. The value is in kB.
 </para></listitem>
 </varlistentry>
 
+<varlistentry condition="gtk">
+<term>mouse/protocol</term>
+<listitem><para>
+
+For the gtk frontend (graphical installer), users can set the mouse
+protocol to be used by setting this parameter.
+Supported values are<footnote>
+
+<para>
+See the man page for
+<citerefentry><refentrytitle>directfbrc</refentrytitle>
+<manvolnum>5</manvolnum></citerefentry> for additional information.
+</para>
+
+</footnote>:
+<userinput>PS/2</userinput>, <userinput>IMPS/2</userinput>,
+<userinput>MS</userinput>, <userinput>MS3</userinput>,
+<userinput>MouseMan</userinput> and <userinput>MouseSystems</userinput>.
+In most cases the default protocol should work correctly.
+
+</para></listitem>
+</varlistentry>
+
+<varlistentry condition="gtk">
+<term>mouse/device</term>
+<listitem><para>
+
+For the gtk frontend (graphical installer), users can specify the mouse
+device to be used by setting this parameter. This is mostly useful if the
+mouse is connected to a serial port (serial mouse). Example:
+<userinput>mouse/device=<replaceable>/dev/ttyS1</replaceable></userinput>.
+
+</para></listitem>
+</varlistentry>
+
 <varlistentry condition="gtk">
 <term>mouse/left</term>
 <listitem><para>
-- 
cgit v1.2.3