ターミナルからPOSIXコマンドのマニュアルを表示する

コマンドのPOSIX仕様のみを表示する man コマンド、 pman （ピーマン）を作りました。

スクリプト
動作
まとめ

スクリプト

#!/bin/sh
# Manual for POSIX
# requirements: w3m

usage() {
	cat <<- EOF
	Usage: $0 [entry]
	EOF
}

# Check conditions before executing
command -v w3m &>/dev/null || { echo "w3m required."; exit 1; }
[ $# -eq 0 ] && { usage; exit 1; }

# Variable definition
cols=$(stty size | cut -f2 -d\ ) # ** "stty size" is not POSIX **
url="https://pubs.opengroup.org/onlinepubs/9699919799/utilities/$1.html"

# Search and display manual
w3m -M -cols ${cols:-80} -no-cookie "$url" | less

上の内容で pman というファイルを作ったらパス配下において

chmod a+x /path/to/pman

動作

$ pman awk などのように使います。

カラクリは非常に簡単で、 OpenGroupが運営しているPOSIXリファレンス（https://pubs.opengroup.org/onlinepubs/9699919799/）の各コマンドページをリクエストして表示しているだけです。

pman はCLIブラウザアプリケーションの w3m を使用しています。
最初は curl や wget を考えましたが、残念ながら "Accept: text/plain" ヘッダーをつけたり .txt ファイルを探してもダメだったので、HTMLをCLI向けに解釈してくれる w3m を採用しました。

元々POSIXリファレンスサイトの表示がマニュアルらしくなっているのも相まって、いかにも普段叩いている man っぽい表示になっていますね。

w3m は通常横幅いっぱいに表示してくれますが、より man のページングに近づけるために less を通すと横幅の文字数が固定されてしまうため、 stty コマンドの出力から行幅を抽出してパラメータに渡しています（$colums 変数）。
ただここはPOSIXではないので要注意（一応GNUとBSDで確認してます）。

まとめ

これでPOSIXコマンドの実装依存に悩まされる機会が少しでも減りますように…！