osx – 当我查找“man”页面时,为什么会显示“User Contributed Perl Documentation”

当我

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页面吗?

最佳答案
Perl鼓励图书馆作者在每个源文件中包含pod格式的文档.此文档可以自动转换为其他格式(包括手册页),并且许多系统将已安装的Perl模块的文档作为手册页提供.

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

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

设置MANSECT环境变量具有相同的效果.我认为有一种方法可以排除第3节,同时保留OSX第3节.

转载注明原文:osx – 当我查找“man”页面时,为什么会显示“User Contributed Perl Documentation” - 代码日志