Return to README CVS log

Up to [Research Unix] / researchv10dc / cmd / flex

Annotation of researchv10dc/cmd/flex/README, revision 1.1.1.1

1.1       root        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:        [email protected]     (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 "[email protected]", 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>

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.