apc(1)              UNIX Programmer's Manual               apc(1)

NAME
     apc, api - Aquarius Prolog compiler and interpreter

SYNTAX
     apc [ option(s) ] file(s)

     api

DESCRIPTION
     Aquarius Prolog is a high-performance, portable Prolog
     implementation developed since 1989 by the Aquarius Project
     at the University of California, Berkeley, the Advanced Com-
     puter Architecture Laboratory at the University of Southern
     California, and at Digital Equipment Corporation's Paris
     Research Laboratory.

     Aquarius Prolog provides substantially the same built-in
     predicates and memory management as Quintus Prolog, a lead-
     ing commercial system, with additions such as two kinds of
     destructive assignment.  Aquarius is the first fully func-
     tional Prolog system that does global analysis.  See the
     user manual for a full description of the system.

     The compiler is called apc.  It accepts files with suffix
     .pl (Prolog source code), suffix .b (BAM code: the first
     intermediate code), suffix .i (Pseudo-assembly: the second
     intermediate code), suffix .s (MIPS assembly code), and suf-
     fix .o (MIPS object code).  In normal use, apc compiles Pro-
     log source and returns a native code MIPS executable.

     The interpreter is called api.  It has essentially the same
     functionality as C-Prolog, except for debugging.

     This version of Aquarius Prolog runs on MIPS R3000 Ultrix
     systems.  Aquarius has been ported to other systems includ-
     ing MIPS R3000 RISC/os systems, SPARC SunOS systems, MC68020
     (or higher) HP-UX systems, and MC68020 (or higher) SunOS
     systems.

EXAMPLE
     The command 'apc foo.pl' compiles the Prolog source file
     foo.pl to the executable foo*.  The file 'foo.pl' must start
     with a predicate of arity zero.  This predicate is called
     when foo is executed.

OPTIONS
     Normally, memory management is automatic, but Aquarius exe-
     cutables accept a variety of options to customize behavior
     for particular uses (e.g., initial memory area sizes, cus-
     tomization of garbage collection).  See the user manual for
     a description of these options.

Printed 11/21/94                                        1

apc(1)              UNIX Programmer's Manual               apc(1)

     Options of apc: (running apc without arguments will list
     these options)

     -v      set verbose mode

     -tb     process through .b files only

     -ti     process through .i files only

     -ts     process through .s files only

     -to     process through .o files only.

     -sb     save .b files

     -ss     save .s files

     -so     save .o files

     -st     print timing/memory statistics for each step

     -o      output_name: use output file output_name

FILES
     User manual       ENDUSER/Documentation/user_manual/user_manual.ps
     Programming hints ENDUSER/Documentation/HINTS_FOR_SPEED

CURRENT OWNER
     Peter Van Roy (pvr@info.ucl.ac.be)

AUTHORS OF OBJECT
     Peter Van Roy, Ralph Haygood, Tom Getzinger

AUTHOR OF DOCUMENTATION
     Ralph Haygood

Printed 11/21/94                                        2