PATHvariable tells the shell where to find those files. Modern TeX implementations come with a bunch of search paths built in to them. In most circumstances these paths are adequate, but one sometimes needs to extend them to pick up files in strange places: for example, we may wish to try a new bundle of packages before installing them ‘properly’. To do this, we need to change the relevant path as TeX perceives it. However, we don’t want to throw away TeX’s built-in path (all of a sudden, TeX won’t know how to deal with all sorts of things). To extend a TeX path, we define an operating system environment variable in ‘path format’, but leaving a gap which TeX will fill with its built-in value for the path. The commonest case is that we want to place our extension in front of the path, so that our new things will be chosen in preference, so we leave our ‘gap to be filled’ at the end of the environment variable. The syntax is simple (though it depends which shell you’re actually using): so on a Unix-like system, using the bash shell, the job might be done like:
while in a Windows system, within a MSDOS window, it would be:export TEXINPUTS=/tmp:
In either case, we’re asking TeX to load files from the root disc temporary files directory; in the Unix case, the “empty slot” is designated by putting the path separator ‘set TEXINPUTS=C:/temp;
:’ on its own at the end of the line, while in the Windows case, the technique is the same, but the path separator is ‘
;’. Note that in either sort of system, the change will only affect instances of TeX that are started from the shell where the environment variable was set. If you run TeX from another window, it will use the original input path. To make a change of input path that will “stick” for all windows, set the environment variable in your login script or profile (or whatever) in a Unix system and log out and in again, or in autoexec.bat in a Windows system, and reboot the system. While all of the above has talked about where TeX finds its macro files, it’s applicable to pretty much any sort of file any TeX-related program reads — there are lots of these paths, and of their corresponding environment variables. In a web2c-based system, the copious annotations in the texmf.cnf system configuration file help you to learn which path names correspond to which type of file.
Go to previous question, or next question
Go to FAQ home.
URL for this question: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tempinst
Comments, suggestions, or error reports? - see “how to improve the FAQ”.
This is FAQ version 3.26, released on 2013-02-25.