home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / mac / progrmng / flextc.sit / README < prev    next >
Encoding:
Text File  |  1990-01-02  |  2.4 KB  |  120 lines  |  [TEXT/KAHL]
  1. // $Header: README,v 2.4 89/06/20 17:12:01 vern Exp $
  2.  
  3. This is release 2.1 of flex - a beta release.
  4.  
  5. The flex distribution consists of the following files:
  6.  
  7.     README        This message
  8.  
  9.     Makefile
  10.     flexdef.h
  11.     parse.y
  12.     scan.l
  13.     ccl.c
  14.     dfa.c
  15.     ecs.c        flex sources
  16.     gen.c
  17.     main.c
  18.     misc.c
  19.     nfa.c
  20.     sym.c
  21.     tblcmp.c
  22.     yylex.c
  23.  
  24.     initscan.c    pre-flex'd version of scan.l
  25.  
  26.     flex.skel    skeleton for generated scanners
  27.  
  28.     flex.1        manual entry
  29.  
  30.     Changes        Differences between this release and the previous one
  31.     COPYING        flex's copyright
  32.     MISC        miscellaneous stuff (e.g., old VMS Makefile) which
  33.             almost no one will care about
  34.  
  35.  
  36. If you have installed a previous version of flex, delete it (after making
  37. backups, of course).  This will entail removing the source directory,
  38. /usr/include/{flexskelcom,fastskeldef,flexskeldef}.h, and
  39. /usr/local/lib/flex.{skel,fastskel}, if that's where you put the various
  40. pieces.
  41.  
  42.  
  43. Decide where you want to keep flex.skel (suggestion:  /usr/local/lib) and
  44. move it there.  Edit "Makefile" and change the definition of SKELETON_FILE
  45. to reflect the full pathname of flex.skel.
  46.  
  47. Read the "Porting considerations" note in the Makefile and make
  48. the necessary changes.
  49.  
  50.  
  51. To make flex for the first time, use:
  52.  
  53.     make first_flex
  54.  
  55. which uses the pre-generated copy of the flex scanner (the scanner
  56. itself is written using flex).
  57.  
  58. Assuming it builds successfully, you can test it using
  59.  
  60.     make test
  61.  
  62. The "diff" should not show any differences.
  63.  
  64. If you're feeling adventurous, rebuild scan.c using various
  65. combinations of FLEX_FLAGS, each time trying "make test" when
  66. you're done.  To rebuild it, do
  67.  
  68.     rm scan.c
  69.     make FLEX_FLAGS="..."
  70.  
  71. where "..." is one of:
  72.  
  73.     -c
  74.     -ce
  75.     -cm
  76.     -cfe
  77.     -cFe
  78.  
  79. and testing using:
  80.  
  81.     make FLEX_FLAGS="..." test
  82.  
  83.  
  84. Format the manual entry using
  85.  
  86.     make flex.man
  87.  
  88.  
  89. Please send problems and feedback to:
  90.  
  91.     vern@{csam.lbl.gov,rtsg.ee.lbl.gov}  or  ucbvax!csam.lbl.gov!vern
  92.  
  93.     Vern Paxson
  94.     Real Time Systems
  95.     Bldg. 46A
  96.     Lawrence Berkeley Laboratory
  97.     1 Cyclotron Rd.
  98.     Berkeley, CA 94720
  99.  
  100.     (415) 486-6411
  101.  
  102.  
  103. I will be gone from mid-July '89 through mid-August '89.  From August on,
  104. the addresses are:
  105.  
  106.     vern@cs.cornell.edu    (email sent to the former addresses should
  107.                  continue to be forwarded for quite a while)
  108.                 (if I'm unlucky, you'll have to send mail
  109.                  to "paxson@cs.cornell.edu", so try that if
  110.                  the first doesn't work)
  111.  
  112.     Vern Paxson
  113.     CS Department
  114.     Grad Office
  115.     4126 Upson
  116.     Cornell University
  117.     Ithaca, NY 14853-7501
  118.  
  119.     <no phone number yet>
  120.