home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / flexpp.zip / FLEX / 00README.EMX next >
Text File  |  1995-11-08  |  3KB  |  88 lines
  1. ***CONTENT and SUPPORTED PLATFORMS
  2.  
  3. Firstly, this directory contains the runtime environment of flex++, which
  4. was written by Alain Coetmeur, ported for the following platforms:
  5.  
  6. 1) OS/2 2.xx/WARP 3.0 standalone            (tested)
  7. 2) OS/2 2.xx/WARP 3.0 with EMX09a           (tested)
  8. 3) DOS 5.0 32Bit protected mode standalone  (tested, Version>3.0 promised, acc. to EMX)
  9. 4) DOS 5.0 32Bit protected mode with EMX09a (promised, Version>3.0 promised acc.to EMX)
  10. 5) DOS/WINDOWS 32Bit protected mode across DPMI with RSX (promised, acc. to RSX)
  11.  
  12. The directory also contains the 'makefile' which was used
  13. to produce this environment from the original flex++ files.
  14. The 'patch.emx' reports about one micro change which was needed 
  15. in respect to the original files.
  16. It also reports a change in the skeletons for the generated code which allows 
  17. for counting lines as a builtin scanner task by means of the scanner (member)
  18. variable 'yylineno'.
  19. The variable can be renamed like others (e.g. yyleng) can be.
  20. The sections of the manual page, which describe renaming of 'yyleng'
  21. apply accordingly.
  22. For further information about flex++ see the original files
  23. (location e.g. 'ftp.th-darmstadt.de').
  24.  
  25.  
  26. ***CONTENTS IN DETAIL
  27.  
  28. 00README EMX    - this file
  29. FLEX     EXE    - the EMX/RSX executable
  30. FLEXSTA  EXE    - the standalone executable
  31. FLEXSKEL CC     - the Skeleton
  32. FLEXSKEL H      - the Header Skeleton
  33. MAKEFILE        - the makefile for EMX/gcc environment
  34. FLEXPPM  TXT    - the manual page converted to text
  35. INSTALL  BAT    - DOS install
  36. INSTALL  CMD    - OS/2 install
  37. PATCH    EMX    - patch report
  38.  
  39.  
  40. ***INSTALLATION
  41.  
  42. Platform 1-4:
  43. -------------
  44. 1) Copy the file 'flexexe.taz' into the root directory of
  45. any drive. 
  46. Or: if you have 'EMX', into the root directory of the drive,
  47. where 'EMX' is installed.
  48.  
  49. 2) Decompress and unpack with 'unzip flexpp.zip' 
  50.  
  51. 3) type 'cd flex <RET>' within a commandline.
  52.  
  53. 4) type 'install <RET>'.
  54.  
  55. 5) if you installed the standalone version of flex++, keep the directory
  56. '<drive>:\flex' and add it to your 'PATH' variable. Otherwise you can delete
  57. the directory and its contents.
  58.  
  59. Platform 5:
  60. -----------
  61. 1) Change the 'emx' directories (bin, lib, include, ...)  within 'install.bat' 
  62. to the appropriate directories under 'RSX', if needed.
  63.  
  64. 2) Same procedure as for Platform 1-4.
  65.  
  66.  
  67. ***USAGE OF FLEX++ under DOS based Platforms (3-5)
  68.  
  69. Usage is as described in the manual page ('flexppm.txt') with one exception:
  70. ALWAYS use the '-o<outfile>' option to specifiy the file
  71. where the generated code shall be put (note: no space afer '-o'!).
  72. This is due to the ancient filename constraints, DOS machines are suffering from.
  73. Note, that the version of flex++ is produced on OS/2 with HPFS filesystem,
  74. which doesn't know such constraints. As default output file this
  75. flex++ wants to create a 'lex.yy.c' file which doesn't work, off course.
  76.  
  77.  
  78. ***GENERAL USAGE NOTE
  79.  
  80. For really utilizing the new set of features of flex++ related to C++ code
  81. generation the files contained in 'ftp.th-darmstadt.de:/pub/.../bison++flex++misc*'
  82. are very instructive.
  83.  
  84.  
  85. Have fun,
  86.  
  87. Gregor Buehler           (buehler@ibm.net)
  88.