当我
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),连同他们的文档。