| 1 | This file gives information regarding cvs snapshots of flex. cvs | 
|---|
| 2 | snapshots of flex contain the files which are under version control by | 
|---|
| 3 | the flex maintainers for the flex project. These snapshots can be | 
|---|
| 4 | found at: | 
|---|
| 5 |  | 
|---|
| 6 | ftp://ftp.uncg.edu/people/wlestes/ | 
|---|
| 7 |  | 
|---|
| 8 | If you are not interested in flex development or you are not in need | 
|---|
| 9 | of the latest bleeding-edge features, then cvs snapshots of flex are | 
|---|
| 10 | not for you. | 
|---|
| 11 |  | 
|---|
| 12 | When you get a distribution of flex, a large number of intermediate | 
|---|
| 13 | files needed to make building flex easy are included. You don't have | 
|---|
| 14 | that in a cvs snapshot. | 
|---|
| 15 |  | 
|---|
| 16 | You will need various external tools in order to build the distribution. Here is | 
|---|
| 17 | a (possibly incomplete) list of the required tools. Always get the latest | 
|---|
| 18 | version of each tool; we list the versions used in development of | 
|---|
| 19 | flex, but the listed versions may not work for you. | 
|---|
| 20 |  | 
|---|
| 21 | compiler suite;  e.g., gcc | 
|---|
| 22 | bash or some other fairly robust sh-style shell | 
|---|
| 23 | GNU bison;  to generate parse.c from parse.y | 
|---|
| 24 | GNU m4 1.4; required by BNU autoconf (yes, it *must* be GNU m4) | 
|---|
| 25 | GNU autoconf 2.54 and GNU automake 1.7; for generating Makefiles etc. | 
|---|
| 26 | GNU gettext 0.11.5; for i18n | 
|---|
| 27 | flex (latest beta release);  for bootstrap of scan.l | 
|---|
| 28 | help2man 1.27; to generate man page | 
|---|
| 29 | tar, gzip, etc.; for packaging of the source distribution | 
|---|
| 30 | GNU texinfo 4.3d;  to build and test the flex manual | 
|---|
| 31 | perl; GNU automake and GNU autoconf now depend on perl to run | 
|---|
| 32 | GNU indent 2.8; for indenting the flex source the way we want it done | 
|---|
| 33 |  | 
|---|
| 34 | ONce you have all the necessary tools installed, life becomes | 
|---|
| 35 | simple. To prepare the flex tree for building, run the script: | 
|---|
| 36 |  | 
|---|
| 37 | $ ./autogen.sh | 
|---|
| 38 |  | 
|---|
| 39 | in the top level of the flex source tree. | 
|---|
| 40 | This script calls the various tools needed to get flex ready for the | 
|---|
| 41 | GNU-style configure script to be able to work. | 
|---|
| 42 |  | 
|---|
| 43 | From this point on, building flex follows the usual configure, make, | 
|---|
| 44 | make install routine, almost. When configuring the flex tree, pass the | 
|---|
| 45 | --enable-maintainer-mode option to configure. If you forget, you will | 
|---|
| 46 | see errors about a missing file `version.texi'. | 
|---|