rootiest
4c51ef7a33
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.
38 lines
949 B
Fish
38 lines
949 B
Fish
# Copyright (C) 2026 Rootiest
|
|
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
|
|
# CATEGORY
|
|
# 03-editors-and-viewers
|
|
#
|
|
# SYNOPSIS
|
|
# less [args...]
|
|
#
|
|
# DESCRIPTION
|
|
# Pager wrapper that tries $PAGER, then ov, then less, then more, then cat
|
|
# as fallbacks in that order.
|
|
#
|
|
# ARGUMENTS
|
|
# args... Files or options forwarded to the pager
|
|
#
|
|
# EXAMPLE
|
|
# less /var/log/syslog
|
|
function less --wraps='ov' --description 'Pager wrapper: $PAGER → ov → less → more → cat'
|
|
# Opinionated guard (C1): fall back to bare command less when disabled.
|
|
if not __fish_config_op_enabled __fish_config_op_aliases
|
|
command less $argv
|
|
return $status
|
|
end
|
|
|
|
if set -q PAGER; and command -q $PAGER
|
|
command $PAGER $argv
|
|
else if command -q ov
|
|
command ov $argv
|
|
else if command -q less
|
|
command less $argv
|
|
else if command -q more
|
|
command more $argv
|
|
else
|
|
command cat $argv
|
|
end
|
|
end
|