if KPATHSEA_DEBUG is set, assume DVIPSDEBUG too; document

git-svn-id: svn://tug.org/texlive/trunk@4080 c570f23f-e606-0410-a88d-b1316a301751

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