More update work on readme and settings.

config/settings/settings.conf

@@ -3,14 +3,13 @@
 enabled=True
 
 # Select the driver used to play sounds, choices are genericDriver and gstreamerDriver.
+# Generic driver uses fewer dependencies but spawns a process for each sound played including progress bar beeps
 # Gstreamer is the default.
 driver=gstreamerDriver
 #driver=genericDriver
 
 # Sound themes. These are the pack of sounds used for sound alerts.
 # Sound packs may be located at /usr/share/sounds
-# For system wide availability, or ~/.local/share/fenrirscreenreader/sounds
-# For the current user.
 theme=default
 
 # Sound volume controls how loud the sounds for your selected soundpack are.
@@ -110,8 +109,10 @@ driver=evdevDriver
 device=ALL
 # gives Fenrir exclusive access to the keyboard and lets it control keystrokes.
 grab_devices=True
-ignore_shortcuts=False
+# Ignore shortcut bindings and pass all keys through without processing Fenrir commands.
+# When True, Fenrir will only monitor screen content without intercepting keyboard input.
 # the current shortcut layout located in /etc/fenrirscreenreader/keyboard
+ignore_shortcuts=False
 keyboard_layout=desktop
 # echo chars while typing.
 # 0 = None
@@ -138,6 +139,8 @@ debug_level=2
 # debugMode=Print just prints on the screen
 debug_mode=File
 debug_file=
+# Punctuation settings control how punctuation is spoken during text review.
+# Profile selects a punctuation definition file from config/punctuation/ (e.g., default.conf)
 punctuation_profile=default
 punctuation_level=some
 respect_punctuation_pause=True
@@ -247,6 +250,11 @@ enabled=True
 inactive_timeout_sec=120
 # Comma-separated list of text patterns to promote when detected
 # Leave empty to disable pattern-based promotion
+# Examples:
+#   error,warning,failed    - Announce build/command errors
+#   complete,finished,done  - Announce task completions
+#   new message,@username   - Announce chat notifications
+#   download complete       - Announce download completions
 list=
 
 [menu]