doc changs

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

4 files changed, 87 insertions, 86 deletions

diff --git a/Build/source/texk/web2c/ChangeLog b/Build/source/texk/web2c/ChangeLog
index fa504e92b4e..ef22b230238 100644
--- a/Build/source/texk/web2c/ChangeLog
+++ b/Build/source/texk/web2c/ChangeLog
@@ -1,3 +1,9 @@
+2011-05-05  Karl Berry  <karl@tug.org>
+
+	* man/pktype.man: output is always to stdout.
+	
+	* doc/web2c.texi (Common option): -jobname can override recorder name.
+
 2011-04-28  Karl Berry  <karl@tug.org>
 
 	* doc/web2c.texi (Common options): caveats about the -recorder
diff --git a/Build/source/texk/web2c/doc/web2c.info b/Build/source/texk/web2c/doc/web2c.info
index b93b9ea0c75..ab0a4196194 100644
--- a/Build/source/texk/web2c/doc/web2c.info
+++ b/Build/source/texk/web2c/doc/web2c.info
@@ -564,7 +564,8 @@ common:
      given (*note Output file location::).  However, if TeX processing
      is done on the command line (or in response to the `**' prompt),
      the `.fls' might be written to the current directory, or include
-     an integer (the current pid), as in `texput1234.fls'.
+     an integer (the current pid), as in `texput1234.fls'.  You can use
+     `-jobname' to explicitly set the basename.
 
 `-translate-file=TCXFILE'
      Use TCXFILE to define which characters are printable and
@@ -3546,7 +3547,7 @@ Index
                                                               (line  59)
 * --with-x:                              Online Metafont graphics.
                                                               (line  57)
-* -8bit:                                 Common options.      (line 105)
+* -8bit:                                 Common options.      (line 106)
 * -base=BASE:                            Determining the memory dump to use.
                                                               (line  15)
 * -base=DUMPNAME:                        Common options.      (line  34)
@@ -3596,7 +3597,7 @@ Index
 * -no-mktex=FILETYPE:                    tex invocation.      (line 105)
 * -no-parse-first-line:                  Common options.      (line  73)
 * -no-shell-escape:                      tex invocation.      (line 123)
-* -oem:                                  Common options.      (line 110)
+* -oem:                                  Common options.      (line 111)
 * -output-comment=STRING:                tex invocation.      (line 115)
 * -output-directory <1>:                 Output file location.
                                                               (line  15)
@@ -3618,7 +3619,7 @@ Index
 * -T:                                    mpost invocation.    (line 118)
 * -terse:                                bibtex invocation.   (line  28)
 * -tex=TEXPROGRAM:                       mpost invocation.    (line 121)
-* -translate-file=TCXFILE:               Common options.      (line  98)
+* -translate-file=TCXFILE:               Common options.      (line  99)
 * -troff:                                mpost invocation.    (line 118)
 * -underline:                            tangle invocation.   (line  41)
 * -uppercase:                            tangle invocation.   (line  35)
@@ -3639,7 +3640,7 @@ Index
 * .NNN PostScript figures:               mpost invocation.    (line  37)
 * .NNNgf generic fonts:                  mf invocation.       (line  34)
 * .tcx character translation files <1>:  TCX files.           (line   6)
-* .tcx character translation files:      Common options.      (line  98)
+* .tcx character translation files:      Common options.      (line  99)
 * .tex:                                  tex invocation.      (line  20)
 * .tfm output <1>:                       mpost invocation.    (line  37)
 * .tfm output:                           mf invocation.       (line  43)
@@ -3648,8 +3649,8 @@ Index
 * .Xresources:                           Online Metafont graphics.
                                                               (line  69)
 * 2602gf:                                mf invocation.       (line  48)
-* 8 bit clean:                           Common options.      (line 105)
-* 8 bit clean output, specifying:        Common options.      (line 105)
+* 8 bit clean:                           Common options.      (line 106)
+* 8 bit clean output, specifying:        Common options.      (line 106)
 * 8-bit characters:                      TCX files.           (line   6)
 * \bibliography:                         bibtex invocation.   (line  18)
 * \bibliographystyle:                    bibtex invocation.   (line  18)
@@ -3881,7 +3882,7 @@ Index
 * file recorder:                         Common options.      (line  85)
 * filename conventions, in input files:  \input filenames.    (line   6)
 * filenames starting with -:             Option conventions.  (line  19)
-* first line of the main input file:     Common options.      (line  98)
+* first line of the main input file:     Common options.      (line  99)
 * fixed-point arithmetic:                Compile-time options.
                                                               (line  22)
 * FIXPT:                                 Compile-time options.
@@ -4379,7 +4380,7 @@ Index
 * toolkits, X:                           Online Metafont graphics.
                                                               (line  59)
 * torture tests:                         Triptrap.            (line   6)
-* translation file for TeX, specifying:  Common options.      (line  98)
+* translation file for TeX, specifying:  Common options.      (line  99)
 * translation from WEB to C:             Introduction.        (line  17)
 * trap Make target:                      Additional targets.  (line  41)
 * trap test:                             Triptrap.            (line   6)
@@ -4410,7 +4411,7 @@ Index
                                                               (line  50)
 * unsrt.bst:                             Basic BibTeX style files.
                                                               (line  39)
-* using local codepage to display messages: Common options.   (line 110)
+* using local codepage to display messages: Common options.   (line 111)
 * UTF-8 input:                           tex invocation.      (line  89)
 * validation, of DVI files:              dvitype invocation.  (line   6)
 * validation, of GF files:               gftype invocation.   (line   6)
@@ -4492,64 +4493,64 @@ Node: Runtime options15162
 Node: Commonalities16934
 Node: Option conventions17539
 Node: Common options18763
-Node: Path searching23356
-Node: Output file location24378
-Node: Three programs25703
-Node: Initial and virgin26462
-Node: Memory dumps27562
-Node: Creating memory dumps28029
-Node: Determining the memory dump to use29290
-Node: Hardware and memory dumps30914
-Node: Editor invocation33383
-Node: \input filenames34113
-Node: TeX37106
-Node: tex invocation38252
-Node: Initial TeX45222
-Node: Formats46711
-Node: Languages and hyphenation49650
-Node: MLTeX50080
-Node: \charsubdef51575
-Node: \tracingcharsubdef53901
-Node: TCX files54476
-Node: patgen invocation59900
-Node: Shell escapes60617
-Node: IPC and TeX64181
-Node: TeX extensions64751
-Node: Metafont65883
-Node: mf invocation67171
-Node: Initial Metafont71054
-Node: Modes72807
-Node: Online Metafont graphics75063
-Node: gftodvi invocation78478
-Node: mft invocation81311
-Node: MetaPost85366
-Node: mpost invocation86128
-Node: Initial MetaPost91386
-Node: dvitomp invocation93197
-Node: BibTeX93862
-Node: bibtex invocation94223
-Node: Basic BibTeX style files96548
-Node: WEB97890
-Node: tangle invocation99098
-Node: weave invocation101221
-Node: pooltype invocation102629
-Node: DVI utilities103759
-Node: dvicopy invocation104703
-Node: dvitype invocation106001
-Node: dvitype output example108356
-Node: Font utilities111407
-Node: Font file formats112587
-Node: gftopk invocation115886
-Node: pktogf invocation117090
-Node: pktype invocation118269
-Node: gftype invocation121104
-Node: tftopl invocation125620
-Node: pltotf invocation130254
-Node: vftovp invocation131319
-Node: vptovf invocation133603
-Node: Font utilities available elsewhere134657
-Node: Legalisms137065
-Node: References139236
-Node: Index143808
+Node: Path searching23417
+Node: Output file location24439
+Node: Three programs25764
+Node: Initial and virgin26523
+Node: Memory dumps27623
+Node: Creating memory dumps28090
+Node: Determining the memory dump to use29351
+Node: Hardware and memory dumps30975
+Node: Editor invocation33444
+Node: \input filenames34174
+Node: TeX37167
+Node: tex invocation38313
+Node: Initial TeX45283
+Node: Formats46772
+Node: Languages and hyphenation49711
+Node: MLTeX50141
+Node: \charsubdef51636
+Node: \tracingcharsubdef53962
+Node: TCX files54537
+Node: patgen invocation59961
+Node: Shell escapes60678
+Node: IPC and TeX64242
+Node: TeX extensions64812
+Node: Metafont65944
+Node: mf invocation67232
+Node: Initial Metafont71115
+Node: Modes72868
+Node: Online Metafont graphics75124
+Node: gftodvi invocation78539
+Node: mft invocation81372
+Node: MetaPost85427
+Node: mpost invocation86189
+Node: Initial MetaPost91447
+Node: dvitomp invocation93258
+Node: BibTeX93923
+Node: bibtex invocation94284
+Node: Basic BibTeX style files96609
+Node: WEB97951
+Node: tangle invocation99159
+Node: weave invocation101282
+Node: pooltype invocation102690
+Node: DVI utilities103820
+Node: dvicopy invocation104764
+Node: dvitype invocation106062
+Node: dvitype output example108417
+Node: Font utilities111468
+Node: Font file formats112648
+Node: gftopk invocation115947
+Node: pktogf invocation117151
+Node: pktype invocation118330
+Node: gftype invocation121165
+Node: tftopl invocation125681
+Node: pltotf invocation130315
+Node: vftovp invocation131380
+Node: vptovf invocation133664
+Node: Font utilities available elsewhere134718
+Node: Legalisms137126
+Node: References139297
+Node: Index143869
 
 End Tag Table
diff --git a/Build/source/texk/web2c/doc/web2c.texi b/Build/source/texk/web2c/doc/web2c.texi
index ed8d2921756..530d41dff51 100644
--- a/Build/source/texk/web2c/doc/web2c.texi
+++ b/Build/source/texk/web2c/doc/web2c.texi
@@ -417,7 +417,8 @@ the @samp{.log} file, for example, respecting
 location}).  However, if @TeX{} processing is done on the command line
 (or in response to the @samp{**} prompt), the @samp{.fls} might be
 written to the current directory, or include an integer (the current
-pid), as in @file{texput1234.fls}.
+pid), as in @file{texput1234.fls}.  You can use @option{-jobname} to
+explicitly set the basename.
 
 @item -translate-file=@var{tcxfile}
 @opindex -translate-file=@var{tcxfile}
