commands/flex-2.5.4/MISC/README

   1 Miscellaneous flex stuff.  The items which have been tested with flex 2.5 are:
   2
   3         - texinfo/, a subdirectory containing a "texinfo" version of flex(1)
   4           and the corresponding "info" files (contributed by Francois Pinard).
   5
   6         - VMS/, a subdirectory containing makefiles, configuration files,
   7           run-time support, and installation notes for building flex 2.5
   8           on VMS (contributed by Pat Rankin).
   9
  10         - Borland/ - makefile and config.h for Borland 4.02 compiler
  11           (contributed by Terrence O Kane, who notes that no source
  12           code changes were necessary).
  13
  14         - NT/ - Makefile and config.h for NT, contributed by Stan Adermann.
  15
  16         - OS2/ - Makefile and config.h for building flex under OS/2,
  17           contributed by Kai Uwe Rommel.
  18
  19         - Amiga/: notes on building flex for the Amiga, contributed
  20           by Andreas Scherer.
  21
  22         - parse.c, parse.h - output of running yacc (byacc, actually)
  23           on parse.y.  If your system doesn't have a flavor of yacc available,
  24           copy these into the main flex source directory instead.
  25
  26         - flex.man - preformatted version of flex man page
  27
  28
  29 The following have been tested using flex 2.4:
  30
  31         - debflex.awk, an awk script for anotating flex debug output.
  32           It presently only works with gawk and mawk, not with "old"
  33           or "new" awk.
  34
  35         - NeXT: ProjectBuilder.app support for use in the NeXT world.
  36
  37         - Notes on building flex for the Macintosh using Think-C,
  38           in the Macintosh/ subdirectory.
  39
  40         - testxxLexer.l, a sample C++ program that uses flex's scanner
  41           class option ("-+").
  42
  43         - fastwc/, a subdirectory containing examples of how to use flex
  44           to write progressively higher-performance versions of the Unix
  45           "wc" utility.  This certainly should work with 2.5, but hasn't
  46           been tested.
  47
  48         - Borland.old/: notes on building flex 2.4 for Borland C++ 3.1
  49           on MS-DOS.  These shouldn't be needed for flex 2.5.  Included
  50           only in case you encounter unanticipated difficulties.
  51
  52         - EBCDIC: contact information for building flex for EBCDIC.
  53
  54
  55 The following are all out-of-date with respect to flex release 2.4 (and
  56 in general up-to-date for flex 2.3):
  57
  58         - Atari/Atari.patches, patches for porting flex to the Atari and
  59           to Minix.
  60
  61         - A number of notes and Makefiles for compiling flex under MS-DOS,
  62           in the MSDOS/ subdirectory.
  63
  64         - Notes on building flex for MVS, in the MVS/ subdirectory.
  65
  66 If any of this is out-of-date and can be deleted, please let me know.
  67
  68 And the following is included for compatibility with some broken versions
  69 of bison:
  70
  71         - alloca.c, a public-domain, mostly-portable version of the
  72           alloca() routine (used by bison's parsers) written by D. A. Gwyn.
  73
  74
  75 Many thanks to those who contributed these files.  Updated versions will
  76 be appreciated!