Bug#160680: texdoc doesn't find hyperref manual

["C.M. Connelly" <c@eskimo.com>]

tags 160680 + wontfix
severity 160680 minor
thanks

"AL" == Andre L <andrel@yahoo.com>

    AL> The command "texdoc hyperref" doesn't find the hyperref
    AL> manual.  Instead of
    AL> /usr/share/doc/texmf/latex/hyperref/manual.pdf.gz it
    AL> returns the less useful
    AL> /usr/share/texmf/doc/help/Catalogue/entries/hyperref.html

texdoc is a pretty limited shell script -- it basically runs a
kpsewhich search using the string you give it.  Because it doesn't
use a database to associate the names and paths of actual
documentation files with the things they describe, it's never
going to find a manual with a different name.

Therefore, we generally encourage people to use texdoctk, if
possible (which is a separate package).  Unlike texdoc, texdoctk
uses a database, and also presents a GUI chooser with clearer
categories and descriptions of documents to help you find the
often cryptically named documents.

The downside is that you need to be running X (or similar) to be
able to to use texdoctk.

   CMC

+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
 Man cannot be civilised, or be kept civilised by what he does in his
	    spare time; only by what he does as his work.
			     W.R. Lethaby
+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
  C.M. Connelly               cmc@debian.org                   SHC, DS
+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+