1 files changed, 37 insertions, 5 deletions
diff --git a/mcon/man/mconfig.SH b/mcon/man/mconfig.SH
index 7728439..112c6f1 100755
--- a/mcon/man/mconfig.SH
+++ b/mcon/man/mconfig.SH
@@ -20,10 +20,10 @@ $spitshell >metaconfig.$manext <<!GROK!THIS!
 .TH METACONFIG $manext "Version $VERSION PL$PATCHLEVEL"
 .\" @(#) Manual page for metaconfig
 .\"
-.\" $Id: mconfig.SH 25 2008-05-28 11:19:25Z rmanfredi $
+.\" $Id$
 .\"
 .\"  Copyright (c) 1991-1997, 2004-2006, Raphael Manfredi
-.\"
+.\"  
 .\"  You may redistribute only under the terms of the Artistic Licence,
 .\"  as specified in the README file that comes with the distribution.
 .\"  You may reuse parts of this distribution only within the terms of
@@ -32,7 +32,7 @@ $spitshell >metaconfig.$manext <<!GROK!THIS!
 .\"
 .\" $Log: mconfig.SH,v $
 .\" Revision 3.0.1.17  1997/02/28  16:29:31  ram
-.\" patch61: documents the running environment and the src.U unit
+.\" patch61: documents the runnning environment and the src.U unit
 .\" patch61: added warnings for $_a and $_o, as well as "startsh"
 .\"
 .\" Revision 3.0.1.16  1995/09/25  09:17:48  ram
@@ -349,7 +349,7 @@ Put the unit into the public or private U directory as appropriate.
 .IP \(bu
 Rerun \fImetaconfig\fR.
 .IP \(bu
-Send your unit to ram@acri.fr (Raphael Manfredi) for inclusion
+Send your unit to Raphael.Manfredi@pobox.com (Raphael Manfredi) for inclusion
 in the master copy, if you think it's of general interest.
 .PP
 In order to add a new program to be located:
@@ -528,6 +528,19 @@ option permanently.
 .TP
 .B \-V
 Print version number and exit.
+.TP
+\fB\-X\fI file\fR
+When examining the source files, ignore any symbols listed in the \fIfile\fR.
+This is useful in situations where a particular unit is known not to be needed
+for your package's portability targets, but your source files nevertheless
+contain occurrences of words that look to \fImetaconfig\fR like symbols defined
+in that unit. (For example, you might need the word "index" in a source file,
+but not need the unit that determines whether \fIstrcpy\fR or \fIindex\fR
+should be used.)
+The \fIfile\fR can contain blank lines, comment lines introduced with '#', and
+lines containing a single symbol.
+If this option is not supplied, any \fI$exclusions_file\fR variable in
+\fI.package\fR is honored instead.
 .\"
 .\" T u t o r i a l
 .\"
@@ -1729,6 +1742,25 @@ before prompting via \fIgetfile\fR for instance. If the prefix does not
 make use of ~name expanstion, then the above will be a no-op on the \fI$dflt\fR
 variable, naturally.
 .TP
+Specific.U
+This unit is empty by default.  It is meant as a project-specific hook
+to have shell code executed by \fIConfigure\fR after \fIconfig.sh\fR was
+generated but before the extraction of .SH files.
+.sp
+Copy the unit to your project's \fIU/\fR directory and customize it.
+.sp
+Here is what the \fIdist\fR project uses it for (showing only the unit's code,
+not the full unit here):
+.Ex
+: project-specific code
+file=revision.h
+echo " "
+echo "Generating \$file..." >&4
+bin/svn-revision . \$file
+.Ef
+That shell code is executed when \fIConfigure\fR is back to the top directory
+of the source tree.
+.TP
 Typedef.U
 This unit produces the \fI\$typedef\fR shell variable, used internally by
 \fIConfigure\fR to check whether a typedef exists or not. A typical
@@ -2077,7 +2109,7 @@ Larry Wall <lwall@netlabs.com> for version 2.0.
 .br
 Harlan Stenn <harlan@mumps.pfcs.com> for important unit extensions.
 .br
-Raphael Manfredi <ram@hptnos02.grenoble.hp.com>.
+Raphael Manfredi <Raphael.Manfredi@pobox.com>.
 .br
 Many other contributors for the
 \fImetaconfig\fR units. See the credit file for a list.