Return to README CVS log

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

Annotation of 43BSD/contrib/apl/README, revision 1.1.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.