update doc for debug options

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

3 files changed, 98 insertions, 104 deletions

diff --git a/Build/source/texk/dvipsk/ChangeLog b/Build/source/texk/dvipsk/ChangeLog
index 83b30f9f546..407892b0fea 100644
--- a/Build/source/texk/dvipsk/ChangeLog
+++ b/Build/source/texk/dvipsk/ChangeLog
@@ -1,3 +1,7 @@
+2010-01-02  Karl Berry  <karl@tug.org>
+
+	* dvips.texi (Debug options): update 
+
 2009-12-24  Karl Berry  <karl@tug.org>
 
 	* INSTALLATION: rm stale file.
diff --git a/Build/source/texk/dvipsk/dvips.info b/Build/source/texk/dvipsk/dvips.info
index 1dc8348844f..680e1dad9a8 100644
--- a/Build/source/texk/dvipsk/dvips.info
+++ b/Build/source/texk/dvipsk/dvips.info
@@ -336,18 +336,16 @@ File: dvips.info,  Node: Debug options,  Next: No output,  Up: Diagnosing proble
 The `-d' flag to Dvips helps in tracking down certain errors.  The
 parameter to this flag is an integer that tells what errors are
 currently being tracked.  To track a certain class of debug messages,
-simply provide the appropriate number given below; if you wish to track
+specify the appropriate number given below; if you wish to track
 multiple classes, sum the numbers of the classes you wish to track.  To
-track all classes, you can use `-1'.  Another useful value is `3650',
-which tracks everything having to do with file searching and opening.
+track all classes, you can use `-1'.
 
-   You can also set the environment variable `KPATHSEA_DEBUG' to any of
-these values.
-
-   Some of these debugging options are actually provided by Kpathsea
-(*note Debugging: (kpathsea)Debugging.).
+   You can also set the environment variable `KPATHSEA_DEBUG' instead
+of using `-d'.  Some of these debugging options are actually provided
+by Kpathsea (*note Debugging: (kpathsea)Debugging.).
 
    The classes are:
+
 1
      specials
 
@@ -370,24 +368,21 @@ these values.
      files
 
 128
-     config files
+     (omitted)
 
 256
-     Partial Type 1 font encoding vectors
+     config files
 
 512
