|
|
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).
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.