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