kiss/contrib/kiss-help

#!/bin/sh -e
# Read KISS documentation

cd "$KISS_ROOT/usr/share/doc/kiss" 2>/dev/null || {
    printf 'Documentation is missing from /usr/share/doc/kiss\n'
    exit 1
}

_q=$1

! [ -f "${_q:-.}/index.txt" ] || file=./${_q:-.}/index.txt
! [ -f "${_q:-.}.txt" ]       || file=./${_q:-.}.txt
! [ -f "${_q:-:}" ]           || file=./${_q:-.}

# Fallback to package READMEs.
# False positive, intended behavior.
# shellcheck disable=2046
[ "$file" ] || {
    set -f
    set +f -- $(kiss s "${_q##*/}")
    file=${1:+"$1/README"}
}

# Fallback to search (allows 'kiss help firefox' to work).
# False positive, intended behavior.
# shellcheck disable=2046
[ "$file" ] || {
    set -f
    set +f -- $(find . -name "${_q##*/}.txt")
    file=$1
}

: "${file:=404.txt}"

cat <<EOF - "$file" | "${PAGER:-less}"
Reading ${file#./}
________________________________________________________________________________


EOF