1
0
mirror of git://git.sv.gnu.org/coreutils.git synced 2026-02-19 22:02:21 +02:00
Files
coreutils/man/viewman
Pádraig Brady 3950891eaa doc: viewman: a new helper to quickly view formatted man pages
Use like: man/viewman ls

* man/viewman: Generate man page on the fly, and view.
2026-01-21 13:51:39 +00:00

34 lines
786 B
Bash
Executable File

#!/bin/sh
# Generate and view man page with less, for passed command name
# Note to get man to behave like this you can also:
# export MANROFFOPT=-P-i
# export LESS=-R
# export MANPAGER=less
unset GROFF_NO_SGR
unset HELP_NO_MARKUP
hdir=$(dirname "$0")
CONFIG_HEADER="$hdir"/../lib/config.h
grep '^#define BOLD_MAN_REFS 1' $CONFIG_HEADER > /dev/null &&
BOLD_REFS=--bold-refs
man="$1"; cmd="$1"
test "$1" = 'test' && cmd='['
test "$1" = '[' && man='test'
test "$1" = 'install' && cmd='ginstall'
test "$1" = 'ginstall' && man='install'
"$hdir"/help2man \
--include="$hdir"/../man/$man.x \
$BOLD_REFS \
--loose-indent \
"$hdir"/../src/$cmd |
preconv | # convert utf-8 chars like in Author names to groff compat
groff -Tutf8 -man -P-i -rLL=${MANWIDTH:-$COLUMNS}n |
less -R