Annotation of researchv10no/cmd/sml/src/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: .SH OPTIONS
                     22: The following basic options are the only ones needed for normal use.
                     23: .TP
                     24: .BI \-sun3
                     25: .br
                     26: .ns
                     27: .TP
                     28: .BI \-m68
                     29: Build the sun-3 version of the system.
                     30: An operating system option must be specified (-sunos or -mach).
                     31: .TP
                     32: .BI \-sun4
                     33: .br
                     34: .ns
                     35: .TP
                     36: .BI \-sparc
                     37: Build the sun-4 version of the system.
                     38: An operating system option must be specified (-sunos or -mach).
                     39: .TP
                     40: .BI \-next
                     41: Build the NeXT version of the system (implies -m68).
                     42: .TP
                     43: .BI \-encore
                     44: Build the Encore Multimax (ns32032 processor) version of the system.
                     45: This implies the \fB-bsd\fP option.
                     46: .TP
                     47: .BI \-vax
                     48: Build the vax version of the system.
                     49: For the vax an operating system option must be specified.
                     50: .TP
                     51: .BI \-bsd
                     52: Build a version that runs under bsd unix.  For the Sun-3 or Sun-4,
                     53: you must specify either -sunos or -mach, not -bsd.
                     54: .TP
                     55: .BI \-sunos
                     56: Build a version that runs under SunOS.
                     57: .TP
                     58: .BI \-mach
                     59: Build a version that runs under Mach.
                     60: .TP
                     61: .BI \-ultrix
                     62: Build a version that runs under Ultrix.
                     63: .TP
                     64: .BI \-v9
                     65: Build a version that runs under v9 Unix.
                     66: .TP
                     67: .BI \-batch
                     68: Build the batch compiler (with default name `smlc') instead of an
                     69: interactive system.
                     70: .TP
                     71: .BI \-noshare
                     72: Do not link the `.mo' files into an `a.out' format object file and include it in the
                     73: runtime executable.
                     74: .TP
                     75: .BI \-i
                     76: Make the `sml' image start out using the interpreter for faster compilation
                     77: and slower execution (for interactive system only; can switch
                     78: back to native code once in
                     79: `sml' by `System.Control.interp := false').
                     80: .TP
                     81: .BI \-ionly
                     82: Build an image (with default name `smli') that has only the interpreter.
                     83: This gives fast compilation and saves space by eliminating the code
                     84: generator from the executable, but results in slower execution.
                     85: .TP
                     86: .BI \-o " image"
                     87: Use image as the name of the system image.
                     88: The default image name is `sml' for interactive systems, `smli' for the
                     89: interpreter only system and `smlc' for the batch compiler.
                     90: .PP
                     91: The following options may be used to tune garbage collection and paging performance.
                     92: .TP
                     93: .BI \-h " heapsize"
                     94: Set the initial heap size to \fIheapsize\fP kilo-bytes.
                     95: .TP
                     96: .BI \-m " softlimit"
                     97: Set the soft limit on the heap size to \fIsoftlimit\fP kilo-bytes.
                     98: .TP
                     99: .BI \-r " ratio"
                    100: Set the ratio of the heap size to live data to \fIratio\fP.
                    101: This must be at least 3.
                    102: .PP
                    103: The following options are for building and testing new versions of the system; they
                    104: are not necessary for normal installation.
                    105: .TP
                    106: .BI \-run
                    107: Build the run-time kernel (`runtime/run'), but don't build a system.
                    108: .TP
                    109: .BI \-noclean
                    110: Don't remove the existing `.o' files in the runtime directory.
                    111: .TP
                    112: .BI \-norun
                    113: Don't re-compile the runtime kernel.
                    114: This implies the \fB-noclean\fP option.
                    115: .TP
                    116: .BI \-target " machine"
                    117: Build a batch cross compiler for \fImachine\fP.
                    118: For example, to build a \fBvax\fP to \fBsparc\fP cross compiler
                    119: .ti +0.5i
                    120: makeml \-vax \-bsd \-target sparc
                    121: .br
                    122: This option implies the \fB-batch\fP option.
                    123: .TP
                    124: .BI \-mo " path"
                    125: Use \fIpath\fP as the directory containing the `.mo' files.
                    126: .TP
                    127: .BI \-runtime " path"
                    128: Use \fIpath\fP as the source directory for the runtime code.
                    129: .TP
                    130: .BI \-D def
                    131: When compiling the runtime code add ``\fB-D\fP\fIdef\fP'' as a command line option.
                    132: .SH "SEE ALSO"
                    133: linkdata(1)
                    134: .SH AUTHOR
                    135: John Reppy
                    136: .SH BUGS
                    137: This will not work with the sun cross-compilers (really a problem with the
                    138: runtime makefile).

unix.superglobalmegacorp.com

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