docs: add Section 11 — Troubleshooting

Add a new Troubleshooting section to the manual with 9 concise how-to
subsections covering uninstall/revert, Fish version requirements,
disabling logging, changing the greeting, secrets/local config, the
return sentinel gotcha, missing dependencies, Vi mode keybindings,
and minimal mode.

Renumber Viewing This Manual from Section 11 to Section 12 to place
troubleshooting before it. Update TOC and help index accordingly.

All verify-manual.py checks pass.
This commit is contained in:
2026-07-26 23:55:28 -04:00
parent 1b69ff9a7f
commit 24cdfe4129
4 changed files with 272 additions and 6 deletions
+11 -1
View File
@@ -42,6 +42,16 @@ sidebar:
8. Fisher Plugins
9. Installation
10. Personalization
11. Viewing This Manual
11. Troubleshooting
11.1 Uninstalling / Reverting to Backup
11.2 Fish Version Requirement
11.3 Disable Session Logging
11.4 Change or Disable the Greeting
11.5 Secrets and Machine-Local Configuration
11.6 Tool Init Does Nothing (Return Sentinel)
11.7 Missing Dependencies
11.8 Vi Mode Keybindings
11.9 Minimal Mode / Disabling Opinionated Features
12. Viewing This Manual
---