documentation de page de manuel zsh manquante dans les packages?

20

J'ai un xubuntu 13.10 x64 nouvellement installé. J'ai décidé d'installer zsh via synaptic et d'en faire mon shell par défaut. La version de zsh installée est: zsh 5.0.2(x86_64-pc-linux-gnu).

L'installé zshsemble correct, mais il ne semble pas y avoir de documentation pour l'homme zsh. Entrer dans la commande man zshme donne ceci:No manual entry for zsh.

J'ai également installé à partir de synaptic, à part zsh lui-même, zsh-lovers, zsh-doc, zsh-dbg. Qu'est-ce que j'ai manqué dans mon zshinstallation pour me retrouver zshsans documentation man?

Max Popp
la source

Réponses:

13

Malheureusement, il s'agit d'un bug affectant Ubuntu 13.10 et 14.04:

Bogue n ° 1242108: toutes les pages de manuel zsh sont manquantes

Il semble que la seule chose que nous puissions faire pour le moment est d'obtenir les pages de manuel de la source. Obtenez la version appropriée du code source auprès de sourceforge (pour Ubuntu 14.04 vous avez besoin de la version 5.0.2, sinon vérifiez avec zsh --version) puis extrayez-les et copiez-les en place avec:

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
la source
@Volker En fait, je pense que vous obtiendrez la documentation de la dernière version. Avec Ubuntu 14.04, j'ai la version 5.0.2 de zsh (run zsh --version), la documentation de cette version est ici .
dshepherd
@dshepherd Oh, vous avez raison - je n'ai pas remarqué que vous ne voudriez pas la dernière dans ce cas. Je vais retirer ça.
Volker Siegel
En fait, je me trompais légèrement aussi, vous avez besoin du zsh complet, pas seulement de la documentation. Pour une raison quelconque, les pages de manuel ne sont pas dans le fichier doc tar! Le lien correct est ici .
dshepherd
J'ai modifié la réponse pour inclure le lien correct.
dshepherd
6

Jusqu'à ce que ce bogue soit corrigé pour que le package contienne automatiquement les pages de manuel, vous pouvez utiliser

sudo apt-get install zsh/trusty-backports

pour installer la version zsh depuis Ubuntu Backports .

elmicha
la source
6

Mise à jour: homme zsh de retour!

Les pages de manuel de zshsont à nouveau disponibles dans les packages d'Ubuntu.
Cela inclut l'aide pour les commandes intégrées *.

Sous Utopic, ils devraient être juste là maintenant; Essayez man zshallde confirmer.

En regardant les commentaires de bogues, le correctif ne sera malheureusement pas disponible pour Trusty.
Du moins pas dans le référentiel standard;

Mais il existe une meilleure solution de contournement maintenant:

Heureusement, Rami Lehti a fait un "backport" du correctif pour Ubuntu 14.04 Trusty, et fournit un PPA avec:

ppa: ramilehti / ppa - notez qu'il ne contient que ce seul paquet, donc il ne mettra pas à jour les autres.

Il y a quelques conseils à lire avant d'utiliser les PPA - voir la page PPA.


(*) L'aide pour les commandes intégrées est affichée par

$ run-help printf

$ printf<Alt-h>



Vous trouverez ci-dessous les astuces pour contourner le problème avant la mise à jour:

Utilisation

pinfo zsh

ou

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

ou voir ci-dessous:

Vous n'avez rien manqué - c'est un bug ; Les pages de manuel zsh sont en effet manquantes, voir bogue n ° 1242108: toutes les pages de manuel zsh sont manquantes .

Solutions de contournement:

  • une documentation PDF locale peut être trouvée dans /usr/share/doc/zsh/zsh.pdfle paquet zsh-doc, qui peut avoir besoin d'être installée par apt-get install zsh-doc.

  • En ligne , la documentation actuelle se trouve dans le manuel ZSH en HTML.

  • Les pages d'informations GNU peuvent être lues par la commande info zshou pinfo zshoukonqueror info:zsh

Volker Siegel
la source
1

Certains projets ont également des pages de manuel (man) comme pages d'informations. Mais certains n'ont que des pages d'informations. Alors donne cette commande

info zsh 

et bonne lecture

Pour savoir quelles informations et comment naviguer

info info

J'ai également vu qu'un .pdf est disponible à l'intérieur du /usr/share/doc/zsh/chemin. Si c'est plus facile à lire, essayez-le

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

evince est une visionneuse PDF préinstallée dans la plupart des versions d'Ubuntu.

NickTux
la source
Le paquet zsh-doc contient zsh.pdf
Volker Siegel
-1

Vous voudrez peut-être essayer la dernière installation de Zsh à partir de http://www.linuxfromscratch.org/blfs/view/svn/postlfs/zsh.html Ceci est 5.0.5 répertorié comme une version stable de nombreuses améliorations, mais surtout de la documentation et les pages de manuel sont disponibles et fonctionnent.

Je viens de terminer mon installation. Il y aura deux fichiers tar, obtenez les deux. Le fichier INSTALL contenait toutes les informations nécessaires pour terminer l'installation des documents et des manuels, ainsi que des instructions sur la façon d'installer la version texi et il est livré avec le PDF que vous avez référencé zsh.pdf.

J'espère que cela aide quelqu'un. J'ai été misérable d'avoir obtenu toute l'aide pour les recherches en ligne.

Bonne chance!

RCF
la source