sanjoy / strongtalk

Automatically exported from code.google.com/p/strongtalk
0 stars 0 forks source link

Caveats

The Strongtalk project only started up again recently after having been inactive since 1996, and all VM development stopped at that point. It is now starting up again, since Strongtalk is still by far the fastest Smalltalk implementation in existence, and is fully open-source unlike any other fast Smalltalk implementations, so there is much of value here.

While the C++ parts of the system now build under VisualStudio 2005 (and the Express version), the assembler files still require Borland Turbo Assembler. To enable compilation without purchasing the assembler, we have included the .obj files in COFF format from the assembler, for convenience (in bin/asm_objs.

Requirements

In order to run the Strongtalk VM, the following is required:

1) Intel Pentium PC, 90MHz, at least 32MB of RAM.

2) Windows NT 4.0 or Windows 95 or higher.

In order to build the Strongtalk VM from scratch, additionally the following software is required:

3) MS VisualStudio 2005 or VisualStudio 2005 Express

2) Assembler .obj files are included in the packaged source release, but if you wish to reassemble them, you will need Borland Turbo Assembler version 4.0. We don't know if things work properly with a newer version. An installed version of the assembler should be placed in the tools\tasm directory - extra installation may only be required if there's a problem with the current setup.

Build instructions

We will call the root strongtalk directory $STRTLK.

1) Build the 'makedeps' utility: In Explorer, navigate to $STRTLK\tools\makedeps. Open the VisualStudio project file for makedeps, makedeps.vcproj. "Run Build/Build Solution" from the menu. This should build $STRTLK\tools\makedeps.exe

2) Use makedeps to build include file dependencies: From a command line, cd into the $STRTLK\bin directory. Run 'nmake -f Makefile.win32 lists'.

3) From Windows Explorer, start the VisualStudio project for Strongtalk by opening $(STRTLK)\bin\strongtalk.vcproj.

4) In the VisualStudio IDE, choose Build -> Batch Build. Select the project configurations you want to build from the choices of Debug, Fast, and Product (ignore Release, that is spurious right now) and press Rebuild All.

5) Remove intermediate files if desired from the command file in $STRTLK\bin: nmake -f Makefile.win32 clean

The executables end up in the $STRTLK directory. Intermediate build files (object files etc) end up in subdirectories of $STRTLK\bin.

There are three configurations in the project - debug, fast and product. Each has its own subdirectory under bin, and its own executable: strongtalk_debug.exe, strongtalk_fast.exe and strongtalk.exe, respectively. The differences between them are:

Note: the code is formatted for a tab-width of 8, so the default of 4 must be changed when using Visual Studio. Go to Tools/Options/Text Editor/All Languages/Tabs.

Execute instructions

1) In the $STRLK directory, just run the VM executable you wish to use; for the product version that would be:

strongtalk

Files needed in that directory for running an application are:

 strongtalk.bst - the image file

 .strongtalkrc - the VM configuration options file

If you wish to use the development environment, you will also need:

 source - folder containing the source code for the Strongtalk libraries

Special situations


If you do have access to TASM, you should be able to get by by using the object files that are generated from the assembly code. If you are using MS VC++ 4.0, you should probably be able do place the object files found in strongtalk\bin\asm_objs\OMF in the build subdirectories (debug, fast, product) and doing an incremental build.

If you don't have an old version of MS VC++, you will either have to wait until we provide a version of the code that builds under a newer C++ compiler, or try and convert the code yourself.

Issues: if you get the C++ code to compile, you will find that VisualStudio 2005 will not link with the object files produced by TASM, which are in OMF format.
You can substitute these with the COFF versions found in strongtalk\bin\asm_objs\COFF and repeat the link phase. This should work (it worked for us).

If you want to build on a non-windows machine, we're all for it, but you have non-trivial work to do.

Problems we have encountered

Occasionally, despite strict adherence to the build instructions, we have run into problems on some machines, probably due to pre-existing installations of later versions of tools, environment variable differences, etc.

You can paste this in the Object files field of the Links tab under Buikd>Settings in MSDEV.