Installing files “where (La)TeX can find them”

In the past, package documentation used always to tell you to put your files “where LaTeX can find them”; this was always unhelpful — if you knew where that was, you didn’t need telling, but if you didn’t know, you were completely stuck.

It was from this issue that the whole idea of the TDS sprang; “where to put” questions now come down to “where’s the TDS tree?”.

We therefore answer the question by considering:

• what tree to use, and
• where in the tree to put the files.

Once we know the answer to both questions, and we’ve created any directories that are needed, we simply copy files to their rightful location.

This has done what the old requirement specified: LaTeX (or whatever) can (in principle) find the files. However, in order that the software will find the files, we need to update an index file.

On a MiKTeX system, open the window Start-> All Programs-> MiKTeX <version>-> Settings, and click on Refresh FNDB. The job may also be done in a command window, using the command:

initexmf --update-fndb

The MiKTeX documentation gives further details about initexmf.

On a teTeX or TeX Live-based system, use the command texhash (or if that’s not available, mktexlsr — they ought to be different names for the same program).

Having done all this, the new package will be available for use.

This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=inst-wlcf