From 0c7a103eaba5983e8b8947815366bb1b264a5a9e Mon Sep 17 00:00:00 2001
From: chrys <chrys87@web.de>
Date: Mon, 22 Aug 2016 00:41:25 +0200
Subject: [PATCH] update config

---
 config/settings/settings.conf | 58 ++++++++++++++++++++++++++++++-----
 1 file changed, 50 insertions(+), 8 deletions(-)

diff --git a/config/settings/settings.conf b/config/settings/settings.conf
index 500086fa..91f8a567 100644
--- a/config/settings/settings.conf
+++ b/config/settings/settings.conf
@@ -1,21 +1,54 @@
 [sound]
+# Turn sound on or off:
 enabled=True
+
+# Select the driver used to play sounds, choices are sox and gstreamer.
+# Sox is the default.
 driver=sox
+
+# Sound themes. This is the pack of sounds used for sound alerts.
+# Sound packs may be located at /usr/share/sounds
+# For system wide availability, or ~/.local/share/fenrir/sounds
+# For the current user.
 theme=default
+
+# Sound volume controls how loud the sounds for your chosen soundpack are.
+# 0 is quietest, 1.0 is loudest.
 volume=1.0
 
 [speech]
+# Turn speech on or off:
 enabled=True
-driver=espeak
-rate=0.75
+
+# Select speech driver, options are speechd (default) or espeak:
+driver=speechd
+
+# The rate selects how fast fenrir will speak. Options range from 0, slowest, to 1.0, fastest.
+rate=0.45
+
+# Pitch controls the pitch of the voice, select from 0, lowest, to 1.0, highest.
 pitch=0.5
-module=espeak
-voice=en-us
-language=en-us
+
+# Volume controls the loudness of the voice, select from 0, quietest, to 1.0, loudest.
 volume=1.0
+
+# Module is used for speech-dispatcher, to select the speech module you want to use.
+# Consult speech-dispatcher's configuration and help ti find out which modules are available.
+# The default is espeak.
+module=espeak
+
+# Voice selects the varient you want to use, for example, f5 will use the female voice #5 in espeak,
+# or if using the espeak module in speech-dispatcher. To find out which voices are available, consult the documentation provided with your chosen synthesizer.
+voice=
+
+# Select the language you want fenrir to use.
+language=english-us
+
+# Read new text as it happens?
 autoReadIncomming=True
 
 [braille]
+#braille is not implemented yet
 enabled=False
 layout=en
 
@@ -25,20 +58,29 @@ screenUpdateDelay=0.4
 
 [keyboard]
 device=all
-grabDevices=False
+# gives fenrir exclusive access to the keyboard and let consume keystrokes. just disable on problems.
+grabDevices=True
 ignoreShortcuts=False
-keyboardLayout=test
+# the current shortcut layout located in /etc/fenrir/keyboard
+keyboardLayout=desktop
+# echo chars while typing.
 charEcho=False
+# echo deleted chars
 charDeleteEcho=True
+# echo word after pressing space
 wordEcho=True
+# interrupt speech on any keypress
 interruptOnKeyPress=False
 
 [general]
 debugLevel=0
 punctuationLevel=1
+# define the current fenrir key
 fenrirKeys=KEY_KP0
 
 [promote]
 enabled=True
-inactiveTimeoutSec=5
+inactiveTimeoutSec=120
 list=
+
+