'man' páginas para idiomas diferentes de C (por exemplo, python, R, javascript, etc)?

1

man páginas são um recurso fenomenal durante a programação em C no Linux. Ao olhar para o código de outra pessoa, se você vir algo estranho, pode pesquisar imediatamente em outro terminal com

$ man 3 fileno

ou qualquer que seja a sintaxe que você não entende é.

Existe uma maneira padrão de obter páginas " man " para outras linguagens de programação, como Python, R, Javascript ou qualquer outra coisa? Na verdade, ele não precisa ser man , mas algum programa que eu posso chamar rapidamente para pesquisar algo como

$ man-python numpy.random.rand

em vez de ter que usar o Google e usar a documentação em HTML. A mesma pergunta é válida para outras linguagens de programação.

    
por user1717828 11.10.2015 / 16:59

1 resposta

2

Não confiável (ou portável); no OpenBSD man -s ... permite pesquisar por seção, embora fora do sistema ou coisas relacionadas a C, existem apenas seções para Fortran, Perl e Tcl / Tk. Ainda assim, uma pesquisa de strftime na seção Perl não encontrará nada, já que essa chamada está oculta dentro de POSIX (ou vários outros módulos) e não aparecerá em nenhum lugar em que uma pesquisa man -k possa encontrá-la.

% man -k -s 3p strftime
% man -k -s 3p POSIX   
locale(3p) - Perl pragma to use or avoid POSIX locales for built-in operations
POSIX(3p) - Perl interface to IEEE Std 1003.1
% 

Enquanto isso, man no Mac OS X carece de -s , e a qualidade e quantidade das páginas man é bastante fraca (ausente ou um roubo aleatório de alguma safra de (Free | Open | Net) BSD) . O Linux também tem um registro duvidoso de man page man maintenance ("veja o info page, lol!", Etc).

Em teoria, as páginas de manual poderiam ter sido um recurso bem mantido e, em teoria, poderia haver seções pesquisáveis para R ou outras línguas, mas geralmente não é o que acontecia.

    
por 11.10.2015 / 18:03