rootiest/fish-config
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add Section 11 — Troubleshooting

Browse Source 
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:
rootiest
2026-07-26 23:55:28 -04:00
parent 1b69ff9a7f
commit 24cdfe4129
4 changed files with 272 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/fish-config.index
+26 -3
View File
@@ -288,9 +288,30 @@ personalize=# 10. PERSONALIZATION
secrets-file=## secrets.fish
local-config=## local.fish
# ── Section 11: Viewing This Manual ──────────────────────────
viewing=# 11. VIEWING THIS MANUAL
manual=# 11. VIEWING THIS MANUAL
# ── Section 11: Troubleshooting ──────────────────────────────
troubleshooting=# 11. TROUBLESHOOTING
troubleshoot=# 11. TROUBLESHOOTING
faq=# 11. TROUBLESHOOTING
uninstall=## Uninstalling / Reverting to Backup
revert=## Uninstalling / Reverting to Backup
fish-version=## Fish Version Requirement
version-req=## Fish Version Requirement
disable-logging=## Disable Session Logging
disable-greeting=## Change or Disable the Greeting
change-greeting=## Change or Disable the Greeting
secrets-trouble=## Secrets and Machine-Local Configuration
local-trouble=## Secrets and Machine-Local Configuration
return-sentinel=## Tool Init Does Nothing (Return Sentinel)
tool-init=## Tool Init Does Nothing (Return Sentinel)
missing-deps=## Missing Dependencies
vi-mode=## Vi Mode Keybindings
vi-trouble=## Vi Mode Keybindings
emacs-mode=## Vi Mode Keybindings
minimal-trouble=## Minimal Mode / Disabling Opinionated Features
# ── Section 12: Viewing This Manual ──────────────────────────
viewing=# 12. VIEWING THIS MANUAL
manual=# 12. VIEWING THIS MANUAL
ov=## In the terminal
man-page=## As a man page
manpage=## As a man page
@@ -298,3 +319,5 @@ jump=## In the terminal
html=## The documentation website
browser=## The documentation website
site=## The documentation website