為什麼當我查找“手冊”頁時會出現“使用者貢獻的 Perl 文件”

當我

man -f <some string>

除了預期的 Unix 手冊頁之外，我還得到了一堆看起來很奇怪的條目，它們都有標題“使用者貢獻的 Perl 文件”。例如

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 --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 模組的手冊頁在 section 中3pm。您可以通過將-S選項傳遞給 man 並指定不包括 3 的值來跳過整個第 3 節（任何語言的庫函式），例如

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

設置MANSECT環境變數具有相同的效果。我認為沒有辦法在保留 OSX 上的第 3 節的同時排除第 3 節。

引用自：https://unix.stackexchange.com/questions/63613