Add software speech synthesis documentation.

3 files changed, 41 insertions, 1 deletions

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
@@ -62,6 +62,18 @@ url="&url-brltty-driver-help;"><classname>brltty</classname> website</ulink>.
   </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>
+
+  <sect2 arch="x86">
   <title>Hardware Speech Synthesis</title>
 <para>
 
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
@@ -290,6 +290,33 @@ 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>
+
   <sect2 arch="x86" id="i386-boot-problems">
   <title>Common &arch-title; Installation Problems</title>
 <para>
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>