summaryrefslogtreecommitdiff
path: root/Build/source/texk/kpathsea/texmf.cnf
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/texk/kpathsea/texmf.cnf')
-rw-r--r--Build/source/texk/kpathsea/texmf.cnf12
1 files changed, 11 insertions, 1 deletions
diff --git a/Build/source/texk/kpathsea/texmf.cnf b/Build/source/texk/kpathsea/texmf.cnf
index 21b0af293c3..4bc73d6bcf8 100644
--- a/Build/source/texk/kpathsea/texmf.cnf
+++ b/Build/source/texk/kpathsea/texmf.cnf
@@ -688,8 +688,18 @@ TEXMF_RESTRICTED_SCRIPTS = \
openin_any = a
openout_any = p
-% Write .log/.dvi/.aux/etc. files here, if the current directory is unwritable.
+% Write .log/.dvi/.aux/etc. files here, if they can't be written in the
+% current directory.
+%
+% Best to use this only when a particular job requires it, not set
+% globally in a configuration file or the environment.
%TEXMFOUTPUT = /tmp
+%
+% A related environment variable is TEXMF_OUTPUT_DIRECTORY. It
+% overrides the current directory for all output files in TeX and the other
+% engines. It cannot be set in a configuration file. And it's even more
+% important to use it only temporarily, when required, to avoid massive
+% confusion about where the output files are ending up.
% If a dynamic file creation fails, log the command to this file, in
% either the current directory or TEXMFOUTPUT. Set to the