Return to makeml.1 CVS log

Up to [Research Unix] / researchv10no / cmd / sml / doc

Annotation of researchv10no/cmd/sml/doc/makeml.1, revision 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).

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