您如何查看刚刚创建的手册页？

Posted 2023-02-26

【中文标题】您如何查看刚刚创建的手册页？

【英文标题】：How do you view a man page you just created?

【发布时间】：2014-03-24 16:11:04

【问题描述】：

假设我有一个手册页，我刚刚编写并通过nroff -man，称为command.1

我现在如何使用man 查看它？我查看了man 手册页，也许我错过了它，但我什么也没看到。我也搜索了谷歌。

只能使用nroff -man查看吗？ man 是否有用于查看该特定文件的命令行选项？是否需要修改MANPATH？

【参考方案1】：

将command.1 手册页放在名为man1 的新文件夹中。然后，假设您在包含新的 man1 文件夹的文件夹中，请像这样调用 man 命令：

man -M . command

如果您位于其他位置，请将点替换为包含 man1 文件夹的文件夹的路径。

【参考方案2】：

man 有不同的版本：一种基于man-db project（在许多 Linux 发行版中使用）和 macOS 附带的一种，至少据我所知。我找不到后者的项目页面，但它似乎由 Federico Lucifredi 维护。

重点是这样的：Lucifredi 的man 支持在提供文件路径时直接打开文件：

man ./command.1

macOS man page for man中提到了这个：

但是，如果 name 包含斜杠 (/)，则 man 会将其解释为文件规范，因此您可以使用 man ./foo.5 甚至 man /cd/foo/bar.1.gz。

blog post by Lucifredi 也暗示了这一点：

再给你一个提示：

man ./foo.1

是你的朋友，看看你刚刚写的和标记的所有荣耀和错误。