Installation Guide

From VpriWiki

(Redirected from Sources)
Jump to: navigation, search

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"), 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".

Personal tools