From a5d2e5f568175d6aab4b17d57d4fc930574a8aa2 Mon Sep 17 00:00:00 2001
From: Samuel Thibault <sthibault@debian.org>
Date: Sun, 19 Jun 2011 21:49:45 +0000
Subject: Add software speech synthesis documentation.

---
 en/boot-installer/accessibility.xml | 12 ++++++++++++
 en/boot-installer/trouble.xml       | 27 +++++++++++++++++++++++++++
 en/boot-installer/x86.xml           |  3 ++-
 3 files changed, 41 insertions(+), 1 deletion(-)

(limited to 'en/boot-installer')

diff --git a/en/boot-installer/accessibility.xml b/en/boot-installer/accessibility.xml
index 1b52a5d5a..15225bce3 100644
--- a/en/boot-installer/accessibility.xml
+++ b/en/boot-installer/accessibility.xml
@@ -58,6 +58,18 @@ be changed later by entering the preference menu. Documentation on key
 bindings for braille devices is available on the <ulink
 url="&url-brltty-driver-help;"><classname>brltty</classname> website</ulink>.
 
+</para>
+  </sect2>
+
+  <sect2 arch="x86">
+  <title>Software Speech Synthesis</title>
+<para>
+
+Support for software speech synthesis can be activated by selecting it in the
+boot menu by typing <userinput>s</userinput> &enterkey;. The first question
+(language) is spoken in english, and the remainder of installation is spoken in
+the selected language (if available in <classname>espeak</classname>).
+
 </para>
   </sect2>
 
diff --git a/en/boot-installer/trouble.xml b/en/boot-installer/trouble.xml
index e9335de7b..e90b4d82c 100644
--- a/en/boot-installer/trouble.xml
+++ b/en/boot-installer/trouble.xml
@@ -287,6 +287,33 @@ than 512M, and the installer hangs when booting the kernel, you may
 need to include a boot argument to limit the amount of memory the
 kernel sees, such as <userinput>mem=512m</userinput>.
 
+</para>
+  </sect2>
+
+  <sect2 arch="x86">
+  <title>Software Speech Synthesis</title>
+
+<para>
+
+If software speech synthesis does not work, there is most probably an issue
+with your sound board, usually because either the driver for it is not included
+in the installer, or because it has unusual mixer level names which are set to
+muted by default. You should thus submit a bug report which includes the output
+of the following commands, run on the same machine from a Linux system which is
+known to have sound working (e.g., a live CD).
+
+<itemizedlist>
+<listitem>
+<para><userinput>dmesg</userinput></para>
+</listitem><listitem>
+<para><userinput>lspci</userinput></para>
+</listitem><listitem>
+<para><userinput>lsmod</userinput></para>
+</listitem><listitem>
+<para><userinput>amixer</userinput></para>
+</listitem>
+</itemizedlist>
+
 </para>
   </sect2>
 
diff --git a/en/boot-installer/x86.xml b/en/boot-installer/x86.xml
index 990abde01..73e30cfd2 100644
--- a/en/boot-installer/x86.xml
+++ b/en/boot-installer/x86.xml
@@ -381,8 +381,9 @@ Installer boot menu
 
 Install
 Graphical install
-Advanced options       >
+Advanced options             >
 Help
+Install with speech synthesis
 
 Press ENTER to boot or TAB to edit a menu entry
 </screen></informalexample>
-- 
cgit v1.2.3