docs(manual): document sub-categories in customization, reference index, and troubleshooting

Sub-categories were previously undocumented outside README and the
per-category reference pages. Add a paragraph to 07-customization.md (the
canonical opinionated-components page) explaining the sub-category cascade,
a short note to the 08-components-reference index pointing readers at each
category's sub-category list, and a troubleshooting note that
__fish_config_op_<category>_<subcategory> variables follow the same
check/reset pattern as category variables.
This commit is contained in:
2026-08-18 18:12:41 -04:00
parent 040c98c0a7
commit a8468f3402
3 changed files with 24 additions and 0 deletions
+7
View File
@@ -237,6 +237,13 @@ Re-enable everything:
set -Ue __fish_config_opinionated
Each category also has two to six sub-categories (e.g.
`__fish_config_op_aliases_filesystem`) that can be checked, disabled, or
reset the same way — `set -U __fish_config_op_<category>_<subcategory> off`
and `set -Ue __fish_config_op_<category>_<subcategory>` work identically to
the category-level recipes above, just one level more granular. See
[Components Reference](/08-components-reference/) for the full list.
For an interactive alternative to setting these variables by hand, run `config-settings`.
---