From: Pasi Kallinen <paxed@alt.org>
Date: Fri, 2 Sep 2016 06:24:22 +0000 (+0300)
Subject: Expand blind/accessibility section in the Guidebook
X-Git-Tag: NetHack-3.6.1_RC01~615
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=05ca204ae454ddb143c8fb36779ebbc55e072038;p=nethack

Expand blind/accessibility section in the Guidebook
---

diff --git a/doc/Guidebook.mn b/doc/Guidebook.mn
index 8c414e498..eef8ccc6a 100644
--- a/doc/Guidebook.mn
+++ b/doc/Guidebook.mn
@@ -3352,6 +3352,15 @@ gives you the row and column of your review cursor and the PC cursor.
 These co-ordinates are often useful in giving players a better sense of the
 overall location of items on the screen.
 .pg
+NetHack can also be compiled with support for sending the game messages
+to an external program, such as a text-to-speech synthesizer. If the #version
+extended command shows "external program as a message handler", your NetHack
+has been compiled with the capability. When compiling NetHack from source
+on Linux and other POSIX systems, define MSGHANDLER to enable it. To use
+the capability, set the environment variable NETHACK_MSGHANDLER to an
+executable, which will be executed with the game message as the program's
+only parameter.
+.pg
 While it is not difficult for experienced users to edit the \fBdefaults.nh\fP
 file to accomplish this, novices may find this task somewhat daunting.
 Included within the ``symbols'' file of all official distributions of NetHack
@@ -3369,10 +3378,20 @@ Load a symbol set for the rogue level that is appropriate for
 use by blind players.
 .lp menustyle:traditional
 This will assist in the interface to speech synthesizers.
+.lp nomenu_overlay
+Show menus on a cleared screen and aligned to the left edge.
 .lp number_pad
 A lot of speech access programs use the number-pad to review the screen.
 If this is the case, disable the number_pad option and use the traditional
 Rogue-like commands.
+.lp autodescribe
+Automatically describe the terrain under the cursor when targeting.
+.lp mention_walls
+Give feedback messages when walking towards a wall or when travel command
+was interrupted.
+.lp whatis_coord:compass
+When targeting with cursor, describe the cursor position with coordinates
+relative to your character.
 .hn 2
 Global Configuration for System Administrators
 .pg
diff --git a/doc/Guidebook.tex b/doc/Guidebook.tex
index bb0e4a021..98218165e 100644
--- a/doc/Guidebook.tex
+++ b/doc/Guidebook.tex
@@ -3995,6 +3995,15 @@ gives you the row and column of your review cursor and the PC cursor.
 These co-ordinates are often useful in giving players a better sense of the
 overall location of items on the screen.
 %.pg
+NetHack can also be compiled with support for sending the game messages
+to an external program, such as a text-to-speech synthesizer. If the #version
+extended command shows "external program as a message handler", your NetHack
+has been compiled with the capability. When compiling NetHack from source
+on Linux and other POSIX systems, define {\it MSGHANDLER\/} to enable it. To use
+the capability, set the environment variable {\it NETHACK\_MSGHANDLER\/} to an
+executable, which will be executed with the game message as the program's
+only parameter.
+%.pg
 While it is not difficult for experienced users to edit the {\it defaults.nh\/}
 file to accomplish this, novices may find this task somewhat daunting.
 Included within the symbol file of all official distributions of NetHack 
@@ -4017,10 +4026,24 @@ use by blind players.
 \item[\ib{menustyle:traditional}]
 This will assist in the interface to speech synthesizers.
 %.lp
+\item[\ib{nomenu\verb+_+overlay}]
+Show menus on a cleared screen and aligned to the left edge.
+%.lp
 \item[\ib{number\verb+_+pad}]
 A lot of speech access programs use the number-pad to review the screen.
 If this is the case, disable the number\verb+_+pad option and use the traditional
 Rogue-like commands.
+%.lp
+\item[\ib{autodescribe}]
+Automatically describe the terrain under the cursor when targeting.
+%.lp
+\item[\ib{mention\verb+_+walls}]
+Give feedback messages when walking towards a wall or when travel command
+was interrupted.
+%.lp
+\item[\ib{whatis\verb+_+coord:compass}]
+When targeting with cursor, describe the cursor position with coordinates
+relative to your character.
 \elist
 
 %.hn2