Por que “Documentação de Perl com contribuição do usuário” aparece quando procuro por páginas 'man'?

Question

Quando eu

man -f <some string>

além das páginas de manual esperadas do Unix, recebo um monte de entradas estranhas que têm o cabeçalho "User Peruted Perl Documentation". Por exemplo

man -f ip

além de coisas como

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

também lista coisas como

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

, todos eles identificados como "Documentação do Perl com contribuição do usuário".

Meu caminho 'man' (de man --path ), no OS X 10.8.2 é

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

que é o mesmo de outras máquinas que não mostram essas páginas adicionais.

De onde eles vêm? Posso limitar meus resultados apenas a páginas de shell do Unix por padrão?

    

Answer 1

A Perl incentiva os autores de bibliotecas a incluírem documentação no formato pod em cada arquivo de origem. Esta documentação pode ser traduzida automaticamente para outros formatos, incluindo man pages, e muitos sistemas fornecem a documentação dos módulos Perl instalados como páginas man.

As páginas do manual dos módulos Perl estão na seção 3pm . Você pode pular toda a seção 3 (funções de biblioteca de qualquer idioma) passando a opção -S para man e especificando um valor que não inclui 3, por exemplo

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

Definir a variável de ambiente MANSECT tem o mesmo efeito. Eu não acho que haja uma maneira de excluir a seção 3, mantendo a seção 3 no OSX.

    

Answer 2

Essas são manpages para módulos Perl (distribuição livre: a 3pm é a seção 3 (funções da biblioteca), * P * erl * M * odule), a maioria das quais é contribuição do usuário para o Perl (veja CPAN , juntamente com sua documentação.