Saturday, 8 June 2013

Documentation manager/system for Texlive distribution

Documentation manager/system for Texlive distribution

Recently, when peeking over the shoulder of someone who has years of experience working with TeX, I saw him type something into the terminal that caused a pdf with the documentation for a LaTeX package we were working with to open. I asked if he had a central utility for finding the documentation for a package, his answer was: "Yes, it's called texdoc, look into it." We then kept doing our thing, and since his time for me is limited, I didn't further inquire and figured I'd find out on my own.
And so I tried, but can't seem to get the hang of it. I have a full working installation of TeX Live 2012 set up, and get this output:
$ texdoc
/usr/local/texlive/2012/bin/i386-linux/texdoc:7: module 'texdoc.main' not found:
no field package.preload['texdoc.main']
[kpse lua searcher] file not found: 'texdoc.main'
[kpse C searcher] file not found: 'texdoc.main'
[kpse All-in-one searcher] file not found: 'texdoc'
So apparently something is missing or not configured, as far as I can tell. I made sure that I had also installed the documentation, and tlmgr confirmed this. Since I am pretty new to the TeX world I am voraciously reading documentation on all kinds of things and since it's actually already supposed to be installed alongside the packages on my system, it would be quite neat if I could just summon the documentation like this instead of doing not always trivial searches on the Weeb.
Considering this mentor of mine is already an older gentleman, is this software maybe outdated? Or am I just doing it wrong?

No comments:

Post a Comment