软件包中缺少 zsh 手册页文档？

问题描述

我有一个新安装的 xubuntu 13.10 x64。我决定通过 synaptic 安装 zsh 并将其设为我的默认 shell。安装的zsh的版本是：zsh 5.0.2 (x86_64-pc-linux-gnu)。

安装的 zsh 看起来不错，但似乎没有 zsh 的 man 文档。输入命令 man zsh 给我这个：No manual entry for zsh.

除了 zsh 本身，我还从突触安装了 zsh-lovers、zsh-doc、zsh-dbg。我在我的 zsh 安装中错过了什么，最终得到 zsh 而没有 man 文档？

不幸的是，这是一个影响 Ubuntu 13.10 和 14.04 的错误：

看起来我们现在唯一能做的就是从源代码中获取手册页。从 sourceforge 获取适当版本的源代码(对于 Ubuntu 14.04，您需要版本 5.0.2，否则使用 zsh --version 进行检查)，然后将它们提取并复制到位：

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/

在修复此错误以使软件包自动包含手册页之前，您可以使用

sudo apt-get install zsh/trusty-backports

从 Ubuntu Backports 安装 zsh 版本。

zsh 的手册页在 Ubuntu 的软件包中再次可用。\n这包括内置命令的帮助*。

在 Utopic 下，它们现在应该就在那里；尝试 man zshall 确认。

查看错误评论，遗憾的是，Trusty 无法使用该修复程序。\n至少在标准存储库中没有；

但是现在有一个更好的解决方法：

幸运的是，Rami Lehti 对 Ubuntu 14.04 Trusty 做了一个 “backport” 的修复，并提供了一个 PPA：

ppa:ramilehti/ppa – 注意它只包含这个包，所以它不会更新其他包。

在使用 PPA 之前需要阅读一些提示 – 请参阅 PPA 页面。

(*) 内置命令的帮助显示为

$ run-help printf

$ printf<Alt-h>

您可以在下面找到有关如何在更新前解决该问题的提示：

利用

pinfo zsh

或者

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

或见下文：

你没有错过任何东西——这是一个错误； zsh 手册页确实丢失了，请参阅 \n Bug #1242108: all zsh manpages are missing 。

解决方法：

本地 PDF 文档可以在 zsh-doc 包中的 /usr/share/doc/zsh/zsh.pdf 中找到，可能需要由 apt-get install zsh-doc 安装。
在线，当前文档可以在 HTML 中的 The ZSH Manual 中找到。
GNU 信息页面可以通过命令 info zsh 或 pinfo zsh 或 konqueror info:zsh 读取