README.cvs

   1 This file gives information regarding the cvs tree of flex. The cvs
   2 tree of flex contains the files which are under version control by
   3 the flex maintainers for the flex project.
   4
   5 You can learn about the details of retrieving a copy of the cvs flex
   6 tree from flex's SourceForge project page at:
   7
   8 http://sourceforge.net/projects/flex
   9
  10 If you are not interested in flex development or you are not in need
  11 of the latest bleeding-edge features, then the cvs flex tree is
  12 not for you.
  13
  14 When you get a distribution of flex, a large number of intermediate
  15 files needed to make building flex easy are included. You don't have
  16 that in the cvs tree.
  17
  18 You will need various external tools in order to build the distribution. Here is
  19 a (hopefully complete and correct) list of the required tools. Always get the latest
  20 version of each tool; we list the versions used in development of
  21 flex, but the listed versions may not work for you.
  22
  23 compiler suite;  e.g., gcc
  24 bash or some other fairly robust sh-style shell
  25 GNU bison;  to generate parse.c from parse.y
  26 GNU m4 1.4; required by GNU autoconf (yes, it *must* be GNU m4)
  27 GNU autoconf 2.59 and GNU automake 1.9.6; for generating Makefiles etc.
  28 GNU gettext 0.14.5; for i18n
  29 flex (latest beta release);  for bootstrap of scan.l
  30 help2man 1.36; to generate the flex man page
  31 tar, gzip, etc.; for packaging of the source distribution
  32 GNU texinfo 4.8;  to build and test the flex manual
  33 perl; GNU automake and GNU autoconf now depend on perl to run
  34 GNU indent 2.8; for indenting the flex source the way we want it done
  35
  36 Once you have all the necessary tools installed, life becomes
  37 simple. To prepare the flex tree for building, run the script:
  38
  39 $ ./autogen.sh
  40
  41 in the top level of the flex source tree.
  42 This script calls the various tools needed to get flex ready for the
  43 GNU-style configure script to be able to work.
  44
  45 From this point on, building flex follows the usual configure, make,
  46 make install routine.