Installing a Development EnvironmentWe recommend:
See the Dependencies section for information on obtaining appropriate version of a JDK, the Cygwin environment, the byacc/J parser generator, and the zipping tools. The E Source DistributionFor Windows users, we recommend downloading the zip of E source distribution. Compilation NotesThere are still some deprecated methods used in this release. You can safely ignore these warnings for now. Building from MakefilesTo build the release, cd to the e/src directory and type make. Be sure that "cygwin/bin" is on your PATH ahead of Windows directories, like "C:/WINDOWS/COMMAND". In particular, some have had problems finding the wrong "make.exe" and "find.exe". Be sure the version of both of these found on your PATH are the ones in "cygwin/bin". A Bad Bug: Which which is which?The Makefile in e/src/csrc/win32 in this release use a standard Unix-like "which" command. Since it is Unix-like, and since it works in my Windows environment, I had assumed it came with the Cygwin environment. I was wrong, and I haven't since been able to determine where I obtained my "which.exe" file. The bash built in command "type -p <name>" is equivalent enough for our purposes. To repair this, replace "which" with "type -p" in this Makefile. However, "type -p <name>" is only available in bash, not sh, so you should also change the SHELL definition at the top of e/src/build/makerules.mk from "/bin/sh" to "/bin/bash". Or you can just wait for the next release, which incorporates the above fixes. Building in a Java IDEE itself is a pure Java program. If you don't need to rebuild the installation tools, you can happily develop E using a Java-only development environment, such as Symantec's Visual Cafe (>= 4.1 Standard Edition). For concreteness, and because it's what I use, I'll explain how to build a Cafe project for E, but users of other development environments should easily see how to do likewise in their system. To start with, create a "New Project". For a project type, select "Empty Project" since we don't want it generating new source files for us. Select "Project Options". Under the "Project" tab, deselect "Enable RAD for New Files" since this is needless overhead for us. The "Project Type" should be "Application - A program that requires a java.exe to run". For the "Main Class" enter "org.erights.e.elang.interp.Interp" -- the class whose main() is the top of the E interpreter. For command like arguments, put "d:\e\src\esrc\scripts\elmer.e". Elmer is a good way to test each new build of E. On the "Compiler" tab, we recommend deselecting "Show command line", but salt to taste. On the "Directories" tab, for "Show directories for", first select "Input class files". This is where you enter the equivalent of the CLASSPATH. Assuming you installed the E source tree at "d:\e\src", you should enter the following in this order:
For "Output files", "Output directory", enter "d:\e\classes". This is where Cafe's compiler will place the *.class files. Now we need to suck all the e\src\jsrc\*.java files into the project. Right click in the project windows and select "Insert files". Navigate to the directory "e\src\jsrc", select "subfolders", click on "Add All", and then click on "Ok". Wait while it adds all these files to your project. Finally, on the "Project" menu, select "Run in Debugger". Hopefully, after everything successfully compiles, you'll see an Elmer window. You are now running Elmer under the Cafe debugger. Have fun! |
||||||||||||||||||||||||
Unless stated otherwise, all text on this page which is either unattributed or by Mark S. Miller is hereby placed in the public domain.
|