8 files changed, 154 insertions, 1 deletions
diff --git a/build/entities/common.ent b/build/entities/common.ent
index 9ee3f15ed..a62082676 100644
--- a/build/entities/common.ent
+++ b/build/entities/common.ent
@@ -147,6 +147,12 @@ to first switch tasksel to that DE using the following command, e.g:
 <!-- version of X11 shipping with the current release -->
 <!ENTITY x11ver "7.3">
 
+<!-- version of BRLTTY shipping with the current release -->
+<!ENTITY brlttyver "3.10">
+
+<!-- version of Speakup shipping with the current release -->
+<!ENTITY speakupver "3.0.3">
+
 <!-- an example of adding another image to lilo.conf, cf
      en/post-install.sgml etc. -->
 <!ENTITY additional-lilo-image
diff --git a/build/entities/urls.ent b/build/entities/urls.ent
index 3923d1f55..71bd85a3f 100644
--- a/build/entities/urls.ent
+++ b/build/entities/urls.ent
@@ -202,6 +202,13 @@
 
 <!ENTITY url-simtel "ftp://ftp.simtel.net/pub/simtelnet/msdos/">
 
+<!ENTITY url-brltty "http://www.mielke.cc/brltty/">
+<!ENTITY url-brltty-driver-codes "http://www.mielke.cc/brltty/doc/Manual-BRLTTY/English/BRLTTY-11.html">
+<!ENTITY url-brltty-table-codes "http://www.mielke.cc/brltty/doc/Manual-BRLTTY/English/BRLTTY-6.html">
+
+<!ENTITY url-speakup "http://www.linux-speakup.org/">
+<!ENTITY url-speakup-driver-codes "http://www.linux-speakup.org/spkguide.txt">
+
 
 <!-- ****************************************** m68k links -->
 <!--
diff --git a/build/templates/docstruct.ent b/build/templates/docstruct.ent
index 87fe7f481..24cad5e2c 100644
--- a/build/templates/docstruct.ent
+++ b/build/templates/docstruct.ent
@@ -29,6 +29,7 @@
    <!ENTITY supported-sparc.xml         SYSTEM "##SRCPATH##/hardware/supported/sparc.xml">
   <!ENTITY network-cards.xml            SYSTEM "##SRCPATH##/hardware/network-cards.xml">
   <!ENTITY supported-peripherals.xml    SYSTEM "##SRCPATH##/hardware/supported-peripherals.xml">
+  <!ENTITY accessibility-hardware.xml   SYSTEM "##SRCPATH##/hardware/accessibility.xml">
   <!ENTITY buying-hardware.xml          SYSTEM "##SRCPATH##/hardware/buying-hardware.xml">
   <!ENTITY installation-media.xml       SYSTEM "##SRCPATH##/hardware/installation-media.xml">
   <!ENTITY memory-disk-requirements.xml SYSTEM "##SRCPATH##/hardware/memory-disk-requirements.xml">
@@ -94,6 +95,7 @@
   <!ENTITY boot-installer-s390.xml         SYSTEM "##SRCPATH##/boot-installer/s390.xml">
   <!ENTITY boot-installer-sparc.xml        SYSTEM "##SRCPATH##/boot-installer/sparc.xml">
   <!ENTITY boot-installer-parameters.xml   SYSTEM "##SRCPATH##/boot-installer/parameters.xml">
+  <!ENTITY boot-installer-accessibility.xml   SYSTEM "##SRCPATH##/boot-installer/accessibility.xml">
   <!ENTITY boot-installer-trouble.xml      SYSTEM "##SRCPATH##/boot-installer/trouble.xml">
 
  <!ENTITY using-d-i.xml                  SYSTEM "##SRCPATH##/using-d-i/using-d-i.xml">
diff --git a/debian/changelog b/debian/changelog
index e627f2b65..47d786cc2 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -30,7 +30,10 @@ installation-guide (2008xxxx) UNRELEASED; urgency=low
   * Fix example how to generate md5-encoded password. Closes: #518018.
   * Fix missing tags in Japanese translation. Closes: #509372.
 
- -- Frans Pop <fjp@debian.org>  Mon, 06 Apr 2009 01:27:07 +0200
+  [ Samuel Thibault ]
+  * Document accessibility support. Closes: #509371.
+
+ -- Frans Pop <fjp@debian.org>  Tue, 07 Apr 2009 10:36:26 +0200
 
 installation-guide (20081208) unstable; urgency=low
 