-     Partial Type 1 subr calls
-
-1024
      Kpathsea `stat' calls
 
-2048
+1024
      Kpathsea hash table lookups
 
-4096
+2048
      Kpathsea path element expansion
 
-8192
+4096
      Kpathsea path searches
 
 
@@ -4709,74 +4704,74 @@ Node: PostScript font installation8317
 Node: Ghostscript installation11191
 Node: Diagnosing problems12288
 Node: Debug options13383
-Node: No output14586
-Node: Small or inverted16054
-Node: Printer errors16773
-Node: Long documents fail18105
-Node: Including graphics fails18446
-Node: Invoking Dvips19684
-Node: Basic usage20275
-Node: Command-line options21259
-Node: Option summary21708
-Node: Option details23870
-Node: Environment variables42874
-Node: Config files45833
-Node: Configuration file searching46516
-Node: Configuration file commands49816
-Node: Paper size and landscape56929
-Node: papersize special58527
-Node: Config file paper sizes59936
-Node: Paper trays64091
-Node: Interaction with PostScript65425
-Node: PostScript figures66078
-Node: Bounding box66804
-Node: \includegraphics70175
-Node: EPSF macros72466
-Node: EPSF scaling74436
-Node: EPSF clipping77006
-Node: psfile special77648
-Node: Dynamic creation of graphics80041
-Node: Fonts in figures81359
-Node: Header files83019
-Node: Including headers from TeX84225
-Node: Including headers from the command line86259
-Node: Headers and memory usage87359
-Node: Literal PS88069
-Node: " special88651
-Node: ps special89392
-Node: Literal headers90890
-Node: PostScript hooks91605
-Node: Literal examples93695
-Node: Hypertext95147
-Node: Hypertext caveats96705
-Node: Hypertext specials101102
-Node: PostScript fonts103736
-Node: Font concepts104852
-Node: Metric files106019
-Node: Glyph files108845
-Node: Virtual fonts111201
-Node: Encodings113091
-Node: PostScript typesetting115494
-Node: Making a font available118576
-Node: Invoking afm2tfm123606
-Node: Changing font encodings124576
-Node: Changing TeX encodings125366
-Node: Changing PostScript encodings126466
-Node: Changing both encodings127810
-Node: Reencoding with Afm2tfm128483
-Node: Encoding file format131587
-Node: Special font effects135790
-Node: Afm2tfm options138053
-Node: psfonts.map141038
-Node: Color145770
-Node: Color macro files146814
-Node: User-definable colors150012
-Node: Color subtleties151287
-Node: Ted Turner152938
-Node: Color device configuration154163
-Node: Color support details156605
-Node: Color specifications156983
-Node: Color specials158386
-Node: Index160515
+Node: No output14409
+Node: Small or inverted15877
+Node: Printer errors16596
+Node: Long documents fail17928
+Node: Including graphics fails18269
+Node: Invoking Dvips19507
+Node: Basic usage20098
+Node: Command-line options21082
+Node: Option summary21531
+Node: Option details23693
+Node: Environment variables42697
+Node: Config files45656
+Node: Configuration file searching46339
+Node: Configuration file commands49639
+Node: Paper size and landscape56752
+Node: papersize special58350
+Node: Config file paper sizes59759
+Node: Paper trays63914
+Node: Interaction with PostScript65248
+Node: PostScript figures65901
+Node: Bounding box66627
+Node: \includegraphics69998
+Node: EPSF macros72289
+Node: EPSF scaling74259
+Node: EPSF clipping76829
+Node: psfile special77471
+Node: Dynamic creation of graphics79864
+Node: Fonts in figures81182
+Node: Header files82842
+Node: Including headers from TeX84048
+Node: Including headers from the command line86082
+Node: Headers and memory usage87182
+Node: Literal PS87892
+Node: " special88474
+Node: ps special89215
+Node: Literal headers90713
+Node: PostScript hooks91428
+Node: Literal examples93518
+Node: Hypertext94970
+Node: Hypertext caveats96528
+Node: Hypertext specials100925
+Node: PostScript fonts103559
+Node: Font concepts104675
+Node: Metric files105842
+Node: Glyph files108668
+Node: Virtual fonts111024
+Node: Encodings112914
+Node: PostScript typesetting115317
+Node: Making a font available118399
+Node: Invoking afm2tfm123429
+Node: Changing font encodings124399
+Node: Changing TeX encodings125189
+Node: Changing PostScript encodings126289
+Node: Changing both encodings127633
+Node: Reencoding with Afm2tfm128306
+Node: Encoding file format131410
+Node: Special font effects135613
+Node: Afm2tfm options137876
+Node: psfonts.map140861
+Node: Color145593
+Node: Color macro files146637
+Node: User-definable colors149835
+Node: Color subtleties151110
+Node: Ted Turner152761
+Node: Color device configuration153986
+Node: Color support details156428
+Node: Color specifications156806
+Node: Color specials158209
+Node: Index160338
 
 End Tag Table
diff --git a/Build/source/texk/dvipsk/dvips.texi b/Build/source/texk/dvipsk/dvips.texi
index b4a26c2af3d..4c95f2166e8 100644
--- a/Build/source/texk/dvipsk/dvips.texi
+++ b/Build/source/texk/dvipsk/dvips.texi
@@ -375,22 +375,19 @@ settings you expect.
 @cindex debugging options
 @cindex options, debugging
 
-The @samp{-d} flag to Dvips helps in tracking down certain errors.  The
-parameter to this flag is an integer that tells what errors are
+The @samp{-d} flag to Dvips helps in tracking down certain errors.
+The parameter to this flag is an integer that tells what errors are
 currently being tracked.  To track a certain class of debug messages,
-simply provide the appropriate number given below; if you wish to track
-multiple classes, sum the numbers of the classes you wish to track.  To
-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.
+specify the appropriate number given below; if you wish to track
+multiple classes, sum the numbers of the classes you wish to track.
+To track all classes, you can use @code{-1}.
 
-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}).
+You can also set the environment variable @env{KPATHSEA_DEBUG} instead
+of using @samp{-d}.  Some of these debugging options are actually
+provided by Kpathsea (@pxref{Debugging, , , kpathsea, Kpathsea}).
 
 The classes are:
+
 @table @asis
 @item 1 
 specials
@@ -407,18 +404,16 @@ font compression
 @item 64
 files
 @item 128
-config files
+(omitted)
 @item 256
-Partial Type 1 font encoding vectors
+config files
 @item 512
-Partial Type 1 subr calls
-@item 1024
 Kpathsea @code{stat} calls
-@item 2048
+@item 1024
 Kpathsea hash table lookups
-@item 4096
+@item 2048
 Kpathsea path element expansion
-@item 8192
+@item 4096
 Kpathsea path searches
 @end table