VFX Forth 64 for Linux Installation Notes ========================================= 1 July 2020 Because of the hassle of packaging for Linux, VFX Forth 64 for Linux is provided as a tarball. After extracting the tarball, you must copy the executables and shared libraries to the directories expected by your distribution. After installation, you will find the PDF manual as /Doc/VfxLin64.pdf Installing from the tarball .tar.gz ----------------------------------- The tarball was created with tar -zcvf ... Extract the tarball to a suitable directory. tar -zxvf ... A directory will be created containing all the VFX Forth files, where xxx is one of Community and Mission. Change to this directory. cd The directory incudes a shell script ./InstallMe.Lin64.sh that performs the installation on 64 bit Linux distributions. The instructions below for a tarball apply if you are installing manually. The executables and shared libraries are in the Bin subdirectory. You should now copy these to the "right" places for your distribution, usually /usr/bin and /usr/lib. The file to copy to /usr/bin is Bin/VfxCommunity_x64_lin.elf. The files to copy to /usr/lib are Bin/libmpeparser64.so.0 and Bin/vfxsupp64.so.1 The shared library libmpeparser64.so.0 contains the code to support persistent INI files and and vfxsupp64.so.1 contains a large number of (case-sensitive) constants from Linux header files. 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. You will probably have a version already installed. If not, consult the installation system for your Linux distribution. We usually use the TexLive distribution. Directory structure ------------------- /usr/bin - binaries ~/VfxLinxx - or wherever you put it Bin - Executables and their related files Doc - Manuals and documentation AnsForth.Htm - ANS Forth HTML documentation VfxLin.htm - VFX Forth HTML documentation Examples - Examples to look at and use - has subdirectories Kernel - source code if applicable - has subdirectories, 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 Lin64 - Linux specific code OOP - Several OOP packages SharedLibs - interfaces to common libraries Sources - source code if applicable - has subdirectories, not present in all versions Tools - useful third party and O/S specific tools - not present in all versions VFXBase - source code if applicable - has subdirectories, not present in all versions Assumptions ----------- VFX Forth requires the following shared libraries in order to start: /lib64/ld-linux.so.2 libc.so.6 Users report that installing a symbolic link has fixed startup problems. Configuration ------------- Now please read the PDF manual for details of how to configure VFX Forth to know about your favourite editor and so on.