VFX Forth 64 for MacOS Installation Notes ========================================= The notation root refers to the name of the file you are going to install. This will probably be VfxOsx64. After installation, you will find the PDF manual as /Doc/VfxOsx64.pdf There is a section about configuring VFX Forth for your favourite editor, and for the online help system. Installing from the tarball .tgz file ------------------------------------- Choose a directory into which you will put most of VFX Forth. Run a terminal - usually in Finder's Utilities menu. This will leave you in your home directory, /Users/yourname, also indicated by tilde, '~'. A suitable place for VFX Forth will be ~/ This can also be accessed by other users as /Users/yourname/ The tarball was created with tar -zcvf ... Extract the tarball to a suitable directory. tar -zxvf .tgz For example, if you are installing the Community edition, put the downloaded file in you home directory. Then switch to the home directory. cd ~ tar -zxvf VfxOsxCommunity.tgz is the incantation to use. After installation, there will be a new directory, VfxOsxCommunity, in your home directory. Switch to the new directory cd The executables and shared libraries are in the Bin subdirectory. You should now copy these to the "right" places. Make sure that the script InstallMe.Osx64.sh is executable. If not, use chmod +x InstallMe.Osx64.sh Run the script ./InstallMe.Osx64.sh This script copies the Forth executables and shared libraries into /usr/local/bin and /usr/local/lib. It also generates the following synonyms vfxosx64 vfxforth64 vfx64 Directory structure - all except Mission ------------------- /usr/local/bin - executable program binaries /usr/local/lib - libraries Bin - Issue execuatbles, shared libraries and resources Doc - Manuals and documentation AnsForth.Htm - ANS Forth HTML documentation VfxOsx.htm - VFX Forth HTML documentation Examples - Examples to look at and use - has subdirectories Images - Binaries from user recompilation of VFX Forth - not present in all versions Kernel - source code for first stage build - not present in all versions Lib - library of tools maintained by MPE fsl - A port of the Forth Scientific Library Genio - Examples of Generic I/O drivers FSL - A port of the Forth Scientific Library OOP - Several OOP packages Osx32 - OS X specific code Cocoa - Cocoa interface SharedLibs - interfaces to several shared libraries MacForthOnVFX - Ward McFarland's port of MacForth Tools - useful third party and O/S specific tools - not present in all versions VFXBase - source code for second stage build - not present in all versions Directory structure - Mission edition ------------------- Sources - source code for all VFX Forth systems - OS X, Windows, Linux, DOS ... - contains tree above *.sh - shell scripts for building and releasing GTK+ and Glade ============== VFX Forth for Mac can use GTK+ and the Glade designer to create GUI interfaces. See Examples/Osx32/gtk for more details. In order to use this, the relevant binaries must be installed. A prebuilt set is supplied as gtkbins.tgz. Install these alongside the VFX Forth root directory. You will have to edit the GTK Forth files so that all the library paths are correct. tar -zxvf gtkbins.tgz We tested with the GTK+OSX package available from http://gtk-osx.sourceforge.net/ If you want to install a full system, read the build instructions fully before starting, and note that a 64 bit build is required. PDFtex ------ If you are going to use the DocGen documentation generator to produce PDF files, you will need to install a copy of LaTex2e. You will also need the PDF version, usually called pdftex.