☰

使用 texdoc 时缺少相关文档

tag-icon • tag-icon installing texdoc
使用 texdoc 时缺少相关文档

几周前我偶然发现这texdoc首次使用时出现问题。该问题已解决。

我完全重新安装了 TeXLive 2012，并使用该complete方案确保我也安装了文档。 texdoc -l <packagename>现在工作正常，只是经常无法找到相关文档（例如对于看起来非常重要的软件包tikz，animate），不显示任何内容，或者列出类似但不是“核心”或“主要”软件包的软件包的文档……例如，我得到以下输出：

~> texdoc -l tikz
 1 /usr/local/texlive/2012/texmf-dist/doc/latex/hf-tikz/hf-tikz.pdf
   = Package documentation
 2 /usr/local/texlive/2012/texmf-dist/doc/latex/tikz-3dplot/tikz-3dplot_documentation.pdf
   = Package documentation
 3 /usr/local/texlive/2012/texmf-dist/doc/latex/tikz-cd/tikz-cd-doc.pdf
   = Package documentation
 4 /usr/local/texlive/2012/texmf-dist/doc/latex/tikz-dependency/tikz-dependency-doc.pdf
   = Package documentation
 5 /usr/local/texlive/2012/texmf-dist/doc/latex/tikz-inet/tikz-inet-doc.pdf
   = Package documentation
 6 /usr/local/texlive/2012/texmf-dist/doc/latex/tikz-qtree/tikz-qtree-manual.pdf
   = Package documentation
 7 /usr/local/texlive/2012/texmf-dist/doc/latex/tikz-timing/tikz-timing.pdf
   = Package documentation
 8 /usr/local/texlive/2012/texmf-dist/doc/latex/sa-tikz/sa-tikz-doc.pdf
 9 /usr/local/texlive/2012/texmf-dist/doc/latex/tikz-qtree/README
   = Readme
10 /usr/local/texlive/2012/texmf-dist/doc/latex/sa-tikz/README
   = Readme
11 /usr/local/texlive/2012/texmf-dist/doc/latex/tikz-3dplot/README
   = Readme
12 /usr/local/texlive/2012/texmf-dist/doc/latex/hf-tikz/README
   = Readme
13 /usr/local/texlive/2012/texmf-dist/doc/latex/tikz-inet/README
   = Readme
14 /usr/local/texlive/2012/texmf-dist/doc/latex/tikz-timing/README
   = Readme
15 /usr/local/texlive/2012/texmf-dist/doc/latex/tikz-cd/README
   = Readme
16 /usr/local/texlive/2012/texmf-dist/doc/latex/hf-tikz/README.txt
17 /usr/local/texlive/2012/texmf-dist/doc/latex/tikz-dependency/README
18 /usr/local/texlive/2012/texmf-dist/doc/latex/tikz-dependency/AUTHORS
19 /usr/local/texlive/2012/texmf-dist/doc/latex/tikz-3dplot/CHANGELOG
20 /usr/local/texlive/2012/texmf-dist/doc/latex/tikz-dependency/VERSION
Please enter the number of the file to view, anything else to skip:

有很多有趣的东西，但主要的 PGF/TikZ 手册似乎不在那里。另一个例子是beamer用于创建幻灯片的包：

~> texdoc -l beamer
 1 /usr/local/texlive/2012/texmf-dist/doc/latex/beamer-tut-pt/tutorialbeamer.pdf
   = [pt] 
Please enter the number of the file to view, anything else to skip:

不错的教程，但我不会说葡萄牙语，而这份文档就是用葡萄牙语编写的...:)

另一个例子是命令texdoc -l animate，其输出仅包含波兰语（！）.html 文件。

因为我使用的全部目的texdoc是避免手动在网上搜索 (La)TeX 软件包的文档（可能与我安装的软件包的版本不对应...），我想知道：

重要软件包缺乏适当的文档是技术问题还是政治问题？（例如，软件包开发人员由于许可问题或因为他们想吸引流量到他们的网站而不在 CTAN 上包含文档）还是我（再次）搞砸了并且没有正确安装文档？任何使用 TL2012 的人都可以在自己的系统上运行检查并比较输出吗texdoc？

答案1

这不是一个普遍的问题：texdoc -l tikz使用 TeX Live 2012 或 TeX Live 2013 会出现

 1 /usr/local/texlive/2013/texmf-dist/doc/generic/pgf/pgfmanual.pdf
   = PGF Manual

作为第一个问题。因此，这看起来像是您的安装的一个局部问题。真正可以推荐的只是删除安装并重新安装。

答案2

在我的系统上，Tex Live 2012texdoc -l tikz给出的结果如下：

21 results.  Display them all? (y/N) y
 1 /usr/local/texlive/2012/texmf-dist/doc/generic/pgf/pgfmanual.pdf
   = PGF Manual
...
Please enter the number of the file to view, anything else to skip:

如果您使用 Mac，请尝试 TexShop 并选择“帮助/显示包帮助”，然后在 texdoc 对话框中键入包名称。

相关内容