man page updates from sanjoy

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

8 files changed, 57 insertions, 234 deletions

diff --git a/Build/source/texk/web2c/man/bibtex.man b/Build/source/texk/web2c/man/bibtex.man
index 59b4034a847..94999d72cfa 100644
--- a/Build/source/texk/web2c/man/bibtex.man
+++ b/Build/source/texk/web2c/man/bibtex.man
@@ -1,4 +1,4 @@
-.TH BIBTEX 1 "24 November 1994" "Web2C @VERSION@"
+.TH BIBTEX 1 "8 January 2007" "bibtex 0.99c" "Web2C @VERSION@"
 .\"=====================================================================
 .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
 .if n .ds TX TeX
diff --git a/Build/source/texk/web2c/man/etex.man b/Build/source/texk/web2c/man/etex.man
index dd9ff8c06d8..27dfb6a68a3 100644
--- a/Build/source/texk/web2c/man/etex.man
+++ b/Build/source/texk/web2c/man/etex.man
@@ -1,4 +1,4 @@
-.TH ETEX 1 "21 August 2004" "Web2C @VERSION@"
+.TH ETEX 1 "7 January 2007" "pdftex 1.40" "Web2C @VERSION@"
 .\"=====================================================================
 .if n .ds MF Metafont
 .if t .ds MF M\s-2ETAFONT\s0
