「手動」ページが狭すぎます(端末のサイズを利用しません)。

「手動」ページが狭すぎます(端末のサイズを利用しません)。

私は最初の「手動」ページを作成していますが、groffまさにそれをやっています。しかし、これを「コンパイル」してみると、端末で特定の数の列だけを占めます。他のマニュアルページを見てみましたが、端末の幅に合わせてページが増えます。直感的な例:

---------------------------------------
| stuff(1)             stuff(1)         |
|                                       |
| NAME                                  |
|       a tool to do stuff but          |
|       it isn't really working         |
|                                       |
| DESCRIPTION                           |
|       yadadyadyadyadyadyadydy         |
|       segfwefwefwefwe                 |
|                                       |
|       srgswrgwrg                      |
 ---------------------------------------

...ちょっと、理解していただきたいです。ほとんどのマニュアルページは全幅です。

これで、マニュアルページをテキストファイルに書き込んだ後(groff / nroff "構文"を使用)、次のように設定しました。

groff -Tascii -man ./path/to/man | more

答え1

groff呼び出し時に呼び出しが実行する操作を確認しましたman man(全幅を使用)。

$ strace -o log -f -v -s 1024 -e trace=process man man

検索groff呼び出しの結果は次のとおりです。

$ grep groff log | sed 's/\], \[.*//' 
28721 execve("/usr/bin/groff", ["groff", "-mtty-char", "-Tutf8", "-mandoc",
                                         "-rLL=171n", "-rLT=171n"

ここで xterm のサイズを変更します。

$ strace -o log2 -f -v -s 1024 -e trace=process  man man
$ grep groff log2 | sed 's/\], \[.*//'
28852 execve("/usr/bin/groff", ["groff", "-mtty-char", "-Tutf8", "-mandoc",
                                         "-rLL=119n", "-rLT=119n"

-rLLしたがって、パラメータが-rLTコンパイル中に使用される端末の幅に影響を与えると仮定します。groff

答え2

manマンページをスラッシュを含むパラメータとして指定すると、ほとんどの最新バージョンがDoTheRightThing™になると思います。

man ./stuff.1

関連情報