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

2026-05-01T03:17:57Z

rootiest commented

2026-05-01 03:17:57 +00:00

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

refactor: remove obsolete or private functions a4d8574f49

Remove several functions that are either no longer relevant or belong in
.user-dots as local/machine-specific functions.

refactor(functions): standardize documentation, metadata, and wrappers 084e6fb9ca

- 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

rootiest referenced this issue from a commit

2026-05-01 03:18:35 +00:00

Merge pull request 'refactor(functions): standardize documentation, metadata, and wrappers' (#6) from feat/deps-fallbacks into main

rootiest referenced this issue from a commit

2026-06-06 00:18:57 +00:00

docs(functions): standardize all function doc blocks to UNIX man-page style

rootiest referenced this pull request

2026-06-06 00:19:23 +00:00