Return to makeml.1 CVS log

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

Annotation of researchv10no/cmd/sml/src/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: .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.