Notification sound added. Docs updated.

docs/user.txt

@@ -47,14 +47,19 @@ terminals and on text consoles selected in screen.ignored_vts.
 
 Keyboard layouts and help
 
-The Fenrir key is Insert, Super/Windows, or keypad 0 with NumLock off.
-Hold it while pressing the other keys in a shortcut. Bare keypad review
-keys also require NumLock off.
+The Fenrir key is Insert, Super/Windows, or keypad 0 with NumLock off in
+the desktop layout. The laptop layout uses Caps Lock instead of
+Super/Windows; Insert and NumLock-off keypad 0 also work. Press
+Shift+Caps Lock on its own to toggle capitalization in the laptop
+layout. Shifted Fenrir shortcuts do not toggle capitalization. Hold it
+while pressing the other keys in a shortcut. Bare keypad review keys
+also require NumLock off.
 
 The desktop layout uses the numeric keypad. The laptop layout uses
 Fenrir chords on the main keyboard. Select a layout with
---keyboard-layout desktop or --keyboard-layout laptop, or set
-keyboard.layout in the settings file.
+--keyboard-layout desktop or --keyboard-layout laptop, choose Desktop or
+Laptop in the Keyboard tab of the Fenrir Menu, or set keyboard.layout in
+the settings file. Menu layout changes take effect on the next launch.
 
 Press Fenrir+H or Fenrir+F1 to enter the tutorial. Command shortcuts are
 announced and described instead of executed. Up and Down browse
@@ -162,12 +167,19 @@ Speech and automatic reading
 Character echo, word echo, and cursor echo can be configured separately.
 Punctuation levels are none, some, most, and all. At some and most,
 punctuation inside words, URLs, email addresses, and filenames is also
-named. Apostrophes within words and single numeric separators such as
-those in 3.14, 1,000, and 12:30 follow the selected level. Sentence
-punctuation follows the selected level too. Character review always
-names punctuation. Capital indicators, emoticons, repeated-symbol
-summaries, indentation feedback, and attribute feedback are configurable
-in Reading.
+named, without adding sentence pauses. Apostrophes within words and
+single numeric separators such as those in 3.14, 1,000, and 12:30 follow
+the selected level. Sentence punctuation follows the selected level too.
+Multiple dots in numeric sequences are named, so 2026.10.31 is read as
+“2026 dot 10 dot 31” at some and most. A percent sign immediately after
+a digit is named at some and most, so 100% is read as “100 percent”.
+Character review always names punctuation. Repeated-symbol summaries
+handle multiple runs in symbol-only tokens, including diffstats such as
++++++----- and bracketed bars such as [#####-----]. Each run must reach
+the configured minimum length and be selected by the current punctuation
+level; shorter runs follow ordinary punctuation handling. Capital
+indicators, emoticons, repeated-symbol summaries, indentation feedback,
+and attribute feedback are configurable in Reading.
 
 Fenrir+T announces the time; press twice quickly for the date.
 Fenrir+Shift+V announces the Fenrir version.
@@ -660,20 +672,48 @@ priority.
 
 A filename such as example__-__key_y.sh assigns the script key plus Y.
 The script key defaults to Compose and is configured by
-general.script_keys. Scripts must be executable to run. Fenrir invokes
-them directly and passes the current account name as the first argument.
-Commands appear in the tutorial’s script list.
+general.script_keys. The Keyboard tab of the Fenrir Menu has separate
+Fenrir keys and Script keys checkbox groups for keypad Insert, Insert,
+Caps Lock, and Super; Compose is also available for scripts. Uncheck a
+key in one group before assigning it to the other. A physical key cannot
+serve both roles, including through an alias such as KEY_META and
+KEY_RIGHTMETA. At least one Fenrir key must remain selected. After OK
+saves the changes, modifier assignments apply when the menu closes and
+all held keys are released. Cancel leaves them unchanged. If X11 cannot
+acquire the new keys, Fenrir reports the failure and retains the
+previous active assignments. The saved choices remain in the file;
+reopen the menu to edit or retry them. Desktop/laptop layout changes
+still require a new launch.
+
+The Fenrir-key checkboxes save keyboard.fenrir_keys, which overrides the
+layout’s defaults. When that setting is omitted, the layout supplies
+defaults and explicitly configured script keys are excluded from them.
+Existing custom script keys remain unchanged when editing the
+checkboxes. Keypad Insert acts as a modifier only with NumLock off.
+Shift+Caps Lock toggles capitalization when Caps Lock serves either
+role. Scripts must be executable to run. Fenrir invokes them directly
+and passes the current account name as the first argument. Commands
+appear in the tutorial’s script list.
 
 Remote control
 
 Notifications
 
-Send command notify TEXT to speak and remember a notification. Fenrir+N
-repeats the most recent notification. Fenrir+Control+N opens a list of
-the latest 100 notifications for this reader session, newest first. Each
-message is followed by its received time, formatted using the current
-Presentation Time and date preference. For example, Hello world 01:38 PM
-with 12-hour time, or Hello world 13:38 with 24-hour time.
+Send command notify TEXT to speak and remember a notification. When
+sounds are enabled and their volume is above zero, Fenrir plays the
+theme’s notification cue (notification.wav in the default theme), waits
+for the audio output to drain, then speaks the message. Sound playback
+runs outside the input loop. Missing or failed sound output leaves
+speech available. Speech mute or temporary silence keeps the sound and
+history, with no spoken message. Recalling a notification does not
+replay its sound.
+
+Fenrir+N repeats the most recent notification. Fenrir+Control+N opens a
+list of the latest 100 notifications for this reader session, newest
+first. Each message is followed by its received time, formatted using
+the current Presentation Time and date preference. For example,
+Hello world 01:38 PM with 12-hour time, or Hello world 13:38 with
+24-hour time.
 
 Use Up/Down to browse, Enter to repeat the selected entry, and Escape or
 the Close button to leave. Tab and Shift+Tab move between controls. The