ml1
—
ML/I macro processor
ml1 |
[-v ] [-w
workspace] [-o
outputfile] [-o
outputfile] [-o
outputfile] [-o
outputfile] [-l
listingfile] [-d
debuggingfile] [file]
[file] [file]
[file] [file] |
ml1
is a general purpose macro processor which allows
its users to augment any existing programming language by adding new
statements (or other syntactic forms) of their own choosing and in their own
notation. These new features must be expandable in terms of the existing
language.
ml1
is also useful for systematic editing,
i.e. the replacement of one string, possibly involving parameters, by
another string throughout a program or any other piece of text.
This manual page merely summarises the ml1
command line options; consult the full ML/I documentation for anything
else.
The options are as follows:
-v
-
-V
- Print the version number of this implementation of
ml1
.
-w
n
-
-W
n
- Set the amount of workspace available to
ml1
to
n words (the default is 5000 words).
-l
file
-
-L
file
- Nominate file as the listing file. The default is
that no listing is produced. The name
-
is taken
to mean the standard output.
-d
file
-
-D
file
- Nominate file as the debugging file. By default,
this is the standard error stream (usually the user's terminal). The name
-
is taken to mean the standard output.
-o
file
-
-O
file
- Nominate file as an output file. Up to four output
files may be specified; each must be preceded by the
-o
flag. If no output files are specified, the
standard output is used. An output file named -
is
also taken to be the standard output.
All other arguments to ml1
are taken to be
the names of input files; there may be no more than five of these. If no
input file is specified, the standard input is used. The name
-
is also taken to mean the standard input.
The ml1
utility exits 0 on success,
and >0 if an error occurs.
R.D. Eager,
An ML/I tutorial,
2004.
R.D. Eager and
P.J. Brown, A simple introductory
guide to ML/I, Fourth Edition,
2004.
R.D. Eager and
P.J. Brown, ML/I User's Manual,
Sixth Edition, 2004.
R.D. Eager,
ML/I User's Manual, Appendix Y - Implementation on IBM PC
under FreeBSD, 2004.
All of the above documents are available from the ML/I web site,
⟨http://www.ml1.org.uk⟩.
Bob Eager ⟨rde@ml1.org.uk⟩.