Annotation of researchv10no/cmd/sml/README, revision 1.1

1.1     ! root        1:                Standard ML of New Jersey
        !             2:              Version 0.44, 4 December 1989
        !             3: 
        !             4:            by Andrew Appel and David MacQueen
        !             5: 
        !             6:               with contributions from
        !             7: 
        !             8:        Bruce Duba      Trevor Jim      James O'Toole
        !             9:        Norman Ramsey   John Reppy      Nick Rothwell
        !            10:        James Mattson   Kevin Mitchell  David Tarditi
        !            11:        Mads Tofte      Peter Weinberger
        !            12: 
        !            13:        ------------------------------------------------
        !            14: 
        !            15: STANDARD ML OF NEW JERSEY COPYRIGHT NOTICE, LICENSE AND DISCLAIMER.
        !            16: 
        !            17: Copyright 1989 by AT&T Bell Laboratories
        !            18: 
        !            19: Permission to use, copy, modify, and distribute this software and its
        !            20: documentation for any purpose and without fee is hereby granted,
        !            21: provided that the above copyright notice appear in all copies and that
        !            22: both the copyright notice and this permission notice and warranty
        !            23: disclaimer appear in supporting documentation, and that the name of
        !            24: AT&T Bell Laboratories or any AT&T entity not be used in advertising
        !            25: or publicity pertaining to distribution of the software without
        !            26: specific, written prior permission.
        !            27: 
        !            28: AT&T disclaims all warranties with regard to this software, including
        !            29: all implied warranties of merchantability and fitness.  In no event
        !            30: shall AT&T be liable for any special, indirect or consequential
        !            31: damages or any damages whatsoever resulting from loss of use, data or
        !            32: profits, whether in an action of contract, negligence or other
        !            33: tortious action, arising out of or in connection with the use or
        !            34: performance of this software.
        !            35: 
        !            36:        ------------------------------------------------
        !            37: 
        !            38: This file describes the latest release of the Standard ML of New
        !            39: Jersey compiler.  The main changes relative to previous versions are
        !            40: described in the file doc/NEWS. This is a preliminary version that
        !            41: supports almost the entire Standard ML language with few bugs.  We
        !            42: hope to release Version 1 of the compiler at the end of 1989.
        !            43: 
        !            44: We are eager to receive your bug reports, comments, and constructive
        !            45: criticism.  The documentation is still in a primitive state, but your
        !            46: comments on the installation instructions and manual would be
        !            47: appreciated.  Any error message beginning with "Compiler bug"
        !            48: definitely indicates a bug in the compiler and should be reported.
        !            49: Please use an appropriate variation on the bug reporting form in the
        !            50: file doc/bug.form and send comments and bug reports to:
        !            51: 
        !            52:    David MacQueen
        !            53:    Room 2C-322
        !            54:    AT&T Bell Laboratories
        !            55:    Murray Hill, NJ 07974
        !            56:    USA
        !            57:    phone: 201-582-7691
        !            58:    email: [email protected]
        !            59: 
        !            60: Instructions for installing the compiler are in the file doc/INSTALL.
        !            61: 
        !            62: Format of the Distribution
        !            63: 
        !            64: The compiler is being distributed in two forms: (1) as a tar file on
        !            65: tape, and (2) as a set of compressed tar files accessible by anonymous ftp
        !            66: from the host princeton.edu, directory /usr/ftp/pub/ml.
        !            67: 
        !            68: 1. Tape distribution
        !            69: 
        !            70: Extracting the contents of the tape using tar -x yields a single directory
        !            71: named mldist.  The contents of mldist are as follows (as printed by ls -F):
        !            72: 
        !            73:     README          lib/         mo.ns32/      mo.vax/
        !            74:     doc/            mo.m68/     mo.sparc/      src/
        !            75: 
        !            76: README (this file) contains some general information on the current release.
        !            77: 
        !            78: The mo.vax, mo.m68, mo.ns32, and mo.sparc directories contain the Vax, Motorola
        !            79: MC68020, National Semiconductor 32000, and SPARC object files for the compiler.
        !            80: 
        !            81: The src directory contains the source code of the compiler.
        !            82: 
        !            83: lib contains contributed software.  At the moment, this consists of
        !            84: a lexical analizer generator (lib/lexgen), a parser generator
        !            85: (lib/mlyacc), a code generator generator (lib/mltwig), and a gnu emacs
        !            86: major editing mode (lib/emacs).
        !            87: 
        !            88: The doc directory contains a number of documentation files for installing and
        !            89: using the compiler:
        !            90: 
        !            91:   INSTALL      directions for installing the interactive Standard ML system.
        !            92: 
        !            93:   BATCHINSTALL directions for using the interim batch system and bootstrapping
        !            94:                the compiler.
        !            95: 
        !            96:   NEWS         general information on changes and new features.  A number of
        !            97:                important features of the compiler are documented only in this
        !            98:                file, alas.
        !            99: 
        !           100:   users                a mailing list of current site contacts.  Please inform us of
        !           101:                any updates or corrections.
        !           102: 
        !           103:   help         hints for beginners on using the system.
        !           104: 
        !           105:   differences  a (partial, out of date) list of differences between Standard
        !           106:                ML of New Jersey and the Edinburgh compiler.
        !           107: 
        !           108:   weak-types   a very brief explanation of weak type variables.
        !           109: 
        !           110:   callcc       an explanation of the new callcc primitives.
        !           111: 
        !           112:   profiling    an explanation of how to use the profiling facilities.
        !           113: 
        !           114:   optimize     hints on making your programs run faster
        !           115: 
        !           116:   localspec    comments on "local" specifications in signatures
        !           117: 
        !           118:   bugs         current list of known bugs (please check this before submitting
        !           119:                bug reports).
        !           120: 
        !           121:   bug.form     suggested format for bug reports.
        !           122: 
        !           123:   refman/      LaTeX sources for an incomplete, provisional reference manual.
        !           124: 
        !           125:   examples/    A collection of example programs.  We would like to collect 
        !           126:                additional examples contributed by users.  Please mail your
        !           127:                example programs to [email protected].
        !           128: 
        !           129:   papers/      source files (troff -ms or TeX) for papers describing the compiler.
        !           130: 
        !           131: 
        !           132: 2. Ftp distribution
        !           133: 
        !           134: To obtain the compiler by internet ftp, connect to host princeton.edu
        !           135: use login id "anonymous" with your name as password, and go to directory
        !           136: pub/ml ("cd pub/ml").  Then put ftp in binary mode ("binary") and "get"
        !           137: the relevant files in that directory.  An alternate site is research.att.com,
        !           138: directory "dist/ml".
        !           139: 
        !           140: Host:           Net Address:   Login:      Passwd:     Directory:
        !           141: princeton.edu   128.112.128.1  anonymous   Your name   pub/ml
        !           142: research.att.com 192.20.225.2  anonymous   Your name   dist/ml
        !           143: 
        !           144: The directory pub/ml (dist/ml on research.att.com) contains a
        !           145: zero-length file named VERSION-0.44 indentifying the version, an ascii
        !           146: file named README that describes the current release and the following
        !           147: compressed tar files:
        !           148: 
        !           149:   doc.tar.Z       : the doc directory containing documentation
        !           150:   src.tar.Z       : the src directory containing source code
        !           151:   lib.tar.Z       : the lib directory containing contributed software
        !           152:   mo.m68.tar.Z    : the mo.m68 directory of m68 object files
        !           153:   mo.vax.tar.Z    : the mo.vax directory of vax object files
        !           154:   mo.sparc.tar.Z  : the mo.sparc directory of sparc object files
        !           155:   mo.ns32.tar.Z          : the mo.ns32 directory of NS32k object files
        !           156: 
        !           157: You need only transfer the mo.*.tar.Z files that you need for your
        !           158: machines (e.g. mo.m68.tar.Z for Sun 3, NeXT, etc., mo.vax.tar.Z for
        !           159: Vax).  The pub/ml (dist/ml) directory may also contain directories
        !           160: with development versions of the compiler that contain a version
        !           161: number followed by the letter "d".  These files are made available for
        !           162: development work and are liable to be even more flakey than the normal
        !           163: beta releases.
        !           164: 
        !           165: ***************************************************************************
        !           166: NOTE: Ftp should be put into binary mode before transferring the compressed
        !           167: tar files.
        !           168: ***************************************************************************
        !           169: 
        !           170: Here is a sample dialog:
        !           171: 
        !           172:    ftp
        !           173:    ftp> open princeton.edu [research.att.com]
        !           174:    Name: anonymous
        !           175:    Password: <your name>
        !           176:    ftp> binary
        !           177:    ftp> cd pub/ml [dist/ml]
        !           178:    ftp> get README
        !           179:    ftp> get src.tar.Z
        !           180:    ftp> get lib.tar.Z
        !           181:    ftp> get doc.tar.Z
        !           182:    ftp> get mo.m68.tar.Z
        !           183:    ftp> get mo.vax.tar.Z
        !           184:    ftp> close
        !           185:    ftp> quit
        !           186: 
        !           187: After the files are transferred they should be uncompressed using the
        !           188: uncompress command and then extracted using tar into a directory
        !           189: called mldist.  It may not be necessary to transfer all the files; if
        !           190: you do not intend to run the compiler on a Vax, for instance, there is
        !           191: no need to get the mo.vax.tar.Z file.
        !           192: 
        !           193: For example:
        !           194: 
        !           195:    mkdir mldist
        !           196:    mv src.tar.Z mldist
        !           197:    cd mldist
        !           198:    uncompress -c src.tar.Z | tar xf -
        !           199: 
        !           200: will unpack the src directory.

unix.superglobalmegacorp.com

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