With my current teTeX system when I try
texdoc pdftex
the result is to open the TeX Catalogue entry for pdftex with Netscape.
But there are some files on my system in the texmf/doc/pdftex tree that
are probably more useful for the users, which are not found only because
the file names are not an exact match for "pdftex":
.../texmf/doc/pdftex/base:
example.tex
image.png
pdfTeX-FAQ.pdf
pdftexman.pdf
README
And similarly for "texdoc omega": It opens the TeX Catalogue entry for
omega, without telling me that these files exist:
.../texmf/doc/omega/base:
omega-manual.dvi
omega-manual.pdf
And for etex:
.../texmf/doc/etex/base:
etex-man.dvi
etex-man.pdf
So one possible solution would be to add some lines to texmf/aliases:
pdftex.pdf pdftexman.pdf
omega.pdf omega-manual.pdf
etex.pdf etex-man.pdf
But when someone begins looking for documentation about pdftex, maybe
they would like to know first of all that there are four or five files
that might contain the desired information.
So I suggest that for "major" packages having more than one piece of
relevant documentation, it would be good to present some sort of
directory listing or menu. Suppose that I wrote "texdoc pdftex", how
about showing something like:
Multiple documentation files found in
.../texmf/doc/pdftex/base/
Choose one of the following commands to view a particular file:
1. more example.tex
2. acroread pdfTeX-FAQ.pdf
3. acroread pdftexman.pdf
4. more README
One other not-so-easy question: What to do about
texdoc pdfetex
texdoc pdflatex
texdoc pdfelatex
texdoc lambda (omega+latex)
?
