rootiest
f0de5378fe
Two shapes reach a reader as literal punctuation rather than markup: A backtick inside a four-space block. The block is verbatim in every renderer -- pandoc sets it monospace, prettify() fences it for the site -- so the backtick is a character on the page. Twelve such lines are cleaned; each sat at the start of its column, so the alignment of the C5 capture table and the component summaries is unchanged. A span split over a line break. Markdown pairs it happily, but config-help pairs backticks one line at a time, so `fish-deps\nupdate` showed both halves. The sentence is reflowed. Both are now enforced, the first by test_concat_section_five_stays_ verbatim and the second by test_concat_code_spans_never_straddle_a_line.
36 lines
2.2 KiB
Markdown
36 lines
2.2 KiB
Markdown
---
|
|
title: Components Reference
|
|
manTitle: 8. COMPONENTS REFERENCE
|
|
sidebar:
|
|
order: 12
|
|
helpKeywords:
|
|
- componentsreference
|
|
---
|
|
The following tables detail every component in each category. Use this
|
|
reference to understand exactly which behaviors change when you toggle a
|
|
category variable.
|
|
|
|
Category Description
|
|
──────────────────────────────────────────────────────────────────────────
|
|
C1 [Command Shadows](/08-components-reference/01-c1-command-shadows/) — Wraps destructive commands (rm, cp) to be safe by default
|
|
C2 [Startup Side-Effects](/08-components-reference/02-c2-startup-side-effects/) — Bootstraps Fisher, generates wrappers, auto-activates venvs
|
|
C3 [Overrides](/08-components-reference/03-c3-key-and-environment-overrides/) — Overrides cd, sets Vi mode, binds <CR> to smart_enter
|
|
C4 [Integrations](/08-components-reference/04-c4-terminal-and-tool-integration/) — Kitty/Wezterm integrations, starship hooks, fzf theme
|
|
C5 [Logging and Capture](/08-components-reference/05-c5-logging-and-capture/) — Session logs, command duration
|
|
C6 [Greeting & First-Run UI](/08-components-reference/06-c6-greeting-and-first-run-ui/) — Custom startup banner
|
|
|
|
Each category further sub-divides into two to six sub-categories (24 in
|
|
total) with their own `__fish_config_op_<category>_<subcategory>` toggles
|
|
-- see that category's page for its sub-category list.
|
|
|
|
## Per-function overrides: `C0`/`always`
|
|
|
|
Every guarded function or file can also carry a reserved `always/on` or
|
|
`always/off` tag in its `# COMPONENT` header, independent of every C1-C6
|
|
category and sub-category toggle and invisible to `config-settings`. An
|
|
`always/off` tag disables that function unconditionally; an `always/on`
|
|
tag enables it unconditionally, ignoring the state of every other tagged
|
|
sub-category. This is a per-function escape hatch for cases too granular
|
|
or too idiosyncratic to justify a taxonomy entry -- edit the header
|
|
directly and run `__fish_config_op_registry_rebuild` to apply the change.
|