refactor(functions): standardize documentation, metadata, and wrappers
- 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.
This commit is contained in:
+9
-2
@@ -1,7 +1,14 @@
|
||||
# Copyright (C) 2026 Rootiest
|
||||
# SPDX-License-Identifier: AGPL-3.0-or-later
|
||||
|
||||
function view --wraps='neovim -R' --wraps='nvim -R' --description 'alias view=nvim -R'
|
||||
nvim -R $argv
|
||||
# alias view=nvim -R
|
||||
function view --wraps='nvim -R' --description 'alias view=nvim -R'
|
||||
if type -q nvim
|
||||
nvim -R $argv
|
||||
else if type -q less
|
||||
less $argv
|
||||
else
|
||||
command cat $argv
|
||||
end
|
||||
|
||||
end
|
||||
|
||||
Reference in New Issue
Block a user