Match filename tint lightness in every canonical theme and focus state

1 files changed, 6 insertions, 3 deletions

diff --git a/docs/config.md b/docs/config.md
index 53c76087..5a7a358f 100644
--- a/docs/config.md
+++ b/docs/config.md
@@ -268,7 +268,7 @@ name, thirteen required RGB roles (`sel_bg`, `sel_fg`, `tag_bg`, `tag_fg`,
 `box`, `box_dim`, `kw`, `str`, `num`, `comment`, `lineno`, `scroll_track`,
 `scroll_thumb`), nullable `bg`/`fg`, and either a 16-color RGB `palette` or
 `null`. Optional nullable RGB roles extend this format:
-`tag_active_bg`, `tag_active_fg`, `tag_name_fg`, `border`, `lineno_active`, `search_bg`, `search_fg`,
+`tag_active_bg`, `tag_active_fg`, `tag_name_fg`, `tag_active_name_fg`, `border`, `lineno_active`, `search_bg`, `search_fg`,
 `diagnostic_error`, `diagnostic_warning`, `diagnostic_info`, and
 `diagnostic_hint`. Missing new roles use backward-compatible defaults, so
 previously exported files remain valid. [Theme customization](themes.md)
@@ -277,8 +277,11 @@ hex literals are accepted. The original fields remain required; there is no
 inheritance or partial override layer.
 
 `tag_name_fg` gives the filename at the end of a pane's path a separate
-foreground on both normal and active tags. When omitted or `null`, it uses
-the corresponding tag foreground. Directory text and tag commands retain
+foreground. `tag_active_name_fg` can adjust that tint for active tags; it falls
+back to `tag_name_fg`. When both are omitted or `null`, the filename uses
+the corresponding tag foreground. All canonical themes use a different hue
+at similar perceived brightness to the surrounding text in both states.
+Directory text and tag commands retain
 their regular colors; selecting filename text uses the selection colors.
 Terminal tags use this color for `Tty`, which comes immediately after the path.