Suggested patch to updmap.man

Hi teTeX testers, hi Thomas,

I learned only today that if updmap is called with the options
"--enable", "--disable" or "--setoption", it changes
updmap.cfg. Previously I thought this was meant only for non-root users,
together with --outputdir, and had no permanent effect. I suspect that I
am not the only one who had this misconception. Otherwise
"update-updmap", a Debian-specific script that allows TeX-related
packages to add their font information to updmap.cfg, would probably not
have been invented.

Therefore I suggest the following patch to updmap.man. Perhaps the
addition of the paragraph is enough, and with it we don't even need to
add "Permanently" with the options.

--- texk/tetex/updmap.man.orig	Fri Sep 24 15:57:06 2004
+++ texk/tetex/updmap.man	Fri Sep 24 15:57:07 2004
@@ -30,6 +30,10 @@
 following heuristic: if VARTEXMF is set and the VARTEXMF
 tree contains a writable \fBdvips/config\fP directory, that directory
 is used\&.  Otherwise \fBupdmap\fP uses the TEXMFMAIN directory\&.
+.PP
+When used with the options \fB--edit\fP, \fB--setoption\fP,
+\fB--enable\fP, or \fB--disable\fP, \fBupdmap\fP will also write to
+\fBupdmap\&.cfg\fP(5). 
 .PP 
 .SH "OPTIONS" 
 .PP 
@@ -77,11 +81,11 @@
 \fBpdftexDownloadBase14\fP
 .IP 
 .IP "\fB--enable\fP \fImaptype\fP \fImapfile\fP" 
-Add or enable a
+Permanently add or enable a
 Map or MixedMap\&.
 .IP 
 .IP "\fB--disable\fP \fImapfile\fP" 
-Disable Map or MixedMap for
+Permanently disable Map or MixedMap for
 \fImapfile\fP\&.
 .IP 
 .IP "\fB--listmaps\fP" 
@@ -93,7 +97,9 @@
 .IP "\fIupdmap\&.cfg\fP" 
 Main configuration file\&.  In
 \fItexmf/web2c\fP by default, but may be located elsewhere
-depending on your distribution\&.
+depending on your distribution\&. \fBNote for Debian\fP: On Debian
+that file is generated out of files sitting in \fI/etc/texmf/updmap.d\fP.
+See \fBupdate-updmap\fP(8) or \fIREADME.Debian\fP.
 .IP 
 .IP "\fIpdftex35\&.map\fP" 
 Map data for basic 35 PostScript files for
@@ -183,7 +189,7 @@
 .PP 
 .SH "SEE ALSO" 
 .PP 
-\fBupdmap\&.cfg\fP(5), \fBdvipdfm\fP(1), \fBdvips\fP(1),
+\fBupdmap\&.cfg\fP(5), \fBupdate-updmap\fP(8), \fBdvipdfm\fP(1), \fBdvips\fP(1),
 \fBgsftopk\fP(1), \fBpdftex\fP(1), \fBps2pk\fP(1),
 \fBtexhash\fP(1), \fBxdvi\fP(1)\&.
 .PP 





-- 
Frank Küster, Biozentrum der Univ. Basel
Abt. Biophysikalische Chemie