more doc tweaks

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

1 files changed, 28 insertions, 22 deletions

diff --git a/Master/texmf/doc/man/man5/updmap.cfg.5 b/Master/texmf/doc/man/man5/updmap.cfg.5
index b2992d42de3..43a7cc2d23f 100644
--- a/Master/texmf/doc/man/man5/updmap.cfg.5
+++ b/Master/texmf/doc/man/man5/updmap.cfg.5
@@ -1,5 +1,5 @@
 .\" Hey, Emacs!  This is an -*- nroff -*- source file.
-.\" 
+.\"
 .\" Copyright (C) 2004, 2012 Hilmar Preusse <hille42@web.de>
 .\" Copyright (C) 2012 Norbert Preining <preining@logic.at> 
 .\" 
@@ -16,7 +16,7 @@
 .\" You should have received a copy of the GNU General Public License 
 .\" along with this program.  if not, see <http://www.gnu.org/licenses/>.
 .\" 
-.TH "UPDMAP.CFG" "5" "November 2012" "TeX Live" "TeX Live"
+.TH "UPDMAP.CFG" "20" "November 2012" "TeX Live" "TeX Live"
 .SH "NAME"
 \fBupdmap.cfg\fR \- configuration of font mapping/inclusion for dvips and
 friends.
@@ -39,6 +39,9 @@ configuration files for all of these programs from several sources,
 namely all \fBupdmap.cfg\fR, allowing you to easily keep all the different
 configuration files in sync\&.
 .P
+Running "updmap --help" will output the main documentation for using
+\fBupdmap\fR.
+.P
 \fBdvipsPreferOutline\fR
 .br
 Configures if \fBdvips\fR (by default) should prefer bitmap fonts or outline fonts
@@ -65,9 +68,9 @@ ADOBEkb: Adobe fonts with  "berry" filenames (e.g. phvbo8an.pfb)
 .P
 \fBdvipsDownloadBase35\fR
 .br
-Configures if \fBdvips\fR (by default) should download the standard 35 LaserWriter
-fonts into the document (set \fItrue\fR) or should these fonts be used from the ps
-interpreter / printer (set \fIfalse\fR).
+Configures if \fBdvips\fR (by default) should download the 35 base
+PostScript fonts into the document (set \fItrue\fR) or should these
+fonts be used from the ps interpreter / printer (set \fIfalse\fR).
 .br
 The user can override the default by specifying \fBdvips\fR \fI-Pdownload35\fR
 (resp. \fBdvips\fR \fI-Pbuiltin35\fR) to download the LW35 fonts
@@ -77,12 +80,12 @@ Valid settings are \fItrue\fR / \fIfalse\fR.
 .P
 \fBpdftexDownloadBase14\fR
 .br
-Should \fBpdftex\fR download the base 14 pdf fonts? Since some configurations
+Should \fBpdftex\fR download the 14 base PDF fonts? Since some configurations
 (ps / pdf tools / printers) use bad default fonts, it is safer to download
-the fonts. The pdf files will get bigger, though.
+the fonts. The pdf files get bigger, but that is the cost.
 .br
 Valid settings are \fItrue\fR (download the fonts) or \fIfalse\fR (don't
-download the fonts). Adobe recommends to embed all fonts.
+download the fonts). Adobe recommends embedding all fonts.
 .P
 \fBpxdviUse\fR
 .br
@@ -97,11 +100,11 @@ http://www.tug.org/texlive/updmap-kanji.html for detailed discussion.
 .br
 \fBkanjiVariant\fR
 .br
-The options kanjiEmbed and kanjiVariant specify special replacements
-in the map lines.  If a map contains the string @kanjiEmbed@, then
-this will be replaced by the value of that option; similarly for
-kanjiVariant.  In this way, users of Japanese TeX can select different
-fonts to be included in the final output.
+The options \fBkanjiEmbed\fR and \fBkanjiVariant\fR specify special
+replacements in the map lines.  In a map, the string "@kanjiEmbed@"
+will be replaced by the value of that option; similarly for
+\fBkanjiVariant\fR.  In this way, users of Japanese TeX can select
+different fonts to be included in the final output.
 .P
 \fBMap\fR
 .br
@@ -110,9 +113,8 @@ document) to the pfb file containing the Postscript code.
 .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.
+The syntax of map files is the same as \fBdvips\fP(1) uses, see the
+section "psfonts.map" in the manual of \fBdvips\fP(1).
 .P
 \fBMixedMap\fR
 .br
@@ -125,15 +127,17 @@ Usage: \fBMixedMap\fR filename.map
 .P
 \fBKanjiMap\fR
 .br
-Similar to \fBMap\fR. It should be used for kanji fonts.
+Similar to \fBMap\fR. This should be used for kanji fonts.
 .br
 Usage: \fBKanjiMap\fR filename.map
 .P
 The sign \fB#\fR precedes a comment.
 .P
-Not used Map files should be commented out using the string \fB#!\fR at the
-beginning of the line. These entries can be (de-)activated using \fBupdmap\fR
-with the options \fI--enable\fR and \fI--disable\fR.
+Map files not to be used should be commented out using the string
+\fB#!\fR at the beginning of the line. Such entries can be
+(de-)activated using \fBupdmap\fR with the options \fI--enable\fR and
+\fI--disable\fR, respectively.
+
 .SH "AUTHOR"
 This manual page was written by Hilmar Preusse <hille42@web.de> and 
 extended by Norbert Preining <preining@logic.at>, for
@@ -141,9 +145,11 @@ the Debian GNU/Linux system by simply copying the comments from
 \fBupdmap.cfg\fR and rewriting some of them. It may be used by other
 distributions without contacting the author. Any mistakes or omissions in
 the manual page are our fault; inquiries about or corrections to this manual
-page should be directed to tex-live@tug.org
+page should be directed to tex-live@tug.org.
+
 .SH "SEE ALSO"
-updmap(1), info page of dvips(1)
+updmap(1), dvips(1)
+
 .SH "THANKS TO"
 Frank Kuester,
 Thomas Esser.