fix(first-run): move fish-config.1 symlink install to first-run #51

2026-06-12T23:41:45Z

rootiest commented

2026-06-12 23:41:45 +00:00

Summary

Moves the fish-config.1 man page symlink creation from conf.d/tricks.fish (every shell start) to conf.d/first_run.fish (once, like a real install step)
MANPATH addition stays in tricks.fish — env var that must be set each session
Symlink creation is unconditional in first-run (no category gate) — standard enough to not warrant one
Updates docs/fish-config.md to reflect the first-run timing

Manual Verification

Reset first-run state: set -Ue __fish_config_first_run_complete
Remove existing symlink: rm ~/.local/share/man/man1/fish-config.1
Open a new fish shell — symlink should be recreated and man fish-config should work
Open another new shell — symlink creation should not re-run (first-run guard)
Confirm MANPATH still includes ~/.local/share/man in every shell

## Summary - Moves the `fish-config.1` man page symlink creation from `conf.d/tricks.fish` (every shell start) to `conf.d/first_run.fish` (once, like a real install step) - `MANPATH` addition stays in `tricks.fish` — env var that must be set each session - Symlink creation is unconditional in first-run (no category gate) — standard enough to not warrant one - Updates `docs/fish-config.md` to reflect the first-run timing ## Manual Verification - [x] Reset first-run state: `set -Ue __fish_config_first_run_complete` - [x] Remove existing symlink: `rm ~/.local/share/man/man1/fish-config.1` - [x] Open a new fish shell — symlink should be recreated and `man fish-config` should work - [x] Open another new shell — symlink creation should not re-run (first-run guard) - [x] Confirm `MANPATH` still includes `~/.local/share/man` in every shell

rootiest added 2 commits 2026-06-12 23:41:46 +00:00

fix(first-run): move fish-config.1 symlink install to first-run 953aafd055

Startup side-effects that modify the filesystem belong in first-run, not
in a recurring conf.d fragment. The symlink is now created once (like a
real install step) instead of being checked on every shell launch.

MANPATH addition stays in tricks.fish — that's an env var that must be
set each session.

docs: update man page symlink description to reflect first-run timing 682e93c794

rootiest merged commit a92847e6ed into main

2026-06-12 23:43:14 +00:00

rootiest deleted branch fix/manpage-symlink-move-to-first-run

2026-06-12 23:43:14 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: rootiest/fish-config#51