From: Pádraig Brady <P@draigBrady.com>
Date: Tue, 30 Dec 2025 14:37:45 +0000 (+0000)
Subject: doc: viewman: a new helper to quickly view formatted man pages
X-Git-Tag: v9.10~59
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=3950891eaa2484907bdb2205bbbad5f037ae07b3;p=thirdparty%2Fcoreutils.git

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.
---

diff --git a/man/viewman b/man/viewman
new file mode 100755
index 0000000000..7fb8fed9cb
--- /dev/null
+++ b/man/viewman
@@ -0,0 +1,33 @@
+#!/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