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:

Rootiest

2026-04-30 23:15:18 -04:00

parent a4d8574f49

commit 084e6fb9ca

85 changed files with 287 additions and 66 deletions

									
										functions/bkg.fish
									
		+2
		-1
	
												View File
												
				@@ -12,7 +12,8 @@

				#   bkg firefox

				#   bkg code .

				#

				function bkg

				# Execute bkg

				function bkg --description 'Execute bkg'

				    # Check if a command was provided as an argument.

				    if test -z "$argv[1]"

				        echo "Usage: bkg <command> [arguments...]"