Annotation of researchv10no/cmd/sml/doc/makeml.1, revision 1.1.1.1

1.1       root        1: .TH MAKEML 1
                      2: .SH NAME
                      3: makeml \- build the Standard ML of New Jersey system
                      4: .SH SYNOPSIS
                      5: .B makeml
                      6: options
                      7: .br
                      8: .SH DESCRIPTION
                      9: \fIMakeml\fP is a tool for building the Standard ML of New Jersey system (sml)
                     10: from source and `.mo' files.
                     11: For the standard installation the only options required are the machine type and
                     12: operating system.
                     13: There are also options to build a version with the compiler object code in the
                     14: heap instead of the text segment and to build the batch compiler.
                     15: For example
                     16: .RS
                     17: makeml \-vax \-bsd \-noshare
                     18: .RE
                     19: builds the vax version of the interactive system to run on bsd systems with
                     20: the compiler object code in the heap.
                     21: For the sun-3 and sun-4 versions, the operating system is implicit; furthermore,
                     22: \fImakeml\fP is able to determine which kind of sun it is running on,
                     23: so the machine option is not required either.
                     24: .SH OPTIONS
                     25: The following basic options are the only ones needed for normal use.
                     26: .TP
                     27: .BI \-sun3
                     28: .br
                     29: .ns
                     30: .TP
                     31: .BI \-m68
                     32: Build the sun-3 version of the system.
                     33: This implies the \fB-bsd\fP option.
                     34: .TP
                     35: .BI \-sun4
                     36: .br
                     37: .ns
                     38: .TP
                     39: .BI \-sparc
                     40: Build the sun-4 version of the system.
                     41: This implies the \fB-bsd\fP option.
                     42: .TP
                     43: .BI \-next
                     44: Build the NeXT version of the system.
                     45: This implies the \fB-bsd\fP option with -DMACH.
                     46: .TP
                     47: .BI \-encore
                     48: Build the Encore Multimax (ns32032 processor) version of the system.
                     49: This implies the \fB-bsd\fP option.
                     50: .TP
                     51: .BI \-vax
                     52: Build the vax version of the system.
                     53: For the vax an operating system option must be specified.
                     54: .TP
                     55: .BI \-bsd
                     56: Build a version that runs under bsd unix.
                     57: .TP
                     58: .BI \-ultrix
                     59: Build a version that runs under ultrix.
                     60: .TP
                     61: .BI \-v9
                     62: Build a version that runs under v9 unix.
                     63: .TP
                     64: .BI \-batch
                     65: Build the batch compiler instead of an interactive system.
                     66: .TP
                     67: .BI \-noshare
                     68: Do not link the `.mo' files into an `a.out' format object file and include it in the
                     69: runtime executable.
                     70: .TP
                     71: .BI \-i
                     72: Make the `sml' image start out using the interpreter for faster compilation
                     73: and slower execution (for interactive system only; can switch
                     74: back to native code once in
                     75: `sml' by `System.Control.interp := false').
                     76: .TP
                     77: .BI \-ionly
                     78: Make the `sml' image start out using the interpreter for faster compilation
                     79: and slower execution (for interactive system only), and eliminate
                     80: the code generator from the executable to save space.
                     81: .TP
                     82: .BI \-o " image"
                     83: Use image as the name of the system image.
                     84: The default image name is `sml' for interactive systems and `batch' for the
                     85: batch compiler.
                     86: .PP
                     87: The following options may be used to tune garbage collection and paging performance.
                     88: .TP
                     89: .BI \-h " heapsize"
                     90: Set the initial heap size to \fIheapsize\fP kilo-bytes.
                     91: .TP
                     92: .BI \-m " softlimit"
                     93: Set the soft limit on the heap size to \fIsoftlimit\fP kilo-bytes.
                     94: .TP
                     95: .BI \-r " ratio"
                     96: Set the ratio of the heap size to live data to \fIratio\fP.
                     97: This must be at least 3.
                     98: .PP
                     99: The following options are for building and testing new versions of the system; they
                    100: are not necessary for normal installation.
                    101: .TP
                    102: .BI \-run
                    103: Build the run-time kernel (`runtime/run'), but don't build a system.
                    104: .TP
                    105: .BI \-noclean
                    106: Don't remove the existing `.o' files in the runtime directory.
                    107: .TP
                    108: .BI \-norun
                    109: Don't re-compile the runtime kernel.
                    110: This implies the \fB-noclean\fP option.
                    111: .TP
                    112: .BI \-target " machine"
                    113: Build a batch cross compiler for \fImachine\fP.
                    114: For example, to build a \fBvax\fP to \fBsparc\fP cross compiler
                    115: .ti +0.5i
                    116: makeml \-vax \-bsd \-target sparc
                    117: .br
                    118: This option implies the \fB-batch\fP option.
                    119: .TP
                    120: .BI \-mo " path"
                    121: Use \fIpath\fP as the directory containing the `.mo' files.
                    122: .TP
                    123: .BI \-runtime " path"
                    124: Use \fIpath\fP as the source directory for the runtime code.
                    125: .TP
                    126: .BI \-D def
                    127: When compiling the runtime code add ``\fB-D\fP\fIdef\fP'' as a command line option.
                    128: .SH "SEE ALSO"
                    129: linkdata(1)
                    130: .SH AUTHOR
                    131: John Reppy
                    132: .SH BUGS
                    133: This will not work with the sun cross-compilers (really a problem with the
                    134: runtime makefile).

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.