We will be running your code using the following software:
Even if you're working alone, it's still useful to set up a source control system. Subversion works well. Windows users should install TortoiseSVN. If you're going to be working in a group, contact CETS about setting up a UNIX group on ENIAC so that you can all share a repository.
If you set up a repository, try to avoid checking in binary files. You don't need to add OMake's .omc files to version control either.
All course tools should be installed on ENIAC. You can save yourself an hour by working over SSH, but we're including these instructions in case you'd like to use your own equipment.
To use the tools on ENIAC, you'll have to add cis341 directories to your path:
You can get OCaml from the official site (including a Windows installer) In addition, OCaml should be installed and running on eniac-l.
If you don't have it already, you should use your free MSDNAA access to download a copy of Visual Studio 2008. After doing so, you can elect to download the port based on the Microsoft toolchain. Make sure to run all command-line utilities from the Visual Studio 2008 Command Prompt—otherwise, ocamlopt (and friends) will complain about missing executables.
Using OMake is much more convenient than using traditional makefiles. You can get it from its official site.
If your distribution does not have an up-to-date OCaml or OMake package, you can still build from source. OCaml's configure script accepts an option -prefix that allows you to dictate where make install drops files; OMake provides a similar lever through the INSTALL_ROOT environment variable. Check the software's respective INSTALL files for details, and feel free to send mail to the class list if you have any trouble.
Windows users should download Microsoft's Debugging Tools for Windows for windbg.exe.
If you have a working copy of the GNU binutils (as any proper Linux or OS X installation should), it is likely that you already have a working version of GAS. Try as --version to make sure. Windows users can download a Win32-native binutils from the mingw32 project (choose the latest version of the binutils package). If you do this, you'll have to configure your paths yourself. In Windows XP, you can right-click on My Computer, select Properties, select Advanced, then Environment Variables, then Path (a user variable). I added C:\Program Files\Debugging Tools for Windows (x86) and C:\mingw-binutils\bin.
Download the project1 archive and extract it to somewhere convenient. It is important that you do not change the directory structure. We'll refer to the directory containing 'projects' as cis341 (so when we talk about the file cis341/projects/OMakeroot, it's the file from the archive's projects directory).
To be reasonably certain that you have everything right, open a shell at
cis341/projects/smoketest and type:
If you have any more suggestions for OCaml editors, please send them to the class list.