diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/config.md | 9 | ||||
| -rw-r--r-- | docs/themes.md | 3 |
2 files changed, 8 insertions, 4 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. diff --git a/docs/themes.md b/docs/themes.md index 5c7da44b..01965de5 100644 --- a/docs/themes.md +++ b/docs/themes.md @@ -102,7 +102,8 @@ so existing exported themes remain valid. | Optional role | Purpose | When absent | | --- | --- | --- | | `tag_active_bg`, `tag_active_fg` | Focused pane tag surface and text | `tag_bg`, `tag_fg` | -| `tag_name_fg` | Filename at the end of the pane's path, on normal and active tags | The corresponding normal or active tag foreground | +| `tag_name_fg` | Filename or terminal `Tty` command tint | The corresponding normal or active tag foreground | +| `tag_active_name_fg` | Filename or terminal `Tty` tint in active tags | `tag_name_fg`, then the active tag foreground | | `border` | Quiet separators | `scroll_track` | | `lineno_active` | Restrained current line number foreground | `lineno` | | `search_bg`, `search_fg` | Search matches, independent of selection | `sel_bg`, `sel_fg` | |