Files
fish-config/functions/ltr.fish
T
Claude fceddfc43f docs: add DEPENDENCIES sections to function doc headers
Documents what each function needs for full functionality -- other
repo functions it calls, and external CLI tools it uses or falls
back gracefully without (e.g. rm/trash, ls/eza+lsd) -- matching the
existing CLASSIFICATION convention's placement and the ~20 functions
that already carried this label.

Also broadens verify-manual.py's dependency-resolution check to
recognize this repo's other existence-check idioms (command -q,
command -v, which -- not just type -q) and dng2avif's dynamic
type -q $cmd loop, since several genuine dependencies (eza, lsd,
fastfetch, fd, ps, ...) are only ever guarded that way.
2026-09-22 22:22:27 -04:00

40 lines
1.0 KiB
Fish

# Copyright (C) 2026 Rootiest
# SPDX-License-Identifier: AGPL-3.0-or-later
# CATEGORY
# 01-file-and-directory
#
# DEPENDENCIES
# eza, lsd
#
# CLASSIFICATION
# bypasses-shadow(ls)
#
# SYNOPSIS
# ltr [args...]
#
# DESCRIPTION
# Lists all files sorted by modification time in reverse (oldest first) in
# long format with age-based gradient color scaling. Uses eza, falls back
# to lsd, then to system ls.
#
# ARGUMENTS
# args... Arguments forwarded to the listing command
#
# EXIT STATUS
# Exit status of eza, lsd, or ls, whichever ran
#
# EXAMPLE
# ltr ~/projects
function ltr --description 'Reversed time-sorted listing'
__fish_help_header (status current-function) $argv; and return 0
if which eza >/dev/null 2>&1
eza --long --all --sort=modified --icons --hyperlink --color=auto --color-scale=age --color-scale-mode=gradient $argv
else if which lsd >/dev/null 2>&1
lsd --long --all --sort=time --reverse --color=auto --hyperlink=always $argv
else
command ls --color=auto -ltr $argv
end
end