☰

“手册”页面太窄（没有利用终端尺寸）

tag-icon • tag-icon bash rhel man
“手册”页面太窄（没有利用终端尺寸）

我正在制作我的第一个“手册”页面，并且我正在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

相关内容