From 5e8cbe719ce8e59ab356ffed269b4c9c3a658f71 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 23 Mar 2007 20:26:25 +0000 Subject: if KPATHSEA_DEBUG is set, assume DVIPSDEBUG too; document git-svn-id: svn://tug.org/texlive/trunk@4080 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/texk/dvipsk/ChangeLog | 3 ++- Build/source/texk/dvipsk/dvips.c | 8 +++++++- Build/source/texk/dvipsk/dvips.texi | 20 +++++++++++++++++++- 3 files changed, 28 insertions(+), 3 deletions(-) (limited to 'Build') 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 + * 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 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 -- cgit v1.2.3