chore(config): trim comments across the tracked configs - #11
Conversation
This stack of pull requests is managed by Graphite. Learn more about stacking. |
|
This PR is mid-rework. The large diff below is expected and not what is being proposed. This branch was cut before Two of them have been extracted and rebased onto the current
The third, Nothing here is lost. The original branch tip is tagged locally as |
41c02e9 to
5b42842
Compare
|
Reworked onto the current The original commit could not be ported as a patch, since Biggest single reduction is Kept as one-liners: the Ghostty pgrep truncation, the Helium single-instance handoff, Two things dropped that are not prose, worth a look:
Also rewrote one comment in No functional line changed. Verified per file by diffing every non-comment, non-blank line against Merge note: this touches |
Cut prose comments across 23 files, keeping a one-line reason wherever the
"why" was not obvious from the code. 970 -> 437 comment lines.
Largest reduction is aerospace.toml (147 -> 16): almost all of it was upstream
template boilerplate, including the "All possible keys" reference block, the
per-setting "Possible values" notes and 52 commented-out alt-a..alt-z bindings.
Kept as one-liners: the Ghostty pgrep truncation, the Helium single-instance
handoff, /etc/zshrc clobbering the history settings, the p10k instant-prompt
ordering constraint, the brew bundle --no-upgrade incident and its apt
counterpart, the mise-before-Homebrew PATH ordering, and the cmadd note about
`chezmoi add` flattening templates.
Also dropped, as distinct from prose:
- four commented-out status-bar lines in .tmux.conf, dead config rather
than explanation
- "# Status on top" above `set-option -g status-position bottom`, which
said the opposite of what the line does
- headers that restated the line beneath them ("# Mouse mode" above
`set -g mouse on`, "# Make folder then cd" above mcd)
Section dividers are kept in the longer files, where they are the only
navigation.
No functional line changed. Verified per file by diffing every non-comment,
non-blank line against origin/main, and separately by rendering each template
and parsing the result: zsh -n for the shell files, sh -n for the scripts,
tomllib for the TOML, and loading .tmux.conf on a scratch tmux socket.
5b42842 to
4ca3da9
Compare

fix(brew): drop deprecated homebrew/services tap
Homebrew deprecated and emptied this tap, so tapping it is now a hard
error and brew bundle fails outright:
Error: homebrew/services was deprecated. This tap is now empty
brew services moved into brew core, so nothing is lost by removing it.
This broke run_onchange_after_10-packages.sh on every apply.
chore(config): trim comments and reconcile drift
Cut prose comments across 19 files, keeping a one-line reason wherever
the 'why' was not obvious from the code. 736 -> 374 comment lines.
Largest reduction is aerospace.toml (147 -> 14): almost all of it was
upstream template boilerplate, including the 'All possible keys'
reference block and 52 commented-out alt-a..alt-z bindings.
Kept as one-liners: the brew --no-upgrade incident, the Ghostty pgrep
truncation, the Helium single-instance handoff, /etc/zshrc clobbering
history settings, and the p10k instant-prompt ordering constraint.
Also folds two local-only changes back into the source, which had
drifted because the tools write to deployed files directly:
The tmux truecolor config was the third such drift, but it turned out
to already exist on fix/tmux-truecolor, so this branch is rebased onto
that one and only retrims its comments.
No functional lines changed beyond those two merges.