Como faço para instalar manualmente uma página man?

Question

Como eu instalo um arquivo de página man em todo o sistema?

Por exemplo, se eu tiver um arquivo de página man examplecommand.1 , como instalá-lo para que eu possa digitar man examplecommand para visualizá-lo?

    

Answer 1

1. Primeiro, descubra a que seção sua página de manual pertence. Se for um comando, provavelmente pertence à seção 1 . Você pode ler a página do manual para o comando man para ver uma descrição das diferentes seções e seus números correspondentes.

2. Copie sua página do manual para /usr/local/share/man/man1/ (altere 1 para o número da sua seção, se necessário). Você também pode instalá-lo em /usr/share/man/man1/ , mas é uma boa prática usar o diretório local para arquivos instalados sem usar o gerenciador de pacotes APT:

   sudo cp examplecommand.1 /usr/local/share/man/man1/
   

3. Execute o comando mandb . Isso atualizará o banco de dados interno de man :

   sudo mandb
   

4. É isso! Você deve poder ver a página man executando:

   man 1 examplecommand
   

Referências:

• A página de manual do comando man
• A página de manual do comando mandb
• O código fonte em /usr/bin/dh_installman se você pode ler Perl, instalado com o pacote debhelper .

Answer 2

Se você só precisa instalar a página de manual localmente :

Se MANPATH não estiver definido ou incluir um componente vazio (isto é, começar com : , terminar com : ou conter :: ), então <path>/share/man será pesquisado automaticamente por man pages sempre que <path>/bin faz parte de PATH , para todos os valores de <path> .

Isso fornece uma maneira muito simples de adicionar man pages para softwares instalados localmente. Há alguns detalhes em man manpath e /etc/manpath.config , mas não vejo nenhuma menção ao mapeamento genérico de <path>/bin para <path>/share/man .