-
Notifications
You must be signed in to change notification settings - Fork 13
/
README.txt
116 lines (76 loc) · 5.78 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
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 2008 or VisualStudio 2008 Express
2) The assembler files no longer need to be built, instead this code is generated on startup using the macro assembler built into strongtalk.
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)\build.win32\strongtalk.sln.
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. For now, I suggest using Debug until the VM is more stable.
If running the app withing the IDE you may need to set some paths in the
properties configurations. For some reason these seemed to get lost in the
checkin. Must be stored in the large binary files (which obviously I did
not checkin!)
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:
- The debug configuration turns off C++ optimizations, turns on debugging
options, and also turns on extensive assertions in the code, so it runs
slowly.
- The fast configuration is like the debug configuration except that it turns
off assertions and turns on more C++ optimizations, so it runs quite fast
yet is still debuggable. This is a good one to use if you want to get real
work done in it but still want to be able to debug crashes when they happen.
- The product configuration turns off all the debugging options, links with
the non-debug runtime libraries, and turns on more extensive C++
optimizations. This is the version that should be used for benchmarking.
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
__________________
The assembler link instructions are now redundant (as are the assembler files and COFF binaries).
If you want to build on a non-windows machine, we're all for it, but you have non-trivial work to do.
See the Wiki for Linux build instructions.
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.
- Link errors (LNK1104): It appears that on some machines, some libraries (e.g. kernel32.lib) cannot be found.
By setting the full path (e.g., "C:\Program Files\MSDEV\LIB\kernel32.lib") we were able to circumvent this problem.
You can do this in MSDEV by choosing Build>Settings and choosing the Link tab, and ensuring that every library that is missing is
listed explicitly with its full path name in the Object files list. All 3 projects should have the same list of libraries:
"c:\Program Files\msdev\lib\kernel32.lib" "c:\Program Files\msdev\lib\user32.lib" "c:\Program Files\msdev\lib\gdi32.lib" "c:\Program Files\msdev\lib\winspool.lib" "c:\Program Files\msdev\lib\comdlg32.lib" "c:\Program Files\msdev\lib\advapi32.lib" "c:\Program Files\msdev\lib\shell32.lib" "c:\Program Files\msdev\lib\ole32.lib" "c:\Program Files\msdev\lib\oleaut32.lib" "c:\Program Files\msdev\lib\uuid.lib" "c:\Program Files\msdev\lib\LIBCD.lib" "c:\Program Files\msdev\lib\oldnames.lib"
You can paste this in the Object files field of the Links tab under Buikd>Settings in MSDEV.