如何直接显示手册页？

Question

我正在为我正在打包的程序编写手册页。如何显示我创建的联机帮助页文件，以检查它是否正常？有没有办法将我的文件直接传递给man命令，而不是让它按名称搜索已安装的联机帮助页？

我尝试做类似的事情man myprog.1，man < myprog.1但在这两种情况下，我都收到一条错误消息，说找不到手册页。

Answer 1

man 可以选择读取本地文件： -l

-l, --local-file

激活“本地”模式。格式化和显示本地手册文件，而不是搜索系统的手册集。每个手册页参数将被解释为正确格式的 nroff 源文件。不生成 cat 文件。

如果“-”被列为参数之一，则输入将从标准输入中获取。如果未使用此选项，并且 man 无法找到所需的页面，则在显示错误消息之前，它会尝试像提供此选项一样，使用名称作为文件名并寻找完全匹配的内容。

因此，您可以通过以下方式预览正在进行的工作：

man -l /path/to/manfile.1

Answer 2

对于早于该-l选项的系统，“老派”方式是

nroff -man filename | more -s

Answer 3

我用过简单

man ./path/to/man.1

您需要在路径中包含一个斜杠，否则它会搜索系统目录。适用于我拥有的 Linux 和 OS X 系统（后者没有-l）。

$ cd /tmp
$ cp /usr/share/man/man1/ls.1 .
$ man ls.1
No manual entry for ls.1
$ man ./ls.1     # works