Pristine Ack-5.5
[Ack-5.5.git] / util / flex / README
1 // $Id: README,v 1.2 1994/06/24 10:56:35 ceriel Exp $
2
3 This is release 2.3 of flex - a full 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         libmain.c       flex library (-lfl) source
25
26         initscan.c      pre-flex'd version of scan.l
27
28         flex.skel       skeleton for generated scanners
29
30         flexdoc.1       full user documentation
31         flex.1          reference documentation
32
33         Changes         Differences between this release and the previous one
34
35         COPYING         flex's copyright
36
37         MISC/           a directory containing miscellaneous porting-related
38                         notes (for Atari, MS-DOS, Turbo-C, and VMS)
39
40
41 Decide where you want to keep flex.skel (suggestion:  /usr/local/lib),
42 but don't move it there yet.  Edit "Makefile" and change the definition
43 of SKELETON_FILE to reflect the full pathname of flex.skel.
44
45 Read the "Porting considerations" note in the Makefile and make
46 the necessary changes.
47
48 To make flex for the first time, use:
49
50     make first_flex
51
52 which uses the pre-generated copy of the flex scanner (the scanner
53 itself is written using flex).
54
55 Assuming it builds successfully, you can test it using
56
57     make test
58
59 The "diff" should not show any differences.
60
61 If you're feeling adventurous, issue "make bigtest" and be prepared
62 to wait a while.
63
64 Install flex using:
65
66         make install
67
68
69 Please send problems and feedback to:
70
71         vern@cs.cornell.edu
72         decvax!cornell!vern
73
74         Vern Paxson
75         CS Department
76         4126 Upson Hall
77         Cornell University
78         Ithaca, NY 14853-7501