**** (c) 1999, University of Twente, Enschede, the Netherlands. **** **** **** **** This file contains information for installing the Student LAnguage **** **** Development Environment (SLADE) version 2.9 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 (MS Visual C++, DJGPP, or Borland C++) The file slade29.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 install Slade somewhere else by typing another "Extract to" directory. NOTE: Slade cannot handle spaces in the "Extract to" directory. After installation a program group Slade 2.9 is created containing program items for each C compiler environment. You can delete those items you don't need (because you don't use the compiler mentioned). Furthermore you can set the Properties|Shortcut|run of the Gui program item(s) to "Minimized". This will prevent the dos box from coming up each time you start the Gui. IMPORTANT: You have to edit the env.bat file(s) to set the correct enviroment variables for the compiler(s) you use. During installation the following files and (sub)directories are created: bin\ Contains the SLADE executables: codgen.bat Invokes v2*.exe and your C compiler or assembler. mkpars.bat Compiler maker (invokes your C compiler). parsgen.exe Parser generator (only needed in batch mode). scangen.exe Scanner generator (only needed in batch mode). slade.exe MS-Windows user-interface. sladerun.bat Script invoked by slade.exe to run your generated compiler and/or generated code. v2a.exe Translates VIM code to Intel x86 assembler. v2c.exe Translates VIM code to C. v2j.exe Translates VIM code to JAVA j-code assembler. v2s.exe Translates VIM code to GNU Intel x86 assembler. vimint.exe VIM code interpreter (only needed in batch mode). examples\ testall.bat Batch script to test all examples testall.out Test results of testall.bat testrun.bat Batch script invoked by *\run.bat Example directories, each example contains: ONLY for the SLADE batch (MS-DOS) environment: build.bat Script to build a compiler. run.bat Script to run/test the built compiler. *.sg Scanner specification file *.pg Parser specification file *.xxx Test input file(s) for parser xxx. *.dat Input for the test input file(s). ONLY for the interactive SLADE (MS-Windows) environment: *.t file Specification of scanner/parser (binary form). *.xxx Test input file(s) for parser xxx. 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.j Macro's for JAVA j-code 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. debug.c Source file for the debugger. debug.rc Resource file for the debugger. debugr.h Resource identifier definitions for the debugger. evalattr.c API module evalattr, source file. idscope.c API module idscope, source file. rts.c Code generation routines, C source file. rts.class Code generation routines, class file. rts.java Code generation routines, Java 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. vimcode.c API module vimcode, source file. lib\BC\ Borland C specific files: codgen.bat Batch script, invoked by bin\codgen.bat. codgen.mkf Makefile, used by bin\codgen.bat. command.bat Starts command prompt with Borland C environment debug.res Compiled resource file for the debugger. env.bat Sets environment to OUR needs for Borland C gui.bat Starts bin/slade.exe with Borland C environment makelibs.bat Script to (re)build the Slade libraries. makelibs.mkf Makefile used by makelibs.bat mkpars.bat Batch script, invoked by bin\mkpars.bat. mkpars.mkf Makefile, used by bin\mkpars.bat. slade.lib Borland C library, used in mkpars.mkf. sladed.lib Borland C library for debugger, used in mkpars.mkf. lib\DJGPP\ Delorie GNU C specific files: codgen.bat Batch script, invoked by bin\codgen.bat. codgen.mkf Makefile, used by bin\codgen.bat. command.bat Starts command prompt with DJGPP environment debug.res Compiled resource file for the debugger. env.bat Sets environment to OUR needs for DJGPP gui.bat Starts bin/slade.exe with DJGPP environment makelibs.bat Script to (re)build the Slade libraries. makelibs.mkf Makefile used by makelibs.bat mkpars.bat Batch script, invoked by bin\mkpars.bat. mkpars.mkf Makefile, used by bin\mkpars.bat. slade.a DJGPP library, used in mkpars.mkf. sladed.a DJGPP library for debugger, used in mkpars.mkf. lib\MSVC\ MS Visual C++ specific files: codgen.bat Batch script, invoked by bin\codgen.bat. codgen.mkf Makefile, used by bin\codgen.bat. command.bat Starts command prompt with MSVC environment debug.res Compiled resource file for the debugger. env.bat Sets environment to OUR needs for MSVC gui.bat Starts bin/slade.exe with MSVC environment makelibs.bat Script to (re)build the Slade libraries. makelibs.mkf Makefile used by makelibs.bat mkpars.bat Batch script, invoked by bin\mkpars.bat. mkpars.mkf Makefile, used by bin\mkpars.bat. slade.lib MSVC library, used in mkpars.mkf. sladed.lib MSVC library for debugger, used in mkpars.mkf. If you want to use the SLADE software in a MS-DOS batch environment: ==================================================================== The parser generator is started with: parsgen pars.pg [acts.c ...] The scanner generator is started with: scangen pars.sg 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.