1Brief instructions for building flex 2.5.x for VMS:
2
3   0) if you have either MMS (from Digital) or MMK (freeware) for use
4as a `make' utility, follow the directions in steps #1 through #5 below.
5If not, execute
6      @BUILD.COM xxxC
7where "xxxC" is either "VAXC" or "DECC" or "GNUC", and then skip to
8step #5.
9
10   1) set default to the source directory (not the [.MISC.VMS] subdirectory
11where this file is located).
12
13   2) COPY [.MISC.VMS]DESCRIP.MMS []*.*
14(Recursive invocations of `make' for the `bigcheck' test assume that the
15makefile will be found as descrip.mms in the current directory.)
16
17To build with VAX C for VAX/VMS:
18   3) MMS /MACRO=("VAXC=1") FLEX.EXE
19(The /macro qualifier is optional in this case.)
20
21To build with GNU C for VAX/VMS:
22 2.5) possibly edit descrip.mms to uncomment `SET COMMAND' for GCCINIT,
23      depending on local site configuration
24   3) MMS /MACRO=("GNUC=1") FLEX.EXE
25
26To build with DEC C for either VAX/VMS or Alpha/VMS:
27   3) MMS /MACRO=("DECC=1") FLEX.EXE
28(Expect one or two informational messages from the compiler about
29implicitly declared functions.)
30
31Minimal testing of the resulting program:
32   4) MMS CHECK
33(If `diff' reports no warnings, the test has succeeded.)
34
35More thorough testing:
36 4.5) MMS /MACRO=("xxxC=1") BIGCHECK    ! "xxxC=1" as in step #3 above
37(If using an older version of MMK rather than MMS, this might fail when
38`make' is invoked recursively due to excessive BYTLM usage by MMK.)
39
40Installation (the VMS makefile does not support an `install' target;
41you'll need to do this part manually):
42   5) copy flex.exe, flex.doc, flex.skl, flexlib.olb, and FlexLexer.h to
43location(s) appropriate for your site.  To use flex, define a "foreign"
44command by making a DCL symbol whose value begins with a dollar sign
45immediately followed by the filename for flex.exe, as in
46      $ flex :== $local_tools:flex.exe
47where `local_tools:' is the logical name pointing to flex.exe's location.
48This symbol will ordinarily be a candidate for your login.com.  When
49invoking flex, upper- or mixed-case command line options must be enclosed
50in quotes.  For example,
51      $ flex "-Pxyz" "-L" -t mylexer.l > mylexer.c
52(use prefix "xyz" instead of "yy", suppress `#line' compiler directives
53in the output, write the output to `stdout', process file mylexer.l,
54and capture `stdout' in file mylexer.c).  As illustrated here, this VMS
55version of flex supports emulation of command line I/O redirection used
56by Unix shells.
57
58 flex.exe    -- the executable image for the flex program;
59 flex.doc    -- documentation, the "man page" describing flex (flex.1
60                processed with `nroff -man' followed by `col -b');
61 flex.skl    -- a text file containing flex's default skeleton;
62                with this version of flex, it is for reference only;
63                flex.exe does not need to know where to find it;
64 flexlib.olb -- an object library containing some support routines;
65                you might need to link your generated lexer against
66                it, depending on how your program is designed;
67                flex.exe does not access it; it corresponds to
68                `libfl.a' under Unix;
69 FlexLexer.h -- header file used for C++ class-based lexers; not
70                needed for ordinary C lexers.
71
72Notes:
73      This VMS port of flex supports only the original Unix command line
74interface, not the native DCL interface which was available for flex 2.3.
75
76 build.com   -- DCL command procedure as alternative to descrip.mms;
77 descrip.mms -- 2.5.x makefile for use with MMS or MMK (see step #1);
78 mkskel.tpu  -- TPU program used to make skel.c from flex.skl for full
79                build from scratch; performs same function as mkskel.sh;
80 vms-conf.h  -- pre-configured `conf.in', copied to [-.-]config.h;
81 vms-code.c  -- VMS-specific support code, copied to [-.-]vms-code.c;
82 README.VMS  -- this file
83