Files
fish-config/functions/__insert_previous_path_head.fish
T
rootiest 1341e2559e docs(functions): standardize all function doc blocks to UNIX man-page style
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).
2026-06-05 20:18:49 -04:00

25 lines
787 B
Fish

# Copyright (C) 2026 Rootiest
# SPDX-License-Identifier: AGPL-3.0-or-later
# SYNOPSIS
# __insert_previous_path_head
#
# DESCRIPTION
# Inserts the directory component (dirname) of the last argument from the
# previous history command into the current commandline. Used as a keybinding
# helper to quickly reuse a directory path.
#
# EXAMPLE
# # Bind to a key to insert the directory from the last command.
function __insert_previous_path_head
# Get the last command tokens
set -l tokens (string split -n " " -- $history[1])
# If there are tokens, take the last one and strip the 'tail'
if set -q tokens[-1]
set -l path_head (dirname -- $tokens[-1])
# Insert it into the current command line
commandline -i -- $path_head
end
end