diff --git a/Build/source/texk/web2c/man/pktype.man b/Build/source/texk/web2c/man/pktype.man
index 32c36960e56..25a763d7855 100644
--- a/Build/source/texk/web2c/man/pktype.man
+++ b/Build/source/texk/web2c/man/pktype.man
@@ -1,4 +1,4 @@
-.TH PKTYPE 1 "13 March 1996" "Web2C @VERSION@"
+.TH PKTYPE 1 "5 May 2011" "Web2C @VERSION@"
 .\"=====================================================================
 .if n .ds MF Metafont
 .if t .ds MF M\s-2ETAFONT\s0
@@ -18,8 +18,7 @@
 pktype \- verify and translate a packed font bitmap file to plain text
 .SH SYNOPSIS
 .B pktype
-.I pk_file
-.RI [ output_file ]
+.IR pk_file [pk]
 .\"=====================================================================
 .SH DESCRIPTION
 This manual page is not meant to be exhaustive.  The complete
@@ -43,14 +42,10 @@ program for other software that wants to read
 .I pk
 files.
 .PP
-The
+The input
 .I pk_file
-on the command line must be complete. Because
-the resolution is part of the extension, it would not make
-sense to append a default extension as is done with \*(TX or
-DVI-reading software. If no
-.I output_file
-is specified, the plain text translation is written to standard output.
+on the command line may omit the suffix `pk.
+The plain text translation is always written to standard output.
 .PP
 The output file gives a compact encoding of the packed encoding, using
 conventions described in the source code. Run lengths of black pixels
@@ -61,9 +56,7 @@ are used to indicate when a row should be repeated.
 .B pktype
 looks for
 .I pk_file
-using the environment variable PKFONTS.  If that is not set, it uses
-the variable TEXPKS.  If that is not set, it uses TEXFONTS.  If that
-is not set, it uses the system default.
+in the usual places according to Kpathsea.
 .PP
 See
 .BR tex (1)
@@ -78,6 +71,6 @@ Donald E. Knuth et al.,
 .IR \*(MFware .
 .\"=====================================================================
 .SH AUTHORS
-Tomas Rokicki wrote the program.
-Donald E. Knuth originally ported it to Unix.
-Pierre MacKay adapted it for compilation with Web2c.
+Tomas Rokicki wrote the program,
+Donald E. Knuth originally ported it to Unix,
+Pierre MacKay originally adapted it for compilation with Web2c.