© Copyright 2005 Peri Hankey - documentation license Gnu FDL - code license Gnu GPL - validate HTML
SourceForge.net Logo how to install the software
home the project guide questions reference download

home install from SVN source

The source code is available in an SVN repository at http://www.dsource.org/projects/languagemachine. You can browse the code there. To build from this code you will need a subversion client. For the linux commandline client svn, you make a directory to contain your working copy, and then checkout the main trunk of the development tree as follows:

[user@machine] cd the_directory_that_will_contain_the_trunk
[user@machine] svn co http://svn.dsource.org/projects/languagemachine/trunk

The trunk/Makefile is used for building rpm packages. If that's what you want to do, first examine the Makefile, there may be local configuration details that will need fixing for your case. For example, where does your rpm install expect to find files for builds that you do? This is defined by ~/.rpmmacros. Here's an example:

 %_topdir /home/myhomedirectory/src/RPM

Otherwise, change to the directory trunk/languagemachine, and then follow the instructions below for installing from a source download.

home download

The files listed here and in the downloads section of the sourceforge development site contain free software as defined by the Gnu GPL and Gnu LGPL. They are offered with absolutely no warranty.

 language machine sources      look for latest tar.gz
 language machine rpm          look for latest .rpm
 language machine source rpm   look for latest .src.rpm

The language machine rpm is configured as requiring gdc and tcc. But you can try it out without these if you avoid doing things that need those compilers. See the faq.

home the gdc compiler

gdc frontend source - builds as addin to GNU gcc - the gdc rpms currently install into /opt and can coexist with a standard gcc. At present the gdc compiler is built as an addin to gcc-3.4.3.

 gdc D compiler rpm
 gdc C compiler rpm (required for gdc)
 gdc C++ compiler rpm (optional for gdc)

home the tcc compiler

Fabrice Bellard's tiny C compiler tcc

 tcc - tiny C compiler rpm
 tcc - tiny C compiler source rpm

home spec files for building rpms

All these spec files were used to build for Mandriva 10.x - but they should work with only small modifications on any rpm-based distribution.

home install from binary package

For rpm binary installs you need to have root privilege. No other binary packaging recipes are available at present - contributions are welcome.

home install from source

Note: as of 6 December 2005 the author has built and tested languagemachine-0.2.1 mainly in the following environments: 

gdc-0.15 based on gcc-3.4.3 - i586 linux-2.6.8.1 mandrake-10.1 (extensively updated)
gdc-0.17 based on gcc-4.0.2 - i586 linux-2.6.8.1 mandrake-10.1 (extensively updated)

Feedback about other build environments would be helpful.

The language machine and tcc sources unpack and build in the standard way: change directory to a working directory for source builds and then

 tar xvzf [the tar.gz file]
 cd [the directory created as a result]
 ./configure [--prefix=/path/to/your/install/directory/if/not/usr/local]
 make
 su
 make install

By default, the language machine builds for installation with /usr/local as prefix. If you want to install somewhere else, or if you don't have root privileges, or if you want to build a local test version without disturbing an existing installation, you can use ./configure --prefix=path-to-install-directory. As mentioned below, you will need to make sure that the paths in src/config/config/config.mak are appropriate for your installation.

Building the gdc compiler is a bit more complicated. It's best to go to gdc and follow the instructions from there. Building the tcc compiler from source is straightforward.

home what to do with a shiny new language machine

Play with it - in the source distribution, the src directory contains:

In the binary distributions these are placed in /usr/share/languagemachine (except for the language machine source directory lm).

You may need to edit config.mak to make sure that the paths there are valid for your installation. Then the easiest way to get started is to copy the config directory and some or all of the others to your private space so that you can experiment with the sample rulesets. You need to note that the Makefile in each directory expects to find config.mak as ../config/config.mak.

home