rootiest
1341e2559e
Replace all ad-hoc inline comments between license headers and function declarations with consistent SYNOPSIS / DESCRIPTION / ARGUMENTS / RETURNS / EXAMPLE blocks across all 99 project-owned functions/ files. No executable logic, variable names, or exit codes were modified. Completes Task #6 from AGENTS.md (Retroactive Function Documentation Standardization).
37 lines
1.2 KiB
Fish
37 lines
1.2 KiB
Fish
# Copyright (C) 2026 Rootiest
|
|
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
|
|
# SYNOPSIS
|
|
# __substitute_typo
|
|
#
|
|
# DESCRIPTION
|
|
# Reads the commandline buffer and applies ^old^new substitution against
|
|
# the most recent history entry, replacing the buffer with the expanded
|
|
# result. If the buffer does not match the ^old^new pattern, inserts a
|
|
# literal caret character instead. Intended to be bound to ^ in
|
|
# key_bindings.fish.
|
|
#
|
|
# EXAMPLE
|
|
# bind ^ __substitute_typo
|
|
function __substitute_typo
|
|
set -l cursor_pos (commandline -C)
|
|
set -l cmd (commandline)
|
|
|
|
# Check if the current line matches the ^old^new pattern
|
|
if string match -qr '\^([^^]+)\^([^^]*)' -- "$cmd"
|
|
set -l last_cmd $history[1]
|
|
set -l captured (string match -r '\^([^^]+)\^([^^]*)' -- "$cmd")
|
|
set -l old $captured[2]
|
|
set -l new $captured[3]
|
|
|
|
if test -n "$old"
|
|
set -l expanded (string replace -a -- "$old" "$new" "$last_cmd")
|
|
commandline -r "$expanded"
|
|
# No need to move cursor, it's a whole new line
|
|
end
|
|
else
|
|
# If it's just a normal caret (not part of a pattern), just insert it
|
|
commandline -i '^'
|
|
end
|
|
end
|