summaryrefslogtreecommitdiff
path: root/Build
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2007-03-23 20:26:25 +0000
committerKarl Berry <karl@freefriends.org>2007-03-23 20:26:25 +0000
commit5e8cbe719ce8e59ab356ffed269b4c9c3a658f71 (patch)
tree3fbaacba0ed973b58856726cf76450090f1c9f26 /Build
parentf0c9e514f6a42d6df94a4d458f2ee97f355f1822 (diff)
if KPATHSEA_DEBUG is set, assume DVIPSDEBUG too; document
git-svn-id: svn://tug.org/texlive/trunk@4080 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build')
-rw-r--r--Build/source/texk/dvipsk/ChangeLog3
-rw-r--r--Build/source/texk/dvipsk/dvips.c8
-rw-r--r--Build/source/texk/dvipsk/dvips.texi20
3 files changed, 28 insertions, 3 deletions
diff --git a/Build/source/texk/dvipsk/ChangeLog b/Build/source/texk/dvipsk/ChangeLog
index eaf47cea1bb..a9eb758d284 100644
--- a/Build/source/texk/dvipsk/ChangeLog
+++ b/Build/source/texk/dvipsk/ChangeLog
@@ -1,7 +1,8 @@
2007-03-23 Karl Berry <karl@tug.org>
+ * dvips.texi: document it.
* dvips.c, loadfont.c, resident.c: also report map files
- and config files, if the envvar DVIPS_DEBUG is set. From Akira.
+ and config files, if the envvar DVIPSDEBUG is set. From Akira.
2007-03-20 Karl Berry <karl@tug.org>
diff --git a/Build/source/texk/dvipsk/dvips.c b/Build/source/texk/dvipsk/dvips.c
index 0a29f382efd..11d5a844a9d 100644
--- a/Build/source/texk/dvipsk/dvips.c
+++ b/Build/source/texk/dvipsk/dvips.c
@@ -633,10 +633,16 @@ Primary author of Dvips: T. Rokicki; -k maintainer: T. Kacvinsky/ S. Rahtz.");
#endif
dvips_debug_flag = 0 ;
{ /* for compilers incompatible with c99 */
- char *s = (char *)getenv ("DVIPS_DEBUG") ;
+ char *s = (char *)getenv ("DVIPSDEBUG") ;
if (s) {
dvips_debug_flag = 1 ;
free (s) ;
+ } else {
+ s = (char *) getenv ("KPATHSEA_DEBUG") ;
+ if (s) {
+ dvips_debug_flag = 1 ;
+ free (s) ;
+ }
}
}
initialize() ;
diff --git a/Build/source/texk/dvipsk/dvips.texi b/Build/source/texk/dvipsk/dvips.texi
index 661775c1254..14b7dfba243 100644
--- a/Build/source/texk/dvipsk/dvips.texi
+++ b/Build/source/texk/dvipsk/dvips.texi
@@ -3,7 +3,7 @@
@settitle Dvips: A DVI-to-PostScript translator
@set version 5.96
-@set month-year January 2007
+@set month-year March 2007
@copying
This manual documents Dvips version @value{version}
@@ -354,6 +354,11 @@ yourself in such a situation.
For details on effective bug reporting, common installation problems,
and @code{mktexpk} problems, @pxref{Bugs,,, kpathsea, Kpathsea}.
+A good first debugging operation is to set the environment variable
+@env{DVIPSDEBUG}, which will display any configuration and map files
+read by Dvips. This way you can be sure it's finding the files and
+settings you expect.
+
@menu
* Debug options:: Getting diagnostics.
* No output:: No output at all.
@@ -379,6 +384,9 @@ track all classes, you can use @code{-1}. Another useful value is
@code{3650}, which tracks everything having to do with file searching
and opening.
+You can also set the environment variable @env{KPATHSEA_DEBUG} to any
+of these values.
+
Some of these debugging options are actually provided by Kpathsea
(@pxref{Debugging, , , kpathsea, Kpathsea}).
@@ -1190,6 +1198,16 @@ Kpathsea-using programs. Only the environment variables specific to
Dvips are mentioned here.
@vtable @code
+@item DVIPSDEBUG
+@vindex KPATHSEA_DEBUG
+Write the absolute path names of any configuration or map files to
+standard output, for debugging. This isn't done by default because
+these files are read even before the banner is printed. For
+voluminous additional debugging, set the environment variable
+@env{KPATHSEA_DEBUG} to @samp{-1}
+(@pxref{Debugging,,,kpathsea,Kpathsea}). (If @env{KPATHSEA_DEBUG} is
+set to any value, it automatically turns on @env{DVIPSDEBUG}.)
+
@item DVIPSFONTS
Default path to search for all fonts. Overrides all the font path
config file options and other environment variables (@pxref{Supported