path: root/mcon/man/mxref.SH
diff options
Diffstat (limited to 'mcon/man/mxref.SH')
1 files changed, 133 insertions, 0 deletions
diff --git a/mcon/man/mxref.SH b/mcon/man/mxref.SH
new file mode 100755
index 0000000..e66b504
--- /dev/null
+++ b/mcon/man/mxref.SH
@@ -0,0 +1,133 @@
+case $CONFIG in
+ if test -f; then TOP=.;
+ elif test -f ../; then TOP=..;
+ elif test -f ../../; then TOP=../..;
+ elif test -f ../../../; then TOP=../../..;
+ elif test -f ../../../../; then TOP=../../../..;
+ else
+ echo "Can't find"; exit 1
+ fi
+ . $TOP/
+ ;;
+case "$0" in
+*/*) cd `expr X$0 : 'X\(.*\)/'` ;;
+echo "Extracting mcon/man/metaxref.$manext (with variable substitutions)"
+$rm -f metaxref.$manext
+$spitshell >metaxref.$manext <<!GROK!THIS!
+''' @(#) Manual page for metaxref
+''' $Id: mxref.SH,v 1997/02/28 16:30:39 ram Exp $
+''' Copyright (c) 1991-1993, 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
+''' that same Artistic Licence; a copy of which may be found at the root
+''' of the source tree for dist 3.0.
+''' $Log: mxref.SH,v $
+''' Revision 1997/02/28 16:30:39 ram
+''' patch61: new -L option to match metaconfig and metalint
+''' Revision 1994/10/29 16:34:26 ram
+''' patch36: the leading .TH was referring to metaconfig
+''' Revision 1993/10/16 13:52:46 ram
+''' patch12: added BUGS section
+''' Revision 1993/08/19 06:42:25 ram
+''' patch1: leading searching was not aborting properly
+''' Revision 3.0 1993/08/18 12:10:15 ram
+''' Baseline for dist 3.0 netwide release.
+metaxref \- builds cross-reference file/unit/item information
+.B metaxref
+[ \-\fBdhkmsV\fR ] [ \fB\-f\fI manifest\fR ]
+[ \-\fBL \fIdir\fR ]
+.I Metaxref
+is a program that scans all the files in your MANIFEST file and produces
+three files which contains information about how the files in that MANIFEST
+reference items defined by metaconfig's unit files.
+The first two files,
+.I I.fui
+.I I.uif
+reference the \fIfile\fR, \fIunit\fR and \fIitems\fR sorted differently. The
+third file, \fIObsolete\fR, dumps all the known obsolete symbols, in which
+file they appear and the new symbol that should be used instead.
+Note that obsolete symbols do not appear in the main cross-reference files,
+but are only listed in the \fIObsolete\fR file. That's yet another incentive
+to use the new symbols in your sources. :-)
+.I Metaxref
+recognizes the following options:
+.TP 10
+.B \-d
+Turn on debug mode.
+.B \-f\fI manifest\fR
+Use an alternate \fImanifest\fR file.
+.B \-h
+Print help message and exit.
+.B \-k
+Keep temporary \fI.MT\fR directory.
+.B \-m
+Assume lots of memory and swap space. This will drastically improve the
+symbol lookup time in your source files, at the expense of memory usage.
+.B \-s
+Turn on silent mode.
+.B \-L\fI dir\fR
+Override default library location (where the \fIU\fR units directory
+can be found).
+.B \-V
+Print version number and exit.
+Harlan Stenn <>
+.TP 10
+.PD 0
+Public unit files.
+Private unit files
+Lists information sorted by file, unit and item.
+Lists information sorted by unit, item and file.
+Lists all the obsolete symbols used by the sources.
+.sp +5
+where LIB is $privlibexp. -5
+Metaxref will list among the wanted items all those magic symbols defined
+within units on the ?M: lines. Those are relevant only when metaconfig is
+invoked with the \fB\-M\fR option.
+metaconfig($manext), metalint($manext)
+chmod 444 metaxref.$manext