1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209
|
Welcome to PCCTS 1.33
October 5, 1995
Parr Research Corporation
with
Purdue University Electrical Engineering
and
University of Minnesota, AHPCRC
Terence Parr
Russell Quong
Will Cohen
Hank Dietz
[The "NOTES for new users" by Tom Moog is available now via web
browser at http:www.mcs.net/~tmoog and via anonymous ftp at
ftp.mcs.net/mcsnet.users/tmoog.]
[We've removed PCCTS.FUTURE from the distribution and added file SERVICES,
which describes the services of Parr Research Corporation.]
INSTALLATION
This document describes the installation of PCCTS 1.33 on UNIX
and non-UNIX machines. The UNIX installation is trivial while the
non-UNIX folks have a bit more work to do as an install script
explicitly for there machine will not exist--they will have to
interpret the install script.
PCCTS 1.33 includes a number of different programs and examples
in the software release package -- most of which like to live in their
own directories. The install script will build a standard hierarchy.
Or, if you get the tar file off the ftp site, the hierarchy will be
constructed automatically by tar.
The PCCTS executables (antlr, dlg) may be placed anywhere the user
wishes but the install script places them in the bin directory created
during installation.
1.0. UNIX USERS
This section is for UNIX users and describes the most convenient
installation procedure.
1.1. FORMAT: pccts.tar
To begin installation, place the pccts.tar file into the directory
where you want to place a pccts subdirectory. Untar the file with
tar xvf pccts.tar
and cd into it. To install PCCTS, simply type
make
which will build the standard PCCTS directory hierarchy (under the
directory where you ran the install script) and build executable
versions of antlr and dlg.
1.2. FORMAT: pccts.bag
To begin installation, the user should create a directory (usually
called pccts) where the PCCTS source subtree is to be created. Place
the pccts.bag file and the install script into this directory and cd
into it. To install PCCTS, simply type
sh install
which will build the standard PCCTS directory hierarchy (under the
directory where you ran the install script), "unbag" all of the files
and build executable versions of antlr and dlg.
If you do not have the 'sh' shell, you'll need the install.unbag.reqd
file.
NOTE: If you are using the later SGI C++ compilers, use -woff 3262 to
get rid of a bunch of noise by the compiler (warnings).
2.0. NON-UNIX USERS
ANTLR was written using portable (we hope), vanilla K&R-style C,
ANSI C, and C++. It has been successfully ported to a variety of
environments. We do not provide an installation script explicitly for
non-Unix users. You must interpret the install script and perform the
analogous operations on your machine. There is an install script,
install.mpw, for Macintosh programmers.
IMPORTANT NOTE: For PC users: You must create the parser.dlg and
"touch" scan.c in antlr and dlg directories or the
makefiles will try to execute antlr and dlg, which
don't exist yet. The first time, you want only to
compile the C files in order to obtain an executable
for antlr and dlg. From this point, a change in
antlr.g or dlg_p.g will force antlr/dlg to regenerate
themselves.
You must define symbol PC if you want things to work
out right for use on a DOS, OS/2, Windows machine.
This affects the config.h file, which you can change
as you wish.
For Mac programmers using MPW (Macintosh Programmer's Workshop),
define symbol MPW to get the correct config.h stuff included.
3.0. EMAIL VERSION RECIPIENTS
If you received PCCTS via email response from
pccts@ecn.purdue.edu you have one additional installation step to
perform over the ftp folks (and pccts.tar is unavailable). You will
have received a number of bite-size chunks of pccts which are small
enough to be emailed (~1500 lines each). You must reconstruct the
PCCTS files before you can begin installation. In order to rebuild an
original file, you must have "one.c" which will take the chunks and
pack them together. If you are a non-UNIX type, you must have the
"unbag.c" file which unbags the bags created by our mail archiver.
UNIX folks use the shell to unbag as they would for shar files (this
will be done automatically by the install script).
To install PCCTS, place all PCCTS mail messages into a pccts
directory, remove the mail headers from one.c. Then compile one.c
with:
cc -o one one.c
and then type:
./one f1 f2 ... fn
where f1..fn are the parts of PCCTS source sent as chunks (i.e. these
files will be all the files you received NOT including one.c, unbag.c,
README, install and the request acknowledge banner). There is no need
to remove mail headers from the chunk files and they may appear in any
order. The subject line of the mail will identify it as a chunk and a
chunk of what file. The "one" program should be used to put pccts.bag
back together. You are now in a position to begin normal PCCTS
installation. All files you receive should go into a pccts directory.
Note that all files which arrive in "chunks" must be put back
together using "one". Beware that you do not mix chunks from more
than one original file. For instance, do not specify all chunks that
you collect from the PCCTS mailbot on the "one" command line unless
you have requested only one original file that was split into multiple
files. Each chunk knows which original file it is a part of, where it
goes in that file and how many total chunks are required to rebuild
that original.
4.0. WORD SIZE AND PC USERS
The config.h file now sets up the word size for your compiler
automatically.
TUTORIAL
The advanced tutorial should be placed in a directory at the
same level as antlr, dlg, support etc... Do a
sh advtut.bag
to unbag (or use the unbag program) and then type
make -s all
which will create executables called tut1-tut4. Naturally, if you got
the tutorials from the ftp site, the tar format of the tutorials can
be obtained for easier installation.
Unfortunately, the tutorials have changed little since the 1.06
release. With luck, these will be enhanced and an AST tutorial will
appear.
MACHINE COMPATIBILITY
PCCTS is known to compile "out of the box" on the following machines
and/or operating systems: [didn't have time to retest on all these
machines, but seems to be highly portable still].
o DECSTATION 5000
o SGI; use "-woff 3262" in your CFLAGS make variable
o Sun SparcStation (cc, gcc, g++, Cfront, acc)
o VAX C under VMS
o Linux SLS 0.99, gcc/g++
o 386 PC, NetBSD 0.9, gcc 2.4.5
o HP 9000/755, HP-UX 9.01, HP cc
o 486 PC, OS/2 2.1 (w/long filenames), IBM C Set++ 2.1
o NeXTStep 3.2 running g++/gcc 2.6.3 (pentium-90)
INCOMPATIBILITIES
Please see the release notes.
CREDITS
Please see the history.ps or history.txt.
|