Installation Guide
From VpriWiki
Contents |
Downloading
First, choose a version to download. Depending on which you choose, you will need to have installed either Subversion or GIT. Note that the trunk and the git repositories are used for active development and experimentation; they are unstable and often broken, or at least internally inconsistent. You probably want the 'stable' version.
Stable version
The current stable version is 376. You can browse or checkout the code from subversion:
svn checkout http://piumarta.com/svn2/idst/tags/idst-376 fonc-stable
Official Development version
Ian Piumarta, the architect of the FoNC system, maintains the official subversion repository. Browse or checkout the code:
svn checkout http://piumarta.com/svn2/idst/trunk fonc
This version has not been widely tested and may not compile on your platform. Differences in the trunk since the stable version include:
- Incompatible bind() API.
- Fast lookup cache disabled.
- Call sites have a descriptor object that is passed to the method instead of the closure; the descriptor contains the closure, the fragment (for sideways composition) and the actual number of arguments passed to the method.
- Various incompatible changes in the function/objects library and jolt-burg for new parser support.
Unofficial GIT Gateway
Michael FIG, a volunteer contributor, maintains a git mirror of the subversion trunk, updated hourly. Get it with:
git clone git://fig.org/idst.git
Ocean Repository
Michael also maintains a branch (codenamed "Ocean"), with the intention of providing a more stable but still fairly current platform to gather patches from the community and test them before channeling them into the main COLA branch. Get it with:
git clone git://fig.org/ocean.git
Discussion of Ocean is welcome on the mailing list
Building
FoNC builds easily on Unix-like platforms with GCC. To build, enter the top directory of the downloaded source, and run:
make
- you need the readline lib development files ("readline-devel" ("libreadline-dev" for Ubuntu)), and at least on SuSE you need to add a "-L/usr/lib/termcap" in the jolt-burg Makefile to compile successfully - Hans-Martin
Some platforms require a little more effort.
Testing
The instructions in this section do not work - Matthewf 18:52, 11 August 2008 (PDT)
You can set your X11 DISPLAY environment variable and run "make run" from the top directory, and the test programs will run, some of them interactive. If you don't have an X display, you can run the tests individually by changing into one of the object/examples/* or function/examples/* directories and issuing "make run".