diff --git a/en/boot-installer/accessibility.xml b/en/boot-installer/accessibility.xml
new file mode 100644
index 000000000..411b7ee1e
--- /dev/null
+++ b/en/boot-installer/accessibility.xml
@@ -0,0 +1,99 @@
+<!-- retain these comments for translator revision tracking -->
+<!-- $Id: boot-installer-accessibility.xml $ -->
+
+ <sect1 id="boot-installer-accessibility" arch="not-s390">
+ <title>Accessibility</title>
+<para>
+
+Some users may need specific support because of e.g. some visual
+impairment.
+<phrase arch="alpha;ia64;powerpc;x86">USB braille displays are detected
+automatically, but most other</phrase>
+<phrase arch="arm;hppa;mips;mipsel;m68k;sparc">Most</phrase>
+accessibility features have to be enabled manually.
+<phrase arch="x86">On machines that support it, the boot menu emits a beep
+when it is ready to receive keystrokes.</phrase>
+Some boot parameters can <phrase arch="x86">then</phrase> be appended to
+enable accessibility features. Note that on most architectures the boot
+loader interprets your keyboard as a QWERTY keyboard.
+
+</para>
+
+  <sect2 arch="alpha;ia64;powerpc;x86">
+  <title>USB Braille Displays</title>
+<para>
+
+USB braille displays should be automatically detected. A textual version
+of the installer will then be automatically selected, and support for the
+braille display will be automatically installed on the target system.
+You can thus just press &enterkey; at the boot menu.
+Once <classname>brltty</classname> is started, you can choose a braille
+table by entering the preference menu.
+
+</para>
+  </sect2>
+
+  <sect2 arch="alpha;ia64;powerpc;x86">
+  <title>Serial Braille Displays</title>
+<para>
+
+Serial braille displays cannot safely be automatically detected
+(since that may damage some of them). You thus need to append the
+<userinput>brltty=<replaceable>driver</replaceable>,<replaceable>port</replaceable>,<replaceable>table</replaceable></userinput>
+boot parameter to tell <classname>brltty</classname> which driver it
+should use. <replaceable>driver</replaceable> should be replaced by the
+two-letter driver code for your terminal (see the
+<ulink url="&url-brltty-driver-codes;">driver code list</ulink>).
+<replaceable>device</replaceable> should be replaced by the name of the
+serial port the display is connected to, <userinput>ttyS0</userinput> is
+the default. <replaceable>table</replaceable> is the name of the braille
+table to be used (see the <ulink url="&url-brltty-table-codes;">table code
+list</ulink>); the English table is the default. Note that the table can
+be changed later by entering the preference menu.
+
+</para>
+  </sect2>
+
+  <sect2 arch="x86">
+  <title>Hardware Speech Synthesis</title>
+<para>
+
+Support for hardware speech synthesis devices is available only alongside
+support for graphical installer. You thus need to select the
+<quote>Graphical install</quote> entry in the boot menu.
+
+Hardware speech synthesis devices cannot be automatically detected. You
+thus need to append the
+<userinput>speakup.synth=<replaceable>driver</replaceable></userinput>
+boot parameter to tell <classname>speakup</classname> which driver it should
+use. <replaceable>driver</replaceable> should be replaced by the driver code
+for your device (see <ulink url="&url-speakup-driver-codes;">driver code
+list</ulink>). The textual version of the installer will then be
+automatically selected, and support for the speech synthesis device will be
+automatically installed on the target system.
+
+</para>
+  </sect2>
+
+  <sect2><title>Board Devices</title>
+<para>
+
+Some accessibility devices are actual boards that are plugged inside the
+machine and that read text directly from the video memory. To get them
+to work framebuffer support must be disabled by using the
+<userinput>fb=false</userinput> boot parameter. This will however reduce
+the number of available languages.
+
+</para>
+  </sect2>
+
+  <sect2><title>High-Contrast Theme</title>
+<para>
+
+For users with low vision, the installer can use a high-contrast
+theme that makes it more readable. To enable it, append the
+<userinput>theme=dark</userinput> boot parameter.
+
+</para>
+  </sect2>
+ </sect1>
diff --git a/en/boot-installer/boot-installer.xml b/en/boot-installer/boot-installer.xml
index aca014f48..8dc497914 100644
--- a/en/boot-installer/boot-installer.xml
+++ b/en/boot-installer/boot-installer.xml
@@ -44,6 +44,7 @@ For information on how to boot the graphical installer, see
 
  </sect1>
 
+&boot-installer-accessibility.xml;
 &boot-installer-parameters.xml;
 &boot-installer-trouble.xml;
 
diff --git a/en/hardware/accessibility.xml b/en/hardware/accessibility.xml
new file mode 100644
index 000000000..aa1b189ec
--- /dev/null
+++ b/en/hardware/accessibility.xml
@@ -0,0 +1,34 @@
+<!-- retain these comments for translator revision tracking -->
+<!-- $Id: accessibility-hardware.xml $ -->
+
+  <sect2 id="braille-displays" arch="alpha;ia64;powerpc;x86">
+  <title>Braille Displays</title>
+<para>
+
+Support for braille displays is determined by the underlying support
+found in <classname>brltty</classname>. Most displays work under
+<classname>brltty</classname>, connected via either a serial port, USB
+or bluetooth. Details on supported braille devices can be found on the
+<ulink url="&url-brltty;"><classname>brltty</classname> website</ulink>.
+&debian; &release; ships with <classname>brltty</classname> version
+&brlttyver;.
+
+</para>
+  </sect2>
+
+  <sect2 id="hardware-speech-synthesis" arch="x86">
+  <title>Hardware Speech Synthesis</title>
+<para>
+
+Support for hardware speech synthesis devices is determined by the
+underlying support found in <classname>speakup</classname>.
+<classname>speakup</classname> only supports integrated boards and
+external devices connected to a serial port (no USB or serial-to-USB
+adapters are supported). Details on supported hardware speech synthesis
+devices can be found on the
+<ulink url="&url-speakup;"><classname>speakup</classname> website</ulink>.
+&debian; &release; ships with <classname>speakup</classname> version
+&speakupver;.
+
+</para>
+  </sect2>
diff --git a/en/hardware/hardware-supported.xml b/en/hardware/hardware-supported.xml
index 8b8c78a91..dce0da865 100644
--- a/en/hardware/hardware-supported.xml
+++ b/en/hardware/hardware-supported.xml
@@ -399,6 +399,7 @@ system.
   </sect2>
 
 &network-cards.xml;
+&accessibility-hardware.xml;
 &supported-peripherals.xml;
 
  </sect1>