[tex-live] texdoc doesn't find man pages

[Heiko Oberdiek]

On Thu, Jul 17, 2008 at 05:48:08PM +0200, Manuel Pégourié-Gonnard wrote:

> Heiko Oberdiek scripsit (17.07.2008 07:14)
> 
> > Current behaviour of texdoc
> > ---------------------------
> > Zero documents:
> >   texdoc prints "Sorry, no documentation found for [...]"
> > One document:
> >   texdoc calls the configured viewer.
> > Two and more documents:
> >   texdoc randomly chooses the document (probably first found document).
> > 
> Yes.  By the way, texdoc has got two search modes:  the first is what I
> described above, the second is what the -s option does: matching 'name' as a
> Lua regex against the full paths of files, and diplay files who match and have
> the desired extension.  I just tought it could use this second mode as a
> fallback even in view mode when it finds no results with the first mode.

Good idea.

> Anyway, it would be good to have both a command-line texdoc and a nice GUI
> frontend, since lots of users are afraid of the command line (but needless to
> say here, lots of users prefer the command line too).

Agreed.

> > What about using view mode, if there is only one document and
> > using list mode, if there are two or more found documents?
> > 
> It's a good idea.  But I'm hesitating.  From my own use of texdoc, I'm really
> inclined to prefer the view mode, but maybe I'm biased.

It could be combined with your idea to a new extended view mode:
* Zero documents found --> return result of "texdoc -s"
* One document found   --> view document (traditional view mode)
* More documents found --> return result of "texdoc -l"

The default mode "view", "extended view", ... could be configured
in texmf.cnf.

> Thanks for your remarks,

Thanks for your long informative answer.

Yours sincerely
  Heiko <oberdiek at uni-freiburg.de>