**** (c) 1998, University of Twente, Enschede, the Netherlands. **** **** **** **** This file contains information for installing the Student LAnguage **** **** Development Environment (SLADE) version 2.8 (formerly known as TCGS) **** **** developed at University of Twente. **** **** The ideas behind SLADE are described in: **** **** - H.Alblas, A.Nymeyer: Practice and Principles of Compiler Building **** **** with C, Prentice Hall 1996. **** **** - H.Alblas, H.Groen, A.Nymeyer, C.Slot: Student Language Development **** **** Environment, Twente University Press 1998. **** **** **** **** To report bugs, comments, or any suggestions: please contact **** **** Han Groen, tel: +31 53 4894617, e-mail: groen@cs.utwente.nl **** Installing the MS-Windows version of SLADE: =========================================== You need an Intel 486 (or compatible) PC running Windows 95/NT with: 1. at least 3 Mb of free disk space, and 2. a screen resolution of at least 800x600 pixels 3. an ANSI C compiler installed (default MS Visual C++, but the (free) DJGPP GNU C compiler is also supported). The file slade28.exe is a self-extracting MS-Windows executable. By running this executable a dialog box pops up. Just click the "Extract" button and SLADE will be installed on your system in the directory C:\SLADE (you can place it somewhere else by typing another "Extract to" directory). When SLADE is installed you can activate it by running SLADE.EXE in the BIN directory. During installation the following subdirectories are created: BIN\ Contains the SLADE executables: CODGEN.BAT Invokes V2*.EXE and your ANSI C compiler. MKPARS.BAT Compiler maker (invokes your ANSI C compiler). V2C.EXE Converts VIM code to C. V2A.EXE Converts VIM code to Intel x86 assembler. V2S.EXE Converts VIM code to GNU Intel x86 assembler. SLADE.EXE MS-Windows user-interface. SCANGEN.EXE Scanner generator (only needed in batch mode). VIMINT.EXE VIM code interpreter (only needed in batch mode). PARSGEN.EXE Parser generator (only needed in batch mode). SLADERUN.BAT Script invoked by SLADE.EXE to run your generated compiler. EXAMPLES\ Example directories, each example contains: - For the SLADE batch (MS-DOS) environment: BUILD.BAT Script to build a compiler. RUN.BAT Script to run/test the built compiler. XX_S.INP Scanner XX specification file XX.INP Parser XX specification file *.INP Test input file(s). - For the interactive SLADE (MS-Windows) environment: XX.T file Specification XX of scanner/parser (binary form). *.INP file Test input file(s). INCLUDE\ CGL.H Header file used by the built compiler. DEBUG.H Header file for debugger generation. EVALATTR.H API module evalattr, header file. EVALATTR.INC PARSGEN include file (batch version only). EXTMAC.H Macro's for Intel x86 assembler generation. EXTMAC.S Macro's for GNU Intel x86 assembler generation. IDSCOPE.H API module idscope, header file. IDSCOPE.INC PARSGEN include file (batch version only). RTS.H Code generation routines, header file. SCANPARS.C Scanner/parser interface, source file. SCANPARS.H Scanner/parser interface, header file. VIMCODE.H API module vimcode, header file. VIMCODE.INC PARSGEN include file (batch version only). LESSONS\ Lessons directory, contains the initial scanner/parser specifications used in the lessons of the tutorial in [ANGS98]. LIB\ CGL.C Source file to be linked with the built compiler. CODGEN.MKF Makefile, used by CODGEN.BAT. EVALATTR.C API module evalattr, source file. DEBUG.RC Resource file for the debugger. DEBUG.RES Compiled resource file for the debugger. DEBUGR.H Resource identifier definitions for the debugger. IDSCOPE.C API module idscope, source file. MAKELIBS.BAT Script to (re)build the SLADE libraries. MAKELIBS.MKF Makefile used by MAKELIBS.BAT MKPARS.MKF Makefile, used by MKPARS.BAT. RTS.C Code generation routines, source file. SCANPARS.C Scanner/parser interface, source file. SLADE.HLP On-line help file. SLADERC.T Description of API used in the user-interface. SLADEV.LIB Visual C++ library, used by MKPARS.MKF. SLADEVD.LIB Visual C++ library for debugger, used by MKPARS.MKF. VIMCODE.C API module vimcode, source file. If you don't want to use MS Visual C++: ======================================= If you're using another C compiler, you need to change the MKPARS.BAT, MKPARS.MKF, CODGEN.BAT and CODGEN.MKF files. Furthermore you need to run MAKELIBS.BAT in the LIB directory to recompile the SLADE libraries with your own C compiler. Before running MAKELIBS.BAT you should both update MAKELIBS.BAT and MAKELIBS.MKF to incorporate your C compiler properties. Be sure to set the correct search path to the INCLUDE and LIB directories. If you want to use the SLADE software in a MS-DOS batch environment: ==================================================================== You need to set the environment variable VERMAN to the directory under which you installed SLADE. (e.g. set VERMAN=C:\SLADE) The parser generator is started with: PARSGEN pars.inp [acts.c ...] The scanner generator is started with: SCANGEN pars_s.inp Generated scanner/parsers are compiled with: MKPARS pars The VIM code interpreter is started with: VIMINT test.vim The code generator is started with: CODGEN test.vim See also the build.bat files in the example directories.