为什么当我查找“手册”页时会出现“用户贡献的 Perl 文档”

为什么当我查找“手册”页时会出现“用户贡献的 Perl 文档”

当我

man -f <some string>

除了预期的 Unix 手册页之外,我还收到了一堆看起来很奇怪的条目,它们的标题都是“User Contributed Perl Documentation”。例如

man -f ip

除了诸如此类的事情

ip(4)            - Internet Protocol
ip2cc(1)         - lookup country from IP address or hostname
ipconfig(8)      - view and control IP configuration state
...

还列出了诸如

IP::Authority(3pm)       - fast lookup of authority by IP address
IP::Country(3pm)         - fast lookup of country codes from IP addresses
IP::Country::Fast(3pm)   - fast lookup of country codes by IP address
IP::Country::MaxMind(3pm) - Look up country by IP Address
IP::Country::Medium(3pm) - cached lookup of country codes by IP address and domain name

所有这些都被标识为“用户贡献的 Perl 文档”。

我在 OS X 10.8.2 上的“man”路径(来自man --path)是

/usr/local/git/share/man:/usr/share/man:/usr/local/share/man:/opt/X11/share/man:/usr/texbin/man

这与其他不显示这些附加页面的机器上的情况相同。

这些来自哪里?默认情况下我可以将结果限制为仅 Unix shell 页面吗?

答案1

Perl 鼓励库作者将文档包含在每个源文件中的格式。该文档可以自动翻译成其他格式,包括手册页,并且许多系统将已安装的 Perl 模块的文档提供为手册页。

Perl 模块的手册页位于 部分3pm。您可以通过将-S选项传递给 man 并指定一个不包含 3 的值来跳过整个第 3 节(任何语言的库函数) ,例如

man -S 1:8:4:5:6:7 foo

设置MANSECT环境变量也有同样的效果。我认为没有办法在 OSX 上保留第 3 部分的同时排除下午 3 点部分。

答案2

这些是 Perl 模块的手册页(无用的赠品:3pm第 3 节(库函数),*P*erl *M*odule),其中大部分是用户贡献给 Perl 的(查看CPAN),连同他们的文档。

相关内容