[subversion-commit] SVN tetex commit + diffs: r168 - tetex-bin/trunk/new-manpages

[Frank Küster]

Author: frank
Date: 2005-08-24 16:02:54 +0000 (Wed, 24 Aug 2005)
New Revision: 168

Modified:
   tetex-bin/trunk/new-manpages/updmap.cfg.5
Log:
refined manpage for updmap.cfg a bit

Modified: tetex-bin/trunk/new-manpages/updmap.cfg.5
===================================================================
--- tetex-bin/trunk/new-manpages/updmap.cfg.5	2005-08-24 15:44:01 UTC (rev 167)
+++ tetex-bin/trunk/new-manpages/updmap.cfg.5	2005-08-24 16:02:54 UTC (rev 168)
@@ -22,9 +22,23 @@
 \fBupdmap.cfg\fR \- configuration of font mapping/inclusion for dvips and
 friends.
 .SH "DESCRIPTION"
-The file \fBupdmap.cfg\fR describes if and how fonts should be included (or
-not included) into PS-/PDF-files. This works for Outline (Postscript Type1)
-and Bitmap Fonts (Postscript Type3) mostly coming from MetaFont.
+The file \fBupdmap.cfg\fR is the central font configuration file of a
+teTeX system and is read by \fBupdmap\fP(1). It describes if and how
+fonts should be included (or not included) into PS-/PDF-files. This
+works for Outline (Postscript Type1) and Bitmap Fonts (Postscript
+Type3) mostly coming from MetaFont.
+.PP
+\fBupdmap\fP is a utility that creates font configuration files for
+\fBdvips\fP(1), \fBpdftex\fP(1), \fBxdvi\fP(1), \fBps2pk\fP(1),
+\fBgsftopk\fP(1), \fBdvipdfm\fP(1) and (soon) \fBdvipdfmx\fP(1)\&.  In
+an ideal world, updmap would be unnecessary -- each of these programs
+would read the same configuration file to learn what fonts are
+available and how they should be treated\&.  As things stand, however,
+each of these tools has subtly different requirements and thereby
+needs its own font configuration file\&.  \fBupdmap\fP creates font
+configuration files for all of these programs from a single source,
+\fBupdmap.cfg\fR, allowing you to easily keep all the different
+configuration files in sync\&.
 .P
 \fBdvipsPreferOutline\fR
 .br
@@ -87,6 +101,10 @@
 .br
 Usage: \fBMap\fR filename.map
 .P
+The syntax of map files is the same as \fBdvips\fP(1) uses, see
+section 6.4, "'psfonts.map': PostScript font catalog" in the manual of
+\fBdvips\fP(1), available as info and pdf file.
+.P
 \fBMixedMap\fR
 .br
 Similar to \fBMap\fR. It should be used when there is Type1 and a bitmap
@@ -115,5 +133,5 @@
 .SH "SEE ALSO"
 updmap(1), info page of dvips(1)
 .SH "THANKS TO"
-Frank K\(:uster,
+Frank Kuester,
 an unknown Thomas.
\ No newline at end of file