Bug#401903: Integrating texdoc.php into Debian's teTeX

[Frank Küster <frank@debian.org>]

Dear Joao,

I have a question regarding the integration of texdoc.php in the
somewhat special setup of teTeX for Debian, and hope you will be able to
help me.

The difference to a normal teTeX is that the meaning of TEXMFMAIN is
changed.  TEXMFDIST contains what it also contains in teTeX, but it's
called /usr/share/texmf-tetex, whereas TEXMFMAIN (/usr/share/texmf/)
does not only contain things like pool files in web2c/, but also lots of
input and documentation files from other Debian packages that are not
part of teTeX (either not packaged upstream, or separate only in
Debian).

I found I had to change config.php to make it work:

,----
| $texmftrees['fs'] = array( '' => '../../../texmf-tetex/',
| 			   'main' => '../../../texmf',
|                           'local' => '../../../../local/share/texmf/');
| $texmftrees['url'] = array( '' => '../../../texmf-tetex/',
| 			    'main' => '../../../texmf/',
| 			    'local' => '../../../../local/share/texmf/' );
| ### Support for variable names in the *.dat files.
| ### One might argue that several names may be admissible
| ### in each of one or more trees; then values should be arrays
| ### and code will need to be changed with one more loop.
| $texmftrees['datname'] = array( 'local' => 'texdoctk-local.dat',
| 			  '' => 'texdoctk.dat',
| 			  'main' => 'texdoctk.dat' );
`----

I don't understand why I needed to rename 'dist' to '' and '' to main,
but without it it didn't build the menu.

Now the problem is that files in /usr/share/texmf/doc are not found.
The link points to their "supposed" location in
/usr/share/texmf-tetex/doc and is shown in red.  This obviously means
that checklinks doesn't return anything, but I wonder why it doesn't
find the files:  checklinks is supposed to iterate over all trees.

Can you point me to the error, or show me how I can debug this (I have
no experience with php at all, sorry)?  

(If you happen to have a Debian system available, packages from etch,
sid, or backports.org for sarge all show this behavior, although I've
made some further unreleased changes in our repository.  You need
tetex-doc, some apache and libapache2-mod-php[45] installed, plus
tetex-doc-nonfree to actually have one of the "red" documents present,
the ConTeXt documentation.)

Thanks in advance, Frank
-- 
Dr. Frank Küster
Single Molecule Spectroscopy, Protein Folding @ Inst. f. Biochemie, Univ. Zürich
Debian Developer (teTeX/TeXLive)