refactor(functions): standardize documentation, metadata, and wrappers #6

Merged
rootiest merged 2 commits from feat/deps-fallbacks into main 2026-05-01 03:18:35 +00:00
Owner
  • Add comprehensive --description flags to all fish functions for better help and functions output.
  • Introduce and correct --wraps flags to ensure proper completions for aliased commands (e.g., top wrapping btop, zellij, upgrade wrapping paru).
  • Prepend descriptive comments before function definitions for better source readability.
  • Add standard copyright and SPDX license identifiers to shell scripts.
  • Enhance script robustness by ensuring consistent terminal checks (Kitty, WezTerm) and graceful fallbacks in window/tab spawning functions (spwin, tab).
  • Implement graceful fallbacks to basic core utilities when preferred modern alternatives are missing (e.g., top falling back to system top if btop is missing, view falling back to less or cat if nvim is unavailable).
  • Improve overall code consistency across the functions/ directory.
- Add comprehensive `--description` flags to all fish functions for better `help` and `functions` output. - Introduce and correct `--wraps` flags to ensure proper completions for aliased commands (e.g., `top` wrapping `btop`, `zellij`, `upgrade` wrapping `paru`). - Prepend descriptive comments before function definitions for better source readability. - Add standard copyright and SPDX license identifiers to shell scripts. - Enhance script robustness by ensuring consistent terminal checks (Kitty, WezTerm) and graceful fallbacks in window/tab spawning functions (`spwin`, `tab`). - Implement graceful fallbacks to basic core utilities when preferred modern alternatives are missing (e.g., `top` falling back to system `top` if `btop` is missing, `view` falling back to `less` or `cat` if `nvim` is unavailable). - Improve overall code consistency across the `functions/` directory.
rootiest added 2 commits 2026-05-01 03:17:57 +00:00
Remove several functions that are either no longer relevant or belong in
.user-dots as local/machine-specific functions.
- Add comprehensive `--description` flags to all fish functions for better `help` and `functions` output.
- Introduce and correct `--wraps` flags to ensure proper completions for aliased commands (e.g., `top` wrapping `btop`, `zellij`, `upgrade` wrapping `paru`).
- Prepend descriptive comments before function definitions for better source readability.
- Add standard copyright and SPDX license identifiers to shell scripts.
- Enhance script robustness by ensuring consistent terminal checks (Kitty, WezTerm) and graceful fallbacks in window/tab spawning functions (`spwin`, `tab`).
- Implement graceful fallbacks to basic core utilities when preferred modern alternatives are missing (e.g., `top` falling back to system `top` if `btop` is missing, `view` falling back to `less` or `cat` if `nvim` is unavailable).
- Improve overall code consistency across the `functions/` directory.
rootiest merged commit abc5379190 into main 2026-05-01 03:18:35 +00:00
rootiest deleted branch feat/deps-fallbacks 2026-05-01 03:18:35 +00:00
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: rootiest/fish-config#6