Updated The Caption Documentation

docs/modding/captions/cmds.md

@@ -9,8 +9,7 @@ features:
 
 There are plenty of options in the settings menu to configure the captions.
 
-* `Closed Captions` enables closed captions.
-* `Subtitles` determines whether the SFX effects are shown in captions. If set to On, only dialogues will appear.
+* `Mode` determines which subtitles to show, if any. When `Disabled` is selected, subtitles will not be displayed. `Subtitles` shows all the subtitles, `Closed Captions` shows only dialogues (subtitles not marked as VFX)
 * `Font` is the font that the caption system uses.
     * `Lexend` as the default P2CE / Strata source font;
     * `Univers` from Portal 2;
@@ -31,7 +30,8 @@ Additionally, there are the following console commands:
 | --- | --- |
 | `cc_panorama` | Enable usage of Panorama Closed Captions over Legacy VGUI
 | `cc_lang` | Sets the language for the captions. Does not require map restarts - the next caption token will be displayed with a new language.
-| `cc_captions_debug` | smth
+| `cc_allow_txt_captions` | Allows text captions.
+| `cc_captions_debug` | Enables additional output strings in the console.
 | `cc_captiontrace` | Shows missing closecaptions (0 = no, 1 = devconsole, 2 = show in hud)
 | `cc_emit` | Shows a specified caption and plays its sound
 | `cc_emit_raw` | Same as `cc_emit` but raw text can be inserted
@@ -41,6 +41,9 @@ Additionally, there are the following console commands:
 | `cc_norepeat` | In multiplayer, don't repeat captions more often than this many seconds
 | `cc_panorama_log` | Enables Panorama CC verbose logging
 | `cc_panorama_reload` | Reloads caption definitions for Panorama subtitles only
+| `cc_panorama_bg_opacity` | Determines Panorama CC background color
+| `cc_panorama_entry_margin` | Sets the text margin.
+| `cc_prefer_dat_captions` | Allows using .dat captions instead of the new ones.
 | `cc_sentencecaptionnorepeat` | How often a sentence can repeat.
 | `cc_sfx_linger_time` | Close caption linger time for items marked as SFX
 | `cc_showmissing` | Shows missing closecaption entries.

docs/modding/captions/porting.md

@@ -7,7 +7,7 @@ features:
 
 ## Porting captions
 
-The new caption system does not read the old caption files. Instead, it requires a new caption file with a custom structure - `subtitles_*language*.kv3`.
+The new caption system introduces the new caption structure, which can be found in `resource/subtitles_*language*.kv3`.
 
 ![KV3 caption file](images/kv3_file.png)
 
@@ -20,4 +20,8 @@ If the script fails (i.e. syntax error in the original captions), it will show t
 
 ![Converter drag-n-drop support](images/converter.png)
 
-Then copy the converted caption file to `resources`. Done!
+Then copy the converted caption file to `resources`.
+
+### .dat support
+
+There is a convar that allows switching between the new caption files and the old .dat ones - `cc_prefer_dat_captions`. If set to 1, .dat files will override .kv3 files.