[texhax] TeX Live documentation

Uwe Lück uwe.lueck at web.de
Sun Mar 3 22:04:27 CET 2013


Before (on texhax), on "missing" TeX Live Documentation, I focussed 
on binaries. I did not mention another point, because it is not so 
clear with the distinction between "using" and "installing" TeX Live, 
and because I had to recall something. That was last year, 
integrating a second texmf tree for material outside CTAN. 
It was for a server, so it was essentially an administrator's issue.

I think I have found the solution today. The TeX Live manual may 
need no improvement here, but it was hard for me, perhaps just 
personally because in the beginning (last year), I did not start 
with the TeX Live documentation, but with the texhash help and 
the TDS specification. So I just spent much time with documentation 
that was not very relevant for my problem.

A general subject with perhaps-incompleteness of documentation 
may be that (especially with complex software) that manuals 
sometimes seem to be little helpful for "impatient" users.
An alternative may be "user-driven documentation" -- an FAQ; 
so structured that the most frequent or urgent questions are 
the most easy to find.

There actually is such an FAQ for TeX Live:

    https://wiki.archlinux.org/index.php/TeX_Live_FAQ

for example "I want to use ConTeXt". Until one has something 
better, one might point there.

That approach may also be helpful if, as Karl tells me off-list, 
TeX Life offers so much that is just too much for the maintainers 
to document it completely. As to binaries (that I focussed on 
before), this even seems to hold for engines and formats -- 
when I compare the TeX Live manual with Arno Trautmann's 
list of binaries.

The user's separate tree may be something very important, 
thinking of the user's favourite shorthands used for most 
documents.

Best,

    Uwe.




More information about the texhax mailing list