Como posso visualizar as páginas de manual dos aplicativos instalados por meio de snaps?

Eu tenho uma nova instalação do Ubuntu 16.04 LTS e tentei instalar alguns aplicativos usando os novos pacotes de snap. A instalação desses pacotes é fácil, mas quando tento fazer, man <package>não consigo abrir a página do manual. Por exemplo:

$ man tmux  
No manual entry for tmux  
See 'man 7 undocumented' for help when manual pages are not available.

O whereiscomando me fornece esta saída:

$ whereis tmux  
tmux: /snap/bin/tmux

Mas a verdade é que o arquivo da página do manual existe:

$ ls -l $PWD/*  
-rw-r--r-- 1 root root 100394 Abr 20 06:46 /snap/tmux/current/share/man/man1/tmux.1

Como posso fazer isso funcionar? Existe algum problema com o gerenciamento de pacotes de snap?

package-management manpage snap

— Ruben Pedro
fonte

Uma solução 'band-aid' é executar o seguinte na linha de comando:

export MANPATH=":/snap/tmux/current/share/man"

e o comando man tmuxfuncionará bem como todas as suas páginas de manual pré-existentes. Lembre-se de que o Ubuntu normalmente não usa $MANPATHe as páginas de manual padrão PATH podem ser vistas da seguinte maneira:

andrew@athens:~$ man -w
/usr/local/man:/usr/local/share/man:/usr/share/man

Depois de executar a solução 'band-aid' sugerida acima, você deverá ver:

andrew@athens:~$ man -w
/usr/local/man:/usr/local/share/man:/usr/share/man:/snap/tmux/current/share/man

Essa configuração também pode ser colocada ~/.bashrcpara permanência, lembrando que, após colocá-la, efetue logout e, em seguida, faça login novamente ou simplesmente execute:source ~/.bashrc

Não é muito satisfatório, devo dizer, especialmente se cada pacote tiver uma página de manual em um local diferente. Esperemos que, à medida que os padrões se solidifiquem, isso seja menos problemático ...

Referências:

AskUbuntu: Como descobrir onde $ MANPATH está definido? Uma excelente pergunta e resposta do AskUbuntu que descreve o que é o MANPATH e como manipulá-lo.
As páginas de manual instaladas rapidamente não são acessíveis através do bug man Launchpad, onde é discutido o problema de visualizar as páginas de manual do snap.
Suporte para páginas de manual Discussões adicionais desta vez nos fóruns do snapcraft.

— andrew.46
fonte

Obrigado pela sua resposta abrangente. Surpreende-me como uma tecnologia anteriormente amadurecida no Ubuntu Core chega a um LTS com essa falha em mente, quando a proposta desses snaps é ignorar as limitações de algumas deb (por exemplo, ter uma versão atualizada de um aplicativo / ferramenta, independentemente das dependências presentes no sistema básico). De fato, cada pacote de snap sofre com esse problema e fica incontrolável cuidar de cada um. A Canonical deve resolver esse problema.

— Ruben Pedro

Há um caso para um relatório de bug no Launchpad para esse problema, principalmente se você pode citar exemplos de vários pacotes. Por favor 'aceitar' a minha resposta se ele tem sido útil btw ...

— andrew.46

Sim, você está certo. Aqui está o link para a questão: Snappy instalado manpages não são inacessíveis através do homem

— Ruben Pedro

Aqui está da perspectiva do desenvolvedor: forum.snapcraft.io/t/support-for-man-pages/2299/7

— user535733