Subtitles and menu text sections in the editor

docs/user-guide.md

@@ -1,7 +1,7 @@
 # Unheard City - user guide
 
-Replace voice lines, music and ambience in **Batman: Arkham City (PC, Steam)**. Everything you change can be put
-back with one click.
+Replace voice lines, music, ambience and sound effects, and edit subtitles and menu text in **Batman: Arkham
+City (PC, Steam)**. Everything you change can be put back with one click.
 
 ## Install and start
 1. **Windows:** unzip the download and double-click **Install.cmd**. It installs Unheard City for your user (no
@@ -65,6 +65,26 @@ than the original, since the game may cut it off.
 - If Steam "Verify integrity of game files" or an update undoes your changes, a bar offers **Re-apply my
   changes** or **Forget them**. Do not use "verify" to undo mods; use Revert all.
 
+## Subtitles
+The **Subtitles** tab lists the subtitle of every speech line (11 languages; choose one with *Language*).
+- Search by text or line name, filter by **Character** and **Category** (taken from the linked speech sound),
+  or show **Modified only**. Select a row to edit its text below and press **Apply** (or Enter).
+- Each subtitle replaces the original *in place*, so it can be at most as long as the original (the counter
+  shows *used / room* characters). Latin-1 subtitles accept Latin-1 characters only (accents are fine);
+  Russian, Polish, Japanese and Korean subtitles accept any character.
+- **Go to the sound** opens the speech line in the Sounds tab. In the Sounds tab, the editor of a speech line
+  shows its subtitle under the audio: edit both side by side and use **Apply subtitle**, or **Show in
+  Subtitles** to jump back.
+- **Find and replace…** works on the rows the filters show (texts that would not fit are listed and skipped).
+- **Revert** / **Revert all texts here** put the original text back (every copy in every game file).
+- About 8 % of the subtitles belong to lines the game never plays (placeholders); they have no linked sound.
+
+## Menu text
+The **Menu text** tab lists every menu, HUD, bio, riddle and credits string of the chosen language (about
+7,000), grouped by **File** (e.g. `FRONTEND`, `GFxUI`, `Bios`). Search, edit, apply and revert work like
+subtitles; menu texts can be of any length but cannot contain line breaks (keep the game's own markers such
+as `\n` as they are).
+
 ## Notes, tags, favorites
 Right-click → **Notes & tags…** (F2): free text and comma-separated tags, searchable and filterable.
 Click the **★** column to mark favorites. These are stored in your user data folder, not in the game.
@@ -73,6 +93,7 @@ Click the **★** column to mark favorites. These are stored in your user data f
 - **Export mod…**: choose which changed sounds to include and save a `.acmod` file (the exact game data plus
   the audio, so it also works for another language whose original has a different size).
 - **Import mod…**: shows which sounds match this game, then installs them. You can revert them like any change.
+- Changed subtitles and menu texts are exported and imported with the sounds (listed as *Text*).
 
 ## Settings
 ![Settings](img/settings.png)