Bug#400058: texdoctk does not find any documentation

[Ralf Stubner <ralf.stubner@web.de>]

On Thu, Nov 23, 2006 at 18:06 +0100, Braun Gabor wrote:
> Package: tetex-bin
> Version: 3.0-23
> Severity: normal
> 
> *** Please type your report below this line ***
> 
> I start texdoctk.  I select "Fundamentals/general references".  Then I select 
> the first line "User's guide" and click on "View". The following message
> appears: ERROR usrguide.dvi not found cancelling.
> 
> There seems to be nothing special about User's guide, if I select any 
> document in any category, I receive a "not found" error.  (I have not tried 
> them all only some of them randomly.)
> 
> Other facts:
> 
> 1) The documentations are present, e.g. usrguide.dvi is here:
> 
> /usr/share/texmf-tetex/doc/latex/base/usrguide.dvi.gz
> 
> I can view it with "texdoc usruide" (and also other documentation).
> 
> 2) In texdoctk: clicking on settings, the paths in the upcoming window:
> 
> Distribution documentation root path(s):  /usr/share/texmf/doc
> Local documentation root path: /usr/local/share/texmf/doc
> 
> I miss the following from the distribution paths:
> 
> /usr/share/texmf-tetex/doc
> /usr/share/texmf-texlive/doc
> 
> I do not understand why these are missing.
> /usr/share/texmf-tetex/texdoctk/texdocrc says
> 
> # root of doc directory (from $TEXMFMAIN and $TEXMFDIST)
> TEXDOCPATH=doc
> 
> 
> kpsexpand reports
>   $TEXMFMAIN to be /usr/share/texmf
>   $TEXMFDIST to be /usr/share/texmf-{texlive,tetex}

Thanks for the detailed report. This problem is indeed caused by
$TEXMFDIST not being searched. You can test this by starting texdoctk as

env TEXMFDIST=/usr/share/texmf-tetex texdoctk

The problem are the following lines from texdoctk

	$texmfdist=`kpsewhich --expand-path=${qq}\$TEXMFDIST${qq}`;
	chomp $texmfdist;
	$distdocpath=join('/',"$texmfdist",basename($texdocpath,""))
			  if (length $texmfdist);

which cannot deal with the actual output

$ kpsewhich --expand-path="\$TEXMFDIST"
/usr/share/texmf-texlive:/usr/share/texmf-tetex

However, it looks as if there are several places in texdoctk where it is
assumed that TEXMFDIST referes to a single directory only. Hence I can't
offer a patch yet.
 
> BTW, the man page of texdoctk refers to a system wide configuration file
> ($TEXMFMAIN)/texdoctk/texdocrc.defaults
> but this does not exist.  I have $TEXMFMAIN/texdoctk/texdocrc instead.

The source uses "texdocrc" and "texdocrc-win32.defaults". Looks like a
documentation bug to me.
 
> Also, the man page refers to both $HOMETEXMF and $TEXMFHOME.  Is this 
> intentional?

TEXMFHOME used to be called HOMETEXMF. Another documentation bug.

cheerio
ralf