documentação da página de manual do zsh ausente nos pacotes?

20

Eu tenho um xubuntu 13.10 x64 recém-instalado. Decidi instalar o zsh via synaptic e torná-lo meu shell padrão. A versão do zsh instalada é: zsh 5.0.2(x86_64-pc-linux-gnu).

O instalado zshparece ok, mas parece não haver documentação para o homem zsh. Inserir o comando man zshme dá o seguinte:No manual entry for zsh.

Também instalei a partir do synaptic, além do próprio zsh, zsh-lovers, zsh-doc, zsh-dbg. O que eu perdi na minha zshinstalação para terminar zshcom nenhuma documentação de homem?

Max Popp
fonte

Respostas:

13

Infelizmente, este é um bug que afeta o Ubuntu 13.10 e 14.04:

Bug # 1242108: todas as páginas de manual do zsh estão ausentes

Parece que a única coisa que podemos fazer sobre isso agora é obter as páginas de manual da fonte. Obtenha a versão apropriada do código fonte no sourceforge (para o Ubuntu 14.04 você precisa da versão 5.0.2, caso contrário, verifique usando zsh --version), extraia e copie-o no lugar com:

tar xvf zsh-5.0.2.tar.bz2 zsh-5.0.2/Doc/
sudo cp zsh-5.0.2/Doc/*.1 /usr/share/man/man1/
Vince
fonte
@ Volker Na verdade, acho que você receberá a documentação para a versão mais recente. No Ubuntu 14.04, tenho a versão 5.0.2 do zsh (run zsh --version), a documentação para essa versão está aqui .
Dshepherd
@dshepherd Oh, você está certo - eu não percebi que você não gostaria das últimas novidades neste caso. Eu removo isso.
Volker Siegel
Na verdade, eu também estava um pouco errado, você precisa do zsh completo, não apenas da documentação. Por alguma razão, as páginas de manual não estão no arquivo doc tar! O link correto está aqui .
Dshepherd
Editei a resposta para incluir o link correto.
Dshepherd
6

Até que esse bug seja corrigido para que o pacote contenha automaticamente as páginas de manual, você pode usar

sudo apt-get install zsh/trusty-backports

instalar a versão zsh do Ubuntu Backports .

elmicha
fonte
6

Atualização: man zsh back!

As páginas de manual do zshestão disponíveis novamente nos pacotes do Ubuntu.
Isso inclui a ajuda para comandos internos *.

Sob Utopic, eles deveriam estar lá agora; Tente man zshallconfirmar.

Analisando os comentários dos erros, a correção, infelizmente, não estará disponível para o Trusty.
Pelo menos não no repositório padrão;

Mas há uma solução melhor agora:

Felizmente, Rami Lehti fez um "backport" da correção para o Ubuntu 14.04 Trusty e fornece um PPA com ele:

ppa: ramilehti / ppa - observe que ele contém apenas este pacote, portanto não atualiza outros.

Existem algumas dicas para ler antes de usar PPAs - consulte a página PPA.


(*) A ajuda para comandos internos é mostrada por

$ run-help printf

$ printf<Alt-h>



Abaixo, você encontra as dicas sobre como solucionar o problema antes da atualização:

Usar

pinfo zsh

ou

xdg-open /usr/share/doc/zsh/zsh.pdf

ou veja abaixo:

Você não perdeu nada - é um bug ; As páginas de manual do zsh estão ausentes, consulte o Bug # 1242108: todas as páginas de manual do zsh estão ausentes .

Soluções alternativas:

  • uma documentação em PDF local pode ser encontrada no /usr/share/doc/zsh/zsh.pdfpacote zsh-doc, que pode precisar ser instalado por apt-get install zsh-doc.

  • Online , a documentação atual pode ser encontrada no Manual do ZSH em HTML.

  • As páginas de informações do GNU podem ser lidas pelo comando info zshou pinfo zshoukonqueror info:zsh

Volker Siegel
fonte
1

Alguns projetos também têm páginas de manual (man) como páginas de informações. Mas alguns têm apenas páginas de informações. Então dê este comando

info zsh 

e tenha uma boa leitura

Para o que é informação e como navegar

info info

Também vi que um arquivo .pdf está disponível dentro do /usr/share/doc/zsh/caminho. Se for mais fácil de ler, tente

evince /usr/share/doc/zsh/zsh.pdf

O evince é um visualizador de pdf pré-instalado na maioria das versões do Ubuntu.

NickTux
fonte
Pacote zsh-doc contém zsh.pdf
Volker Siegel
-1

Você pode tentar a instalação mais recente do Zsh em http://www.linuxfromscratch.org/blfs/view/svn/postlfs/zsh.html Este é o 5.0.5 listado como uma versão estável, com muitas melhorias, mas acima de tudo, com os documentos. e páginas de manual estão disponíveis e funcionam.

Acabei de concluir minha instalação. Haverá dois arquivos tar, pegue os dois. O arquivo INSTALL tinha todas as informações necessárias para concluir a instalação dos documentos e manuais, além de instruções sobre como instalar a versão texi e vem com o PDF que você referenciou zsh.pdf.

Espero que isso ajude alguém. Sinto-me infeliz por ter obtido toda a ajuda com pesquisas online.

Boa sorte!

RCF
fonte