@@ -390,6 +390,10 @@ Predigested e-\*(TX format (.\|fmt) files.
 .br
 .\"=====================================================================
 .SH NOTES
+Starting with version 1.40, pdf\*(TX incorporates the e-\*(TX
+extensions, so in this installation e\*(TX is just a symbolic link to
+pdf\*(TX.  See 
+.BR pdftex (1).
 This manual page is not meant to be exhaustive.  The complete
 documentation for this version of e-\*(TX can be found in the info
 manual
@@ -411,6 +415,7 @@ but when it does the generated
 file will be invalid.
 .\"=====================================================================
 .SH "SEE ALSO"
+.BR pdftex (1),
 .BR tex (1),
 .BR mf (1).
 .\"=====================================================================
diff --git a/Build/source/texk/web2c/man/latex.man b/Build/source/texk/web2c/man/latex.man
index 73f4b5ad9e5..b64425b6767 100644
--- a/Build/source/texk/web2c/man/latex.man
+++ b/Build/source/texk/web2c/man/latex.man
@@ -1,4 +1,4 @@
-.TH LATEX 1 "29 March 1999" "Web2C @VERSION@"
+.TH LATEX 1 "7 January 2007" "Web2C @VERSION@"
 .\"=====================================================================
 .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
 .if n .ds TX TeX
@@ -68,3 +68,8 @@ should not be used for new texts.
 Leslie Lamport,
 .IR "\*(LX \- A Document Preparation System" ,
 Addison-Wesley, 1985, ISBN 0-201-15790-X.
+
+LaTeX Companion
+
+LaTeX Graphics Companion
+
diff --git a/Build/source/texk/web2c/man/mpost.man b/Build/source/texk/web2c/man/mpost.man
index f47911c9297..59fcb7c1a16 100644
--- a/Build/source/texk/web2c/man/mpost.man
+++ b/Build/source/texk/web2c/man/mpost.man
@@ -1,4 +1,4 @@
-.TH MPOST 1 "10 November 2001" "Web2C @VERSION@"
+.TH MPOST 1 "7 January 2007" "MetaPost 0.993" "Web2C 7.5.6"
 .\"=====================================================================
 .if n .ds MP MetaPost
 .if t .ds MP MetaPost
@@ -432,6 +432,15 @@ in a little more detail.
 This manual page is not meant to be exhaustive.  The complete
 documentation for this version of \*(MP can be found in the info manual
 .IR "Web2C: A TeX implementation" .
+See also 
+.IR mpman.pdf ,
+the manual written by John Hobby (it lives in the documentation
+directory).
+.PP
+.B MetaPost
+is the native graphics language for ConTeXt, a typesetting system
+built on top of the \*(TX family.  See 
+.BR texexec (1).
 .\"=====================================================================
 .SH "SUGGESTED READING"
 Donald E. Knuth,
@@ -453,6 +462,7 @@ CSTR 164, AT&T Bell Labs,
 .\"=====================================================================
 .SH "SEE ALSO"
 .BR tex (1),
+.BR texexec (1),
 .BR mf (1),
 .BR dvips (1).
 .\"=====================================================================
@@ -468,6 +478,8 @@ searching features in more recent versions of
 .B web2c
 and worked towards fully integrating \*(MP into the canonical Unix 
 \*(TX distribution.  He also updated and extended this manual page.
+.PP
+The current maintainer of MetaPost is Taco Hoekwater.
 .\"=====================================================================
 .SH TRIVIA
 Unlike \*(TX and \*(MF, \*(MP originally didn't use any fancy logo.
diff --git a/Build/source/texk/web2c/man/mpto.man b/Build/source/texk/web2c/man/mpto.man
index f5d99040a58..8288e1bc24f 100644
--- a/Build/source/texk/web2c/man/mpto.man
+++ b/Build/source/texk/web2c/man/mpto.man
@@ -1,4 +1,4 @@
-.TH MPTO 1 "4 January 1998" "Web2C @VERSION@"
+.TH MPTO 1 "7 January 2007" "MetaPost 0.993" "Web2C @VERSION@"
 .\"=====================================================================
 .if n .ds MP MetaPost
 .if t .ds MP MetaPost
diff --git a/Build/source/texk/web2c/man/pdfetex.man b/Build/source/texk/web2c/man/pdfetex.man
index 91f7bed076f..b36db423685 100644
--- a/Build/source/texk/web2c/man/pdfetex.man
+++ b/Build/source/texk/web2c/man/pdfetex.man
@@ -1,4 +1,4 @@
-.TH PDFETEX 1 "21 August 2004" "Web2C @VERSION@"
+.TH PDFETEX 1 "7 January 2007" "pdftex 1.40" "Web2C @VERSION@"
 .\"=====================================================================
 .if n .ds MF Metafont
 .if t .ds MF M\s-2ETAFONT\s0
@@ -417,6 +417,9 @@ Predigested pdfe\*(TX format (.\|fmt) files.
 .br
 .\"=====================================================================
 .SH NOTES
+Starting with version 1.40, pdf\*(TX incorporates the e-\*(TX
+extensions, and pdfe\*(TX is just a copy of pdf\*(TX.  See 
+.BR pdftex (1).
 This manual page is not meant to be exhaustive.  The complete
 documentation for this version of pdfe\*(TX can be found in the info
 manual
@@ -448,6 +451,10 @@ Information on how to get pdfe\*(TX and related information
 is available at the
 .BI "http://tug.org" \ TUG
 website.
+The most recent version of pdfe\*(TX is available for anonymous
+ftp at the
+.B http://www.pdftex.org/
+.IR "pdfe\*(TX development site" .
 .P
 The following pdfe\*(TX related mailing list is available:
 .BR pdftex@tug.org .
@@ -468,8 +475,8 @@ website.
 .BR pdftex (1).
 .\"=====================================================================
 .SH AUTHORS
-The primary authors of pdf\*(TX are Han The Thanh, Petr Sojka, and
-Jiri Zlatuska.
+The primary authors of pdfe\*(TX are Han The Thanh, Petr Sojka,
+Jiri Zlatuska, and Peter Breitenlohner (e\*TX).
 .PP
 \*(TX was designed by Donald E. Knuth,
 who implemented it using his \*(WB system for Pascal programs.
diff --git a/Build/source/texk/web2c/man/pdftex.man b/Build/source/texk/web2c/man/pdftex.man
index f8e016ea40c..266c063ea7a 100644
--- a/Build/source/texk/web2c/man/pdftex.man
+++ b/Build/source/texk/web2c/man/pdftex.man
@@ -1,4 +1,4 @@
-.TH PDFTEX 1 "25 March 2004" "Web2C @VERSION@"
+.TH PDFTEX 1 "7 Jan 2007" "pdftex 1.40" "Web2C @VERSION@"
 .\"=====================================================================
 .if n .ds MF Metafont
 .if t .ds MF M\s-2ETAFONT\s0
@@ -46,7 +46,7 @@ it is usually better to use the
 .I format
 option instead.
 .PP
-pdf\*(TX is a version of \*(TX that can create
+pdf\*(TX is a version of \*(TX, with the e-\*(TX extensions, that can create
 .I PDF
 files as well as
 .I DVI
@@ -54,7 +54,7 @@ files.
 .PP
 In
 .I DVI
-mode, pdf\*(TX can be used as a complete replacement of the \*(TX
+mode, pdf\*(TX can be used as a complete replacement for the \*(TX
 engine.
 .PP
 The typical use of pdf\*(TX is with a pregenerated formats for which
@@ -75,15 +75,17 @@ commands are pdf\*(TX's analogues to the
 .B initex
 and
 .B virtex
-commands.  In this installation, they are symbolic links to the
+commands.  In this installation, if the links exist, they are symbolic
+links to the
 .B pdftex
-executable.  These symbolic links may not exist at all.
+executable.
 .PP
 In
 .I PDF
 mode, pdf\*(TX can natively handle the
 .IR PDF ,
 .IR JPG ,
+.IR JBIG2 ,
 and
 .I PNG
 graphics formats.
@@ -411,6 +413,11 @@ Predigested pdf\*(TX format (.\|fmt) files.
 .br
 .\"=====================================================================
 .SH NOTES
+Starting with version 1.40, pdf\*(TX incorporates the e-\*(TX
+extensions, and pdfe\*(TX is just a copy of pdf\*(TX.  See 
+.BR etex (1)
+and
+.BR pdfetex (1).
 This manual page is not meant to be exhaustive.  The complete
 documentation for this version of pdf\*(TX can be found in the info
 manual
@@ -442,6 +449,10 @@ Information on how to get pdfe\*(TX and related information
 is available at the
 .BI "http://tug.org" \ TUG
 website.
+The most recent version of pdf\*(TX is available for anonymous
+ftp at the
+.B http://www.pdftex.org/
+.IR "pdf\*(TX development site" .
 .P
 The following pdfe\*(TX related mailing list is available:
 .BR pdftex@tug.org .
@@ -457,11 +468,13 @@ website.
 .\"=====================================================================
 .SH "SEE ALSO"
 .BR tex (1),
+.BR etex (1),
+.BR pdfetex (1),
 .BR mf (1).
 .\"=====================================================================
 .SH AUTHORS
-The primary authors of pdf\*(TX are Han The Thanh, Petr Sojka, and
-Jiri Zlatuska.
+The primary authors of pdf\*(TX are Han The Thanh, Petr Sojka,
+Jiri Zlatuska, and Peter Breitenlohner (e\*TX).
 .PP
 \*(TX was designed by Donald E. Knuth,
 who implemented it using his \*(WB system for Pascal programs.
diff --git a/Build/source/texk/web2c/man/pdftosrc.1 b/Build/source/texk/web2c/man/pdftosrc.1
deleted file mode 100644
index 5f59026b94a..00000000000
--- a/Build/source/texk/web2c/man/pdftosrc.1
+++ /dev/null
@@ -1,219 +0,0 @@
-.\" Process this file with
-.\" groff -man -Tascii pdftosrc.1
-.\"
-.\" $Id: pdftosrc.1,v 1.3 2005/11/04 18:55:24 hhenkel Exp $
-.\"
-.TH pdftosrc 1 "3 November 2005" "User Manuals"
-.SH NAME
-pdftosrc \- extract source file or stream from PDF file
-.SH SYNOPSIS
-.B pdftosrc
-.I PDF-file
-.R [
-.I stream-object-number
-.R ]
-.SH DESCRIPTION
-If only
-.I PDF-file
-is given as argument,
-.B pdftosrc
-extracts the embedded source file
-from the first found stream object
-with /Type /SourceFile within the
-.I PDF-file
-and writes it to a file with the name /SourceName
-as defined in that PDF stream object
-(see application example below).
-
-If both
-.I PDF-file
-and
-.I stream-object-number
-are given as arguments,
-.B pdftosrc
-extracts and uncompresses the PDF stream of the object
-given by its
-.I stream-object-number
-from the
-.I PDF-file
-and writes it to a file named
-.IR PDF-file . stream-object-number
-with the ending
-.I .pdf
-or
-.I .PDF
-stripped from the original
-.I PDF-file
-name.
-
-In either case
-an existing file with the output file name will be overwritten.
-.SH OPTIONS
-None.
-.SH FILES
-Just the executable
-.BR pdftosrc .
-.SH ENVIRONMENT
-None.
-.SH DIAGNOSTICS
-At success the exit code of
-.B pdftosrc
-is 0, else 1.
-
-All messages go to stderr.
-At program invocation,
-.B pdftosrc
-issues the current version number of the program
-.BR xpdf ,
-on which
-.B pdftosrc
-is based:
-
-.RS
-pdftosrc version 3.00
-
-.RE
-When
-.B pdftosrc
-was successful with the output file writing,
-one of the following messages will be issued:
-
-.RS
-Source file extracted to
-.I source-file-name
-
-.RE
-or
-
-.RS
-Stream object extracted to
-.IR PDF-file . stream-object-number
-
-.RE
-
-.RE
-When the object given by the
-.I stream-object-number
-does not contain a stream,
-.B pdftosrc
-issues the following error message:
-
-.RS
-Not a Stream object
-
-.RE
-When the
-.I PDF-file
-can't be opened, the error message is:
-
-.RS
-Error: Couldn't open file
-.RI ' PDF-file '.
-
-.RE
-When
-.B pdftosrc
-encounters an invalid PDF file,
-the error message (several lines) is:
-
-.RS
-Error: May not be a PDF file (continuing anyway)
-.RE
-.RS
-(more lines)
-.RE
-.RS
-Invalid PDF file
-
-.RE
-There are also more error messages from
-.B pdftosrc
-for various kinds of broken PDF files.
-.SH NOTES
-An embedded source file will be written out unchanged,
-i. e. it will not be uncompressed in this process.
-
-Only the stream of the object will be written,
-i. e. not the dictionary of that object.
-
-Knowing which
-.I stream-object-number
-to query requires information about the PDF file
-that has to be gained elsewhere,
-e. g. by looking into the PDF file with an editor.
-
-The stream extraction capabilities of
-.B pdftosrc
-(e. g. regarding understood PDF versions and filter types)
-follow the capabilities of the underlying
-.B xpdf
-program version.
-
-Currently the generation number of the stream object
-is not supported.
-The default value 0 (zero) is taken.
-
-The wording
-.I stream-object-number
-has nothing to do with the `object streams' introduced
-by the Adobe PDF Reference,
-5th edition, version 1.6.
-.SH EXAMPLES
-When using pdftex or pdfetex,
-a source file can be embedded into some
-.I PDF-file
-by using pdftex primitives,
-as illustrated by the following example:
-
-\\immediate\\pdfobj
-.RE
-    stream attr {/Type /SourceFile /SourceName (myfile.zip)}
-.RS
-.RE
-    file{myfile.zip}
-.RS
-.RE
-\\pdfcatalog{/SourceObject \\the\\pdflastobj\\space 0 R}
-
-Then this zip file can be extracted from the
-.I PDF-file
-by calling
-.B pdftosrc
-.IR PDF-file .
-.SH BUGS
-Not all embedded source files will be extracted,
-only the first found one.
-
-Email bug reports to
-.B pdftex@tug.org.
-.SH SEE ALSO
-.BR xpdf (1),
-.BR pdfimages (1),
-.BR pdftotext (1),
-.BR pdftex (1),
-.BR pdfetex (1).
-.SH AUTHORS
-.B pdftosrc
-written by Han The Thanh, using
-.B xpdf
-functionality from Derek Noonburg.
-
-Man page written by Hartmut Henkel.
-.SH COPYRIGHT
-Copyright (c) 1996-2002 Han The Thanh, <thanh@pdftex.org>
-
-This file is part of pdfTeX.
-
-pdfTeX is free software; you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation; either version 2 of the License, or
-(at your option) any later version.
-
-pdfTeX is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with pdfTeX; if not, write to the Free Software
-Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA