man pages updates from Sanjoy

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

18 files changed, 222 insertions, 118 deletions

diff --git a/Master/texmf/doc/man/man1/ctxtools.1 b/Master/texmf/doc/man/man1/ctxtools.1
index eb6d703a544..c22263d4267 100644
--- a/Master/texmf/doc/man/man1/ctxtools.1
+++ b/Master/texmf/doc/man/man1/ctxtools.1
@@ -75,10 +75,10 @@ TEXMFLOCAL
 Used by \f(CW--updatecontext\fP to decide where to install the distribution.
 
 .SH "SEE ALSO" 
-.IP \(bu
+.PP
 .BR texexec (1),
 .BR texmfstart (1).
-.IP \(bu
+.PP
 .URL "http://www.contextgarden.net" "ConTeXt wiki" .
 
 .SH BUGS
diff --git a/Master/texmf/doc/man/man1/dvitomp.1 b/Master/texmf/doc/man/man1/dvitomp.1
index a6b74030943..78125eb11cc 100644
--- a/Master/texmf/doc/man/man1/dvitomp.1
+++ b/Master/texmf/doc/man/man1/dvitomp.1
@@ -1,4 +1,4 @@
-.TH DVITOMP 1 "October 30, 1999"
+.TH DVITOMP 1 "30 October 1999" "Web2C 7.5.6"
 .\" man page by Jim Van Zandt <jrv@vanzandt.mv.com>         -*- nroff -*-
 .SH NAME
 dvitomp \- convert a TeX DVI file to a MetaPost MPXFILE
diff --git a/Master/texmf/doc/man/man1/fdf2tex.1 b/Master/texmf/doc/man/man1/fdf2tex.1
index 5183aba95cb..0eed035bd59 100644
--- a/Master/texmf/doc/man/man1/fdf2tex.1
+++ b/Master/texmf/doc/man/man1/fdf2tex.1
@@ -32,20 +32,20 @@ file processing, so most users do not need to worry about it.
 .SH "BUGS"
 .PP
 Probably none -- all errors are in this manpage
-.PP
+
 .SH "SEE ALSO" 
-.IP \(bu
+.PP
 \fBtexexec\fP(1).
-.IP \(bu
+.PP
 The TeXExec manual, \fImtexexec.pdf\fP.
 available from
 .URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" .
-.IP \(bu
+.PP
 .URL "http://www.contextgarden.net" "ConTeXt wiki" .
 
 .SH "AUTHOR" 
 
-This manual page was written by Frank Küster <frank@kuesterei.ch>,
+This manual page was written by Frank K\[:u]ster <frank@kuesterei.ch>,
 for the Debian GNU/Linux system, and modified by Sanjoy Mahajan
 <sanjoy@mit.edu>.  It may be used and modified by others without
 contacting the authors.
diff --git a/Master/texmf/doc/man/man1/lacheck.1 b/Master/texmf/doc/man/man1/lacheck.1
index ace75e38f65..03999fe9fe9 100644
--- a/Master/texmf/doc/man/man1/lacheck.1
+++ b/Master/texmf/doc/man/man1/lacheck.1
@@ -1,4 +1,4 @@
-.TH "LaCheck" "1" "01/11/07" "Release 1.26"
+.TH "LaCheck" "1" "01/20/07" "Release 1.26"
 .SH NAME
 lacheck - A consistency checker for LaTeX documents.
 .SH SYNOPSIS
diff --git a/Master/texmf/doc/man/man1/latex.1 b/Master/texmf/doc/man/man1/latex.1
index 52bbac44000..2e552728ed7 100644
--- a/Master/texmf/doc/man/man1/latex.1
+++ b/Master/texmf/doc/man/man1/latex.1
@@ -19,6 +19,7 @@ latex, elatex, lambda, pdflatex \- structured text formatting and typesetting
 [ first line ]
 .\"=====================================================================
 .SH DESCRIPTION
+.PP
 This manual page is not meant to be exhaustive.  The complete
 documentation for this version of \*(TX can be found in the info file
 or manual
@@ -60,16 +61,26 @@ and
 are available for compatibility with older versions of \*(LX.  These
 should not be used for new texts.
 .\"=====================================================================
+.PP
 .SH "SEE ALSO"
 .BR amslatex (1),
 .BR amstex (1),
-.BR tex (1),
-.br
+.BR pdflatex (1),
+.BR pdftex (1),
+.BR tex (1).
+.PP
 Leslie Lamport,
 .IR "\*(LX \- A Document Preparation System" ,
-Addison-Wesley, 1985, ISBN 0-201-15790-X.
-
-LaTeX Companion
-
-LaTeX Graphics Companion
-
+Addison-Wesley, 1985, ISBN 020115790X.
+.PP
+Frank Mittelbach, Michel Goossens, Johannes Braams, David Carlisle,
+and Chris Rowley, 
+.IR "LaTeX Companion" ,
+Addison-Wesley, 2004, ISBN 0201362996 (2nd edition).
+.PP
+\fILaTeX Graphics Companion\fP, available as part of a boxed set:
+\fIThe LaTeX Companions, Revised Boxed Set : A Complete Guide and
+Reference for Preparing, Illustrating, and Publishing Technical
+Documents\fP (2nd Edition), by Frank Mittelbach, Michel Goossens,
+Sebastian Rahtz, Helmut Kopka, Patrick W. Daly (Addison-Wesley, 2004,
+ISBN 0321269446).
diff --git a/Master/texmf/doc/man/man1/makempy.1 b/Master/texmf/doc/man/man1/makempy.1
index 98af35224a4..794cd347c89 100644
--- a/Master/texmf/doc/man/man1/makempy.1
+++ b/Master/texmf/doc/man/man1/makempy.1
@@ -56,17 +56,17 @@ are used can be set with PDFTOPS and PSTOEDIT.
 
 .SH "SEE ALSO" 
 
-.IP \(bu
-\fBmpost\fP(1), \fBpstoedit\fP(1), \fBtexexec\fP(1).
-.IP \(bu
+.PP
+\fBmpost\fP(1), \fBmptopdf\fP(1), \fBpstoedit\fP(1), \fBtexexec\fP(1).
+.PP
 The makempy manual, \fImmakempy.pdf\fP,
 available from
 .URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" .
-.IP \(bu
+.PP
 .URL "http://www.contextgarden.net" "ConTeXt wiki" .
 
 .SH "AUTHOR" 
 
-This manual page was written by Frank Küster <frank@kuesterei.ch>,
+This manual page was written by Frank K\[:u]ster <frank@kuesterei.ch>,
 for the Debian GNU/Linux system.  It may be used and modified by
 others without contacting the author.
diff --git a/Master/texmf/doc/man/man1/mpost.1 b/Master/texmf/doc/man/man1/mpost.1
index 59fcb7c1a16..bc6e3a7bfeb 100644
--- a/Master/texmf/doc/man/man1/mpost.1
+++ b/Master/texmf/doc/man/man1/mpost.1
@@ -461,10 +461,19 @@ CSTR 164, AT&T Bell Labs,
 (the journal of the \*(TX Users Group).
 .\"=====================================================================
 .SH "SEE ALSO"
-.BR tex (1),
-.BR texexec (1),
+.PP
+.BR dvips (1),
+.BR dvitomp (1),
+.BR epstopdf (1),
 .BR mf (1),
-.BR dvips (1).
+.BR mpto (1),
+.BR mptopdf (1),
+.BR pdftex (1),
+.BR tex (1),
+.BR texexec (1).
+.PP
+.URL "http://sarovar.org/projects/metapost/" "MetaPost source code" .
+
 .\"=====================================================================
 .SH AUTHORS
 \*(MP was designed by John D. Hobby, incorporating algorithms from 
diff --git a/Master/texmf/doc/man/man1/mptopdf.1 b/Master/texmf/doc/man/man1/mptopdf.1
index 6977b078da0..3c547f06aa8 100644
--- a/Master/texmf/doc/man/man1/mptopdf.1
+++ b/Master/texmf/doc/man/man1/mptopdf.1
@@ -87,17 +87,18 @@ mptopdf --latex figs.mp
 .EE 
 
 .SH "SEE ALSO" 
-.IP \(bu
+.PP
 .BR tex (1),
 .BR latex (1),
 .BR mpost (1),
+.BR pdftex (1),
 .BR texexec (1).
-.IP \(bu
+.PP
 .URL "http://www.contextgarden.net" "ConTeXt wiki" .
 
 .SH "AUTHOR" 
 .BR mptopdf (1)
-is part of the ConTeXt package available from
-.URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" .
+is part of the ConTeXt system by Hans Hagen et al, which is available from
+.URL "http://www.pragma-ade.com/" "PRAGMA ADE" .
 This manpage was written by Sanjoy Mahajan <sanjoy@mit.edu> and is in
 the public domain.
diff --git a/Master/texmf/doc/man/man1/pdfetex.1 b/Master/texmf/doc/man/man1/pdfetex.1
index ee65eaa6a99..6da1dca29ca 100644
--- a/Master/texmf/doc/man/man1/pdfetex.1
+++ b/Master/texmf/doc/man/man1/pdfetex.1
@@ -84,9 +84,12 @@ In
 mode, pdfe\*(TX can natively handle the
 .IR PDF ,
 .IR JPG ,
+.IR JBIG2 ,
 and
 .I PNG
-graphics formats.
+graphics formats.  pdfe\*(TX cannot include PostScript or Encapsulated
+PostScript (EPS) graphics files; first convert them to PDF using 
+.BR epstopdf (1).
 pdfe\*(TX's handling of its command-line arguments is similar to that of
 of the other \*(TX programs in the
 .I web2c
@@ -474,14 +477,14 @@ More about the list can be found at the
 website.
 .\"=====================================================================
 .SH "SEE ALSO"
-.BR tex (1),
-.BR mf (1),
 .BR etex (1),
-.BR pdftex (1).
+.BR mf (1),
+.BR pdftex (1),
+.BR tex (1).
 .\"=====================================================================
 .SH AUTHORS
 The primary authors of pdfe\*(TX are Han The Thanh, Petr Sojka,
-Jiri Zlatuska, and Peter Breitenlohner (e\*TX).
+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/Master/texmf/doc/man/man1/pdftex.1 b/Master/texmf/doc/man/man1/pdftex.1
index 3477e27dd02..f6c26bfda42 100644
--- a/Master/texmf/doc/man/man1/pdftex.1
+++ b/Master/texmf/doc/man/man1/pdftex.1
@@ -1,4 +1,4 @@
-.TH PDFTEX 1 "8 Jan 2007" "pdftex 1.40" "Web2C 7.5.6"
+.TH PDFTEX 1 "8 January 2007" "pdftex 1.40" "Web2C 7.5.6"
 .\"=====================================================================
 .if n .ds MF Metafont
 .if t .ds MF M\s-2ETAFONT\s0
@@ -88,7 +88,9 @@ mode, pdf\*(TX can natively handle the
 .IR JBIG2 ,
 and
 .I PNG
-graphics formats.
+graphics formats.  pdf\*(TX cannot include PostScript or Encapsulated
+PostScript (EPS) graphics files; first convert them to PDF using 
+.BR epstopdf (1).
 pdf\*(TX's handling of its command-line arguments is similar to that of
 of the other \*(TX programs in the
 .I web2c
@@ -476,13 +478,17 @@ More about the list can be found at the
 website.
 .\"=====================================================================
 .SH "SEE ALSO"
-.BR tex (1),
+.BR epstopdf (1),
 .BR etex (1),
+.BR latex (1),
+.BR mptopdf (1),
+.BR tex (1),
+.BR texexec (1),
 .BR mf (1).
 .\"=====================================================================
 .SH AUTHORS
 The primary authors of pdf\*(TX are Han The Thanh, Petr Sojka,
-Jiri Zlatuska, and Peter Breitenlohner (e\*TX).
+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/Master/texmf/doc/man/man1/pdftools.1 b/Master/texmf/doc/man/man1/pdftools.1
index f028b1ffb91..cc65658635a 100644
--- a/Master/texmf/doc/man/man1/pdftools.1
+++ b/Master/texmf/doc/man/man1/pdftools.1
@@ -41,17 +41,16 @@ bounding boxes, ...  See also \fBpdfinfo\fP(1).
 Print the number of pages in each PDF file.
 
 .SH "SEE ALSO" 
-
-.IP \(bu
+.PP
 \fBtexexec\fP(1), \fBpdfinfo\fP(1), \fBpdftk\fP(1)
-.IP \(bu
+.PP
 The pdftools manual \f(CWmpdftools.pdf\fP
 available from
 .URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" .
-.IP \(bu
+.PP
 .URL "http://www.contextgarden.net" "ConTeXt wiki" .
-.IP \(bu
-The PDF specification <http://www.adobe.com/devnet/pdf/pdf_reference.html>
+.PP
+.URL "http://www.adobe.com/devnet/pdf/pdf_reference.html" "The PDF specification" .
 
 .SH "AUTHOR" 
 
diff --git a/Master/texmf/doc/man/man1/pstopdf.1 b/Master/texmf/doc/man/man1/pstopdf.1
index 24b3fe68c74..972f364cb19 100644
--- a/Master/texmf/doc/man/man1/pstopdf.1
+++ b/Master/texmf/doc/man/man1/pstopdf.1
@@ -32,12 +32,12 @@ Print usage and version information.
 .B --convert
 Convert EPS to PDF.  This option is assumed if none is given.
 .TP
-.BI --method= string
+.BI --method=\fIstring\fP
 What method to use for bounding boxes when converting to PDF.
 Specify one of \fBcrop\fP, \fBbounded\fP (the default), or \fBraw\fP.
 Older versions of ConTeXt used numerical methods (1, 2, or 3).
 .TP 
-.BI --resolution= string
+.BI --resolution=\fIstring\fP
 The resolution to use when when converting to pdf.
 Specify one of \fBlow\fP, \fBnormal\fP, \fBmedium\fP, \fBhigh\fP,
 \fBprinter\fP, \fBprint\fP, \fBscreen\fP, \fBebook\fP, or
@@ -55,18 +55,19 @@ To make \fIcow.pdf\fP:
 .EX
 pstopdf cow.eps
 .EE
-or (one of several equivalences):
+or (one of several equivalents):
 .EX
 pstopdf --convert cow.eps cow.pdf
 .EE
 
 
 .SH "SEE ALSO" 
-.IP \(bu
+.PP
 .BR epstopdf (1),
 .BR mptopdf (1),
+.BR ps2pdf (1),
 .BR texexec (1).
-.IP \(bu
+.PP
 .URL "http://www.contextgarden.net" "ConTeXt wiki" .
 
 .SH "AUTHOR" 
diff --git a/Master/texmf/doc/man/man1/texexec.1 b/Master/texmf/doc/man/man1/texexec.1
index 2cb3e94ca5f..19f56dab96b 100644
--- a/Master/texmf/doc/man/man1/texexec.1
+++ b/Master/texmf/doc/man/man1/texexec.1
@@ -575,60 +575,22 @@ Generate format (.fmt) files used by ConTeXt (used during installation):
 steps have to be taken to get \fBtexexec\fP to work beyond installing
 ruby and having the \fBruby\fP(1) binary in your path.
 
-.SH "ENCODINGS" 
-.IP 
-Some languages require specific character encodings to represent their
-alphabets (beyond the basic ASCII encoding).  Although you can use TeX
-commands to represent these characters, such as ``\f(CW\e.z\fP'', it's
-easier to use a text editor that includes direct support for these
-characters and let ConTeXt translate them to the necessary TeX
-commands.  For some languages, this approach can also improve the
-performance of TeX's hyphenation algorithms.
-.IP 
-ConTeXt supports several of the most commonly used encodings.
-Check the files beginning with \fIenco-\fP, \fIlang-\fP, and
-\fIfont-\fP in the ConTeXt distribution for more information.
-.IP 
-\fBweb2c\fP distributions (such as \fBteTeX\fP) support a mechanism to
-map document encodings to ConTeXt's internal encoding, font
-encodings, and hyphenation patterns.  \fBtexexec\fP provides a document
-option and a command-line flag to pass the necessary information to
-\fBtex\fP(1) or \fBpdftex\fP(1).  You can add lines such as
-.EX 
-\f(CW%& --translate-file=cp1250pl\fP
-.EE 
-
-or
-
-.EX 
-\f(CW% --translate=cp1250pl\fP
-.EE 
-
-to the beginning of your document, or you can specify the \fB--translate\fP
-flag on the command line, as 
-.EX 
-\f(CWtexexec --translate=il2pl somefile\fP
-.EE 
-
-Using language-specific encodings will make your file less
-portable than using ASCII.  It may then not be possible for other people to
-typeset your documents on their systems. 
-
 .SH "SEE ALSO" 
-.IP \(bu
-\fBbibtex\fP(1), \fBdvipdfmx\fP(1), \fBdvips\fP(1), \fBfmtutil\fP(1),
-\fBmakeindex\fP(1), \fBmpost\fP(1),
-\fBpdftex\fP(1), \fBpdftk\fP(1), \fBxetex\fP(1),
-\fBruby\fP(1), \fBpsnup\fP(1), \fBtex\fP(1), \fBtexshow\fP(1),
-\fBtexutil\fP(1).
-.IP \(bu
+.PP
+\fBbibtex\fP(1), \fBctxtools\fP(1), \fBdvipdfmx\fP(1), \fBdvips\fP(1),
+\fBfmtutil\fP(1), \fBmakeindex\fP(1), \fBmpost\fP(1),
+\fBmptopdf\fP(1), \fBpdftex\fP(1), \fBpdftk\fP(1), \fBruby\fP(1),
+\fBpsnup\fP(1), \fBtex\fP(1), \fBtexfont\fP(1), \fBtexmfstart\fP(1),
+\fBtexshow\fP(1),
+\fBtexutil\fP(1), \fBxetex\fP(1).
+.PP
 The texexec manual 
 .IR mtexexec.pdf ,
 available from
 .URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" .
-.IP \(bu
+.PP
 Donald E. Knuth's \fIThe TeXbook\fP.
-.IP \(bu
+.PP
 .URL "http://www.contextgarden.net" "ConTeXt wiki" .
 
 .SH "AUTHOR" 
diff --git a/Master/texmf/doc/man/man1/texfind.1 b/Master/texmf/doc/man/man1/texfind.1
index ca39d87599b..8566784a825 100644
--- a/Master/texmf/doc/man/man1/texfind.1
+++ b/Master/texmf/doc/man/man1/texfind.1
@@ -1,4 +1,4 @@
-.TH "TEXFIND" "1" "December 2006" "texfind" "ConTeXt" 
+.TH "TEXFIND" "1" "January 2007" "texfind" "ConTeXt" 
 .de URL
 \\$2 \(laURL: \\$1 \(ra\\$3
 ..
@@ -66,22 +66,30 @@ Other options probably exist.   I appreciate input by the program
 authors, experienced users, or Perl geeks.
 .HP
 .SH "SEE ALSO" 
-
-.IP \(bu
-\fBperl\fP(1), \fBperlre\fP(1).
-.IP \(bu
+.PP
+\fBperl\fP(1), \fBperlre\fP(1),
+.BR texmfstart (1).
+.PP
 .URL "http://www.contextgarden.net" "ConTeXt wiki" .
 
 .SH "BUGS" 
 
-None known. However, the replace function isn't the most useful one.
+If the \fItexfind\fP wrapper script is not installed, then you may
+have to run \fBtexfind\fP as follows:
+.EX
+texmfstart texfind.pl \fI[ options ]\fP
+.EE
+See 
+.BR texmfstart (1).
+
+The replace function isn't the most useful one.
 
 .SH "AUTHOR" 
 
 \fBtexfind\fP was written for the ConTeXt package by Hans Hagen and
 Ton Otten, PRAGMA.
 
-This manual page was written by Frank Küster <frank@kuesterei.ch>
+This manual page was written by Frank K\[:u]ster <frank@kuesterei.ch>
 for the Debian GNU/Linux system, and modified by Sanjoy Mahajan
 <sanjoy@mit.edu>.  It may be used and modified by
 others without contacting the authors.
diff --git a/Master/texmf/doc/man/man1/texfont.1 b/Master/texmf/doc/man/man1/texfont.1
index 07071d1cc2f..fcd44eded09 100644
--- a/Master/texmf/doc/man/man1/texfont.1
+++ b/Master/texmf/doc/man/man1/texfont.1
@@ -76,24 +76,24 @@ directory)
 \fB\-\-help\fR : show some more info
 .HP
 .SH "SEE ALSO" 
-.IP \(bu
+.PP
 \fBtexexec\fP(1), \fBfontinst\fP(1), \fBperl\fP(1), \fBtexshow\fP(1).
-.IP \(bu
+.PP
 The ConTeXt Font manual, \fImfonts.pdf\fP
 available from
 .URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" .
-.IP \(bu
+.PP
 The TeXFont manual, \fImtexfont.pdf\fP
-.IP \(bu
+.PP
 The TeXExec manual, \fImtexexec.pdf\fP.
-.IP \(bu
+.PP
 .URL "http://www.contextgarden.net" "ConTeXt wiki" .
-.IP \(bu
+.PP
 Donald E. Knuth\'s \fIThe TeXbook\fP.
 
 .SH "AUTHOR" 
 
-This manual page was written by Frank Küster <frank@kuesterei.ch>,
+This manual page was written by Frank K\[:u]ster <frank@kuesterei.ch>,
 for the Debian GNU/Linux system, and  modified by Sanjoy Mahajan
 <sanjoy@mit.edu>.  It may be used and modified by others without
 contacting the authors.
diff --git a/Master/texmf/doc/man/man1/texmfstart.1 b/Master/texmf/doc/man/man1/texmfstart.1
index 75240d8afe6..1310422261f 100644
--- a/Master/texmf/doc/man/man1/texmfstart.1
+++ b/Master/texmf/doc/man/man1/texmfstart.1
@@ -26,8 +26,7 @@ the .BR tex (1)
 family of programs.
 .B texmfstart
 is a ConTeXt meta-script that can run subordinate
-scripts (subscripts?) such
-as 
+scripts (subscripts?) such as 
 .BR texexec (1),
 .BR ctxtools (1),
 or
@@ -324,7 +323,7 @@ The environment variables are looked up in that order, with the first
 setting found taking priority.
 
 .SH "SEE ALSO" 
-.IP \(bu
+.PP
 .BR ctxtools (1),
 .BR kpsewhich (1),
 .BR makempy (1),
@@ -334,9 +333,9 @@ setting found taking priority.
 .BR texexec (1),
 .BR texfont (1),
 .BR texutil (1).
-.IP \(bu
+.PP
 .URL "http://www.contextgarden.net" "ConTeXt wiki" .
-.IP \(bu
+.PP
 The
 .B texmfstart
 manual,
@@ -358,6 +357,6 @@ prefix (i.e. it does a real run instead of a dry run).
 ConTeXt is written and maintained by 
 .URL "http://www.pragma-ade.com" "Hans Hagen" .
 This man page, which is in the public domain, was written by Sanjoy
-Mahajan based on the
+Mahajan <sanjoy@mit.edu> based on the
 .I mtexmfstart.pdf
 manual.
diff --git a/Master/texmf/doc/man/man1/textools.1 b/Master/texmf/doc/man/man1/textools.1
new file mode 100644
index 00000000000..1ef91a50b1b
--- /dev/null
+++ b/Master/texmf/doc/man/man1/textools.1
@@ -0,0 +1,104 @@
+.TH TEXTOOLS "1" "January 2007" "textools 1.3.1" "ConTeXt"
+.de URL
+\\$2 \(laURL: \\$1 \(ra\\$3
+..
+.if \n[.g] .mso www.tmac
+.de EX
+.in +3
+.nf
+.ft CW
+..
+.de EE
+.in -3
+.ft R
+.fi
+..
+
+.SH NAME
+textools \- generate TeX map files, afm files, fix texmf trees
+
+.SH "SYNOPSIS" 
+\fBtextools\fP [ \fIOPTIONS\fP ...  ] [ \fIpattern\fR or \fIname\fR
+\fRor \fIfromroot toroot\fR  ] [ \fIMODIFIER OPTIONS\fP ...  ]
+
+.SH DESCRIPTION
+\fBtextools\fP processes map files, converts Mac files to DOS format,
+generates map files, fixes texmf trees, and performs a
+utility-belt worth of other tasks also useful in installing and
+maintaining the zillion auxilliary files that
+.BR tex (1)
+and its friends require.
+
+.SH OPTIONS
+The modifier options are listed after the options that
+they modify.
+.TP
+\fB--downcasefilenames\fP [\fB--recurse\fP] [\fB--force\fP]
+.TP
+\fB--encmake\fP \fIafmfile\fP \fIencodingname\fP
+.TP
+\fB--findfile\fP \fIfilename\fP [\fB--recurse\fP]
+.TP
+\fB--fixafmfiles\fP [\fIpattern\fP] [\fB--recurse\fP]
+.TP
+\fB--fixtexmftrees\fP [\fItexmfroot\fP] [\fB--force\fP]
+.TP
+\fB--hidemapnames\fP [\fIpattern\fP] [\fB--recurse\fP]
+.TP
+\fB--mactodos\fP [\fIpattern\fP] [\fB--recurse\fP]
+Fixes newlines from Macintosh files so that the file is readable in DOS.
+.TP
+\fB--removemapnames\fP [\fIpattern\fP] [\fB--recurse\fP]
+.TP
+\fB--replacefile\fP \fIfilename\fP [\fB--force\fP]
+.TP
+\fB--restoremapnames\fP [\fIpattern\fP] [\fB--recurse\fP]
+.TP
+\fB--showfont\fP \fIfilename\fP
+.TP
+\fB--stripformfeeds\fP [\fB--recurse\fP] [\fB--force\fP]
+.TP
+\fB--tpmmake\fP \fItpmfile\fP
+Package files into a \fIt-modulename.tpm\fP file.  Imagine this file
+structure:
+.EX
+tex/context/third/modulename/t-modulename.vim
+doc/context/third/modulename/modulename-doc.pdf
+doc/context/third/modulename/modulename-demo.pdf
+tpm/t-modulename.tpm
+.EE
+where \fIt-modulename.tpm\fP is a valid tpm file.  When you run
+.EX
+textools --tpmmake t-modulename
+.EE
+the \fBtextools\fP command will replace file sizes declared in the tpm
+file with proper values and create a ZIP archive \fIt-modulename.zip\fP
+with the files specified by the tpm file.  This command needs to be
+run in the root of the TEXMF tree.
+.TP
+\fB--unzipfiles\fP [\fIpattern\fP] [\fB--recurse\fP]
+.TP
+\fB--updatetree\fP \fIfromroot\fP \fItoroot\fP [\fB--force\fP \fB--nocheck\fP \fB--merge\fP \fB--delete\fP]
+.TP
+\fB--videmapnames\fP [\fIpattern\fP] [\fB--recurse\fP]
+
+.SH "SEE ALSO" 
+.PP
+.BR texexec (1),
+.BR texmfstart (1).
+.PP
+.URL "http://www.contextgarden.net" "ConTeXt wiki" .
+
+.SH BUGS
+This manual page is incomplete because I have no clue what this
+program does.
+
+.SH "AUTHOR" 
+.BR textools (1)
+is part of the 
+.URL "http://www.contextgarden.net" "ConTeXt" " "
+suite of typesetting programs based on the
+.BR tex (1)
+family of typesetting programs.  This manual page was written by
+Sanjoy Mahajan <sanjoy@mit.edu> based on running \fBtextools --help\fP
+and with help from Mojca Miklavec.  It is in the public domain.
diff --git a/Master/texmf/doc/man/man1/texutil.1 b/Master/texmf/doc/man/man1/texutil.1
index 51ac904d503..f26468fd4e6 100644
--- a/Master/texmf/doc/man/man1/texutil.1
+++ b/Master/texmf/doc/man/man1/texutil.1
@@ -19,4 +19,5 @@ deprecated and many of its features are available in
 
 .SH "AUTHOR" 
 
-This skeleton man page was written by Sanjoy Mahajan <sanjoy@mit.edu>.
+This incomplete man page was written by Sanjoy Mahajan
+<sanjoy@mit.edu> and is in the public domain.