Files
fish-config/functions/lss.fish
T
rootiest 4c51ef7a33 docs(functions): add # CATEGORY to documented function headers
Records each documented function's manual category in its own header, so
Section 5 can later be generated from source instead of hand-maintained
alongside it. Values reproduce the current grouping in
docs/manual/05-functions/ exactly; no documentation changes meaning here.

Four functions are skipped because they have no header at all yet
(branch, fc, gitup, sudo-toggle); they get one in the merge that follows.
2026-07-26 03:44:03 -04:00

28 lines
787 B
Fish

# Copyright (C) 2026 Rootiest
# SPDX-License-Identifier: AGPL-3.0-or-later
# CATEGORY
# 01-file-and-directory
#
# SYNOPSIS
# lss [args...]
#
# DESCRIPTION
# Lists all files sorted by size in long format with gradient color scaling.
# Uses eza, falls back to lsd, then to system ls.
#
# ARGUMENTS
# args... Arguments forwarded to the listing command
#
# EXAMPLE
# lss ~/downloads
function lss --description 'Size-sorted listing'
if which eza >/dev/null 2>&1
eza --oneline --long --all --sort=size --icons --color=auto --hyperlink --color-scale=size --color-scale-mode=gradient $argv
else if which lsd >/dev/null 2>&1
lsd --oneline --long --all --sort=size --reverse --color=auto --hyperlink=always $argv
else
command ls $argv
end
end