Tools/CodeTools/TianoTools/Pccts/README

   1
   2                           Parr Research Corporation
   3                                     with
   4                   Purdue University Electrical Engineering
   5                                     and
   6                        University of Minnesota, AHPCRC
   7
   8                                 Terence Parr
   9                                 Russell Quong
  10                                  Will Cohen
  11                                  Hank Dietz
  12
  13
  14 A central place for information about PCCTS 1.33 is:
  15
  16         http://www.polhode.com/pccts.html
  17
  18 The maintenance release is available from:
  19
  20         http://www.polhode.com/pccts133mr.zip
  21
  22 There is a ready-to-run version for win32 for Microsoft Visual Studio
  23 at the same site.  It is available from:
  24
  25         http://www.polhode.com/win32.zip
  26
  27 New users should visit http://www.polhode.com/pccts.html in
  28 order to get the following document:
  29
  30         "Notes For New Users of PCCTS"
  31
  32 This is a Postscript file of about 40 pages which is extremely
  33 useful for someone starting out. It is a based on 1.33mr21
  34
  35 When you have a little more experience, be sure to review the
  36 following documents in the distribution kit:
  37
  38             CHANGES_FROM_133.txt
  39             CHANGES_FROM_133_BEFORE_MR13.txt
  40             KNOWN_PROBLEMS.txt
  41
  42 -------------------------------------------------------------------------
  43                       INSTALLATION (Unix)
  44 -------------------------------------------------------------------------
  45 0. Download http://www.polhode.com/pccts133mr.zip
  46
  47 1. Unzip the distribution kit to your preferred location.
  48    If there are newline problems try using zip -a ...
  49
  50 2. cd to the main pccts directory.
  51
  52 3. make
  53
  54    This will create:
  55
  56         antlr
  57         dlg
  58         sorcerer
  59         genmk
  60
  61 4. Copy to /usr/local/bin or /usr/local/bin if you like.  If you
  62    don't wish to then add pccts/bin to your path.
  63
  64 5. To get an up-to-date list of program options execute the
  65    program with no command line options.  To get up-to-date
  66    documentation read CHANGES_FROM_133*.txt and KNOWN_PROBLEMS.txt
  67    at:
  68
  69            http://www.polhode.com/pccts.html
  70
  71 6. You need not create a library.  The makefile created by genmk
  72    assumes that the files are not part of a library.
  73
  74    If you wish to create a library from elements of pccts/h:
  75
  76    If the first letter of the filename is lowercase (uppercase) it is
  77    related to the code generated using the pccts C mode (C++ mode).
  78    Some of the .c and .cpp files in the h directory are not meant to
  79    be placed in a library and will not compile because they are meant
  80    to be #include in pccts generated files which are grammar specific.
  81
  82    For C++ users place the following elements in the library:
  83
  84         AParser.cpp
  85         ASTBase.cpp
  86         ATokenBuffer.cpp
  87         BufFileInput.cpp (optional)
  88         DLexerBase.cpp
  89         PCCTSAST.cpp
  90         SList.cpp
  91
  92 -------------------------------------------------------------------------
  93                     INSTALLATION (Win32)
  94 -------------------------------------------------------------------------
  95
  96 I've tried to keep the win32 kit to the minimum necessary to get
  97 up and running.  The complete kit contains additional information
  98 (some historical), source code, and DevStudio projects for
  99 rebuilding pccts from the source code.
 100
 101 The kit is now distributed with both MSVC 5 and MSVC6 style projects.
 102
 103 0. Download http://www.polhode.com/win32.zip.
 104
 105    You may also wish to download:
 106
 107         http://www.polhode.com/CHANGES_FROM_133.txt
 108         http://www.polhode.com/CHANGES_FROM_133_BEFORE_MR13.txt
 109         http://www.polhode.com/KNOWN_PROBLEMS.txt
 110
 111 1. Unzip the distribution kit to your preferred location.
 112
 113    This will create:
 114
 115          a pccts directory tree
 116             pccts/bin/*.exe
 117             pccts/lib/*.lib
 118             pccts/h/*
 119             sorcerer/lib/*
 120             sorcerer/h/*
 121
 122          an example directory tree
 123             pccts\example\calcAST\*
 124             pccts\example\simple\*
 125
 126 2. Define the environment variable PCCTS to point to the main
 127    pccts directory.
 128
 129 3. Try building the simple project: pccts\example\simple\simple50.dsw
 130    or simple60.dsw.
 131
 132 4. Try building the complex project: pccts\example\calcAST\calcAST50.dsw
 133    or calcAST60.dsw.
 134
 135 -------------------------------------------------------------------------
 136                       INSTALLATION (DEC/VMS)
 137 -------------------------------------------------------------------------
 138
 139 DEC/VMS support added by Piéronne Jean-François (jfp@altavista.net)
 140
 141 0. Download http://www.polhode.com/pccts133mr.zip
 142
 143 1. Unzip the distribution kit to your preferred location.
 144
 145 2. set default to the main pccts directory.
 146
 147 3. @makefile.vms
 148
 149    This will create in directory [.bin]:
 150
 151         antlr.exe
 152         dlg.exe
 153         sorcerer.exe
 154         genmk.exe
 155
 156 5. To get an up-to-date list of program options execute the
 157    program with no command line options.  To get up-to-date
 158    documentation read CHANGES_FROM_133*.txt and KNOWN_PROBLEMS.txt
 159    at http://www.polhode.com/pccts.html.