TeX - LaTeX Stack Exchange is a question and answer site for users of TeX, LaTeX, ConTeXt, and related typesetting systems. It's 100% free, no registration required.

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

While I have the indispensable pgfmanual.pdf located in /usr/share/doc/texmf/pgf/,

texmf/pgf$ pwd
texmf/pgf$ ls

texdoc cannot find it.

~$ texdoc -l pgf
 1 /usr/share/texlive/texmf-dist/doc/latex/pgf-soroban/pgf-soroban-doc.pdf
   = Package documentation
 2 /usr/share/texlive/texmf-dist/doc/latex/pgf-umlsd/pgf-umlsd-demo.pdf
   = Package demo
 3 /usr/share/texlive/texmf-dist/doc/latex/pgf-umlsd/pgf-umlsd-demo2.pdf
   = Package demo (2)
 4 /usr/share/texlive/texmf-dist/doc/latex/pgf-blur/pgf-blur.pdf
 5 /usr/share/texlive/texmf-dist/doc/latex/pgf-soroban/README
   = Readme
 6 /usr/share/texlive/texmf-dist/doc/latex/pgf-blur/README
   = Readme
 7 /usr/share/texlive/texmf-dist/doc/latex/pgf-umlsd/README
Please enter the number of the file to view, anything else to skip: 
~$ texdoc -l tikz
 21 results.  Display them all? (y/N) y
 1 /usr/share/texlive/texmf-dist/doc/latex/tikz-3dplot/tikz-3dplot_documentation.pdf
   = Package documentation
 2 /usr/share/texlive/texmf-dist/doc/latex/tikz-cd/tikz-cd-doc.pdf
   = Package documentation
 3 /usr/share/texlive/texmf-dist/doc/latex/tikz-dependency/tikz-dependency-doc.pdf
   = Package documentation
 4 /usr/share/texlive/texmf-dist/doc/latex/tikz-inet/tikz-inet-doc.pdf
   = Package documentation
 5 /usr/share/texlive/texmf-dist/doc/latex/tikz-qtree/tikz-qtree-manual.pdf
   = Package documentation
 6 /usr/share/texlive/texmf-dist/doc/latex/tikz-timing/tikz-timing.pdf
   = Package documentation
 7 /usr/share/texlive/texmf-dist/doc/latex/sa-tikz/sa-tikz-doc.pdf
 8 /usr/share/texlive/texmf-dist/doc/latex/hf-tikz/hf-tikz.pdf
 9 /usr/share/texlive/texmf-dist/doc/latex/tikz-timing/README
   = Readme
10 /usr/share/texlive/texmf-dist/doc/latex/tikz-cd/README
   = Readme
11 /usr/share/texlive/texmf-dist/doc/latex/tikz-3dplot/README
   = Readme
12 /usr/share/texlive/texmf-dist/doc/latex/tikz-inet/README
   = Readme
13 /usr/share/texlive/texmf-dist/doc/latex/tikz-qtree/README
   = Readme
14 /usr/share/texlive/texmf-dist/doc/latex/hf-tikz/README.txt
15 /usr/share/texlive/texmf-dist/doc/latex/tikz-dependency/README
16 /usr/share/texlive/texmf-dist/doc/latex/sa-tikz/README
17 /usr/share/texlive/texmf-dist/doc/latex/hf-tikz/README
18 /usr/share/texlive/texmf-dist/doc/latex/tikz-bayesnet/README.rst
19 /usr/share/texlive/texmf-dist/doc/latex/tikz-dependency/AUTHORS
20 /usr/share/texlive/texmf-dist/doc/latex/tikz-3dplot/CHANGELOG
21 /usr/share/texlive/texmf-dist/doc/latex/tikz-dependency/VERSION
Please enter the number of the file to view, anything else to skip:         

EDIT per comment:

~$ kpathsea
zsh: command not found: kpathsea
~$ kpsewhich --var-value TEXMF

The whole texlive distribution has been installed through apt-get. The one exception here is the pgfmanual.pdf proper, which I un-archived because texdoc was having trouble reading archived manuals. That said, until I updated to saucy, texdoc pgf worked just fine.

How do I point texdoc in the right direction?

share|improve this question

closed as off-topic by Martin Schröder, Jesse, Benedikt Bauer, Peter Jansson, Svend Tveskæg Jan 7 '14 at 10:44

  • This question does not fall within the scope of TeX, LaTeX or related typesetting systems as defined in the help center.
If this question can be reworded to fit the rules in the help center, please edit the question.

Is /usr/share/doc/texmf/ really on your kpathsea radar? How is TeX Live installed? What does kpsewhich --var-value TEXMF return? (Note, in the directory you mention, I have a .gz version of the manual: pgfmanual.pdf.gz...) – jon Jan 7 '14 at 7:18
edited original post to provide requested information – Mark Kelly Jan 7 '14 at 7:24
kpathsea is not a command (try texdoc kpathsea); but, anyway, it is not searching in the directory you suppose it would. A quick solution would be to do: mkdir ~/texmf/doc/pgf and put it in there. But note that that directory will almost certainly be searched first, which means any subsequent system install of the same file won't be found first -- which is a problem if the subsequent file is newer! – jon Jan 7 '14 at 7:37
I can not reproduce this with a vanilla TL2013 installation. Upgrade. – Martin Schröder Jan 7 '14 at 8:00
This question appears to be off-topic because it is caused by an outdated installation. – Martin Schröder Jan 7 '14 at 8:01
up vote 3 down vote accepted

This is a bug in the Debian/Ubuntu package. The Debian TeX policy clearly mandates that documentation (or a symlink to it) should be put in a place searched by texdoc, which is not done here. You should report that bug in the Debian and/or Ubuntu bug tracking system.

While waiting for the bug to be fixed, doing a symlink in a place searched by texdoc is a good workaround indeed.

share|improve this answer

Per @jon's input, there is a simple workaround to this problem.

ln -s /usr/share/doc/texmf/pgf/pgfmanual.pdf ~/texmf/doc/pgf/pgfmanual.pdf

texdoc pgf will now work as intended.

share|improve this answer
I'm curious: do you mean ~/texmf or ~/texdoc? – jon Jan 7 '14 at 14:29
As there are a few other packages with the same problem, I would recommend ln -s /usr/share/doc/texmf ~/texmf/doc – Philipp Wendler Feb 17 at 16:26

Not the answer you're looking for? Browse other questions tagged or ask your own question.