Return to README CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / apl

Annotation of 43BSD/contrib/apl/README, revision 1.1

1.1     ! root        1: Title:         APL
        !             2: 
        !             3: Authors:       John D. Bruner
        !             4:                Lawrence Livermore Laboratory
        !             5:                P.O. Box 808, L-276
        !             6:                Livermore, CA  94550
        !             7:                (415) 422-0758
        !             8: 
        !             9:                Prof. Anthony P. Reeves
        !            10:                Cornell University, Phillips Hall
        !            11:                Ithaca, NY  14853
        !            12:                (607) 256-4296
        !            13: 
        !            14: Description:
        !            15: 
        !            16: This is Purdue/EE's APL, which runs on both PDP-11's and VAX-11/780's.
        !            17: This APL originally was written by Ken Thompson at Bell.  It went to
        !            18: Yale for a while, and came to Purdue via a Chicago distribution in (I
        !            19: think) 1976.  Jim Besemer (now with Tektronix in Oregon) made many
        !            20: of the extensions to the original V6 PDP-11 version, including
        !            21: quad I/O functions, the state indicator, internal label processing,
        !            22: and a number of primitive functions.  I began support of APL when
        !            23: Jim left in 1978 and have been handling it since then.
        !            24: 
        !            25: The driving force behind all of the development and maintenance of APL
        !            26: at Purdue has been my major professor, Dr. Anthony P. Reeves.  Please
        !            27: forward bugs/comments/suggestions to Dr. Reeves or to me (UUCP site
        !            28: "pur-ee", login names "reeves" and "bruner").
        !            29: 
        !            30: Installation:
        !            31: 
        !            32: The makefiles included will generate APL for non-virtual-UNIX systems
        !            33: (PDP-11's or 32/V VAX's).  To compile and load APL type the command
        !            34: "make rebuild".  To compile a single-precision version (APL2) type
        !            35: "make apl2".  On PDP-11's the single-precision version is useful since
        !            36: it allows approximately twice as many items in the workspace; on the
        !            37: VAX the single-precision version is unnecessary (and unused here at
        !            38: Purdue).  I don't know how well the sources relate to USG UNIX, but
        !            39: if any changes are required I suspect they are minor.
        !            40: 
        !            41: On a PDP-11 I recommend using the file "makefile.pdp" -- this uses
        !            42: "ax.pdp.s" instead of "ax.c" and results in a little more intelligent
        !            43: handling of floating-point exceptions.
        !            44: 
        !            45: If you wish to compile APL for virtual-memory UNIX (Berkeley UNIX),
        !            46: edit "makefile" so that the line:
        !            47:        CFLAGS=-O
        !            48: reads
        !            49:        CFLAGS=-O -DVMUNIX
        !            50: 
        !            51: The editor "xed" is Purdue/EE's text editor, an extended version of
        !            52: the editor "ed".  APL calls the editor with some special flags for
        !            53: special character mapping, intelligent overprinting, and APL-style
        !            54: line numbering; therefore, we recommend that you use our
        !            55: editor.  We install it as /usr/bin/xed for use as a general-purpose
        !            56: editor as well; however, it is only necessary to install it as
        !            57: /bin/apled or /usr/bin/apled.  If you want to use some other editor
        !            58: with APL you may have to edit "ai.c" so that it doesn't call
        !            59: the editor with flags meant for "xed".
        !            60: 
        !            61: If "xed" is linked to "eed" it will run with a somewhat less general
        !            62: set of command options; this restricted editor is used at Purdue/EE
        !            63: to introduce editing to new users without scaring them away by
        !            64: all of the power in "xed".  The help files for the "he" command in
        !            65: XED and EED are "xed.doc" and "eed.doc"; the source for xed/eed/apled
        !            66: should be modified to contain whatever pathname is chosen for their
        !            67: eventual home.  (If you are on a PDP-11, compile "reset.s" with
        !            68: "xed.c" -- see the editor source for details.)
        !            69: 
        !            70: The program "aplcvt" converts workspaces between PDP-11 and VAX formats.
        !            71: If you are on a PDP-11 do NOT use the optimizer (-O flag) when you
        !            72: compile this -- the optimizer produces incorrect code.
        !            73: 
        !            74: The program "cata" (which can be linked to, and called as, "catb")
        !            75: prints APL functions in ASCII files with line numbers.  When called
        !            76: as "catb", overstrikes are printed on separate lines.

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