[plasma-desktop] doc/kcontrol/kcmaccess: Add section about screen reader to kcmaccess kcm docbook

[Burkhard Lück]

Git commit 577a208b03e884fdec348d0fcf284a8e22c06302 by Burkhard Lück.
Committed on 26/07/2017 at 16:27.
Pushed by lueck into branch 'master'.

Add section about screen reader to kcmaccess kcm docbook

add info from http://blogs.fsfe.org/gladhorn/2015/08/09/testing-plasma-next-with-orca-screen-reader/
BUG:382207

Differential Revision: https://phabricator.kde.org/D6886

M  +29   -2    doc/kcontrol/kcmaccess/index.docbook

https://commits.kde.org/plasma-desktop/577a208b03e884fdec348d0fcf284a8e22c06302

diff --git a/doc/kcontrol/kcmaccess/index.docbook b/doc/kcontrol/kcmaccess/index.docbook
index 86971cf3..54c6ec7a 100644
--- a/doc/kcontrol/kcmaccess/index.docbook
+++ b/doc/kcontrol/kcmaccess/index.docbook
@@ -13,8 +13,8 @@
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
-<date>2015-04-09</date>
-<releaseinfo>Plasma 5.3</releaseinfo>
+<date>2017-07-24</date>
+<releaseinfo>Plasma 5.10</releaseinfo>
 
 <keywordset>
 <keyword>KDE</keyword>
@@ -258,6 +258,33 @@ feature is turned on or off</guilabel></member>
 which allows you to edit the notifications for status changes of all keys.</para>
 
 </sect3>
+
+<sect3 id="access-screenreader">
+<title><guilabel>Screen Reader</guilabel></title>
+
+<para>Install a screen reader application like
+<ulink url="https://en.wikipedia.org/wiki/Orca_(assistive_technology)">Orca.</ulink>
+together with <application>speech-dispatcher</application>.
+</para>
+
+<para>Test that sound from speech dispatcher works using the command
+<command>spd-say hello</command> in a terminal.
+</para>
+
+<para>In addition you need a text to speech synthesizer like ⪚ <application>espeak</application>.
+</para>
+
+<para>Enable the screen reader in the checkbox, logout and restart your desktop session.
+</para>
+
+<para>For &plasma; itself, make sure to use the traditional <guilabel>Application Menu</guilabel>,
+and check that this menu has a keyboard shortcut associated
+(<keycombo action="simul">&Alt;<keycap>F1</keycap></keycombo>).
+When pressing this shortcut, the menu should open and be read when navigating
+the menu with the arrow keys.
+</para>
+</sect3>
+
 </sect2>
 
 </sect1>