1. General Comments
  2. Notes for All Platforms
  3. Linux
    1. Debian Etch
    2. Debian Sarge
    3. Fedora
    4. Red Hat Enterprise linux 4
  4. FreeBSD
  5. Mac OS X
    1. General Notes
    2. Building with DarwinPorts
    3. Fink support
  6. Windows

Platform Notes for Goanna

General Comments

Goanna should, in general, work anywhere Perl and GTK+ 2.4 or better are supported. The 3D view will additionally require OpenGL support, and a working GtkGLext. libxml is also required, but that can run pretty much anywhere. Finally, libsigc++ 2.x is required.

Notes for All Platforms

Goanna requires BambooLib (libraries and headers) to be installed. For most systems, this must be done from source.

GoannaBuildInstructions provides documentation for installing BambooLib and Goanna.

Linux

Debian Etch

Goanna is primarily developed on Debian Testing (Etch). The following packages are required to build Goanna:

The following are required to build BambooLib, on which Goanna depends:

Installing those should install all other needed packages as dependencies.

After ensuring all needed development packages are installed, configure and install BambooLib (in the libbamboo Subversion module), followed by Goanna. Note that Goanna must be installed (with make install) in order to function properly, as it must be able to find its data files.

Debian Sarge

Goanna would probably work with Debian Sarge, but this has not been tested.

Fedora

All required packages are available in Fedora Core + Extras.

Red Hat Enterprise linux 4

Support for Red Hat is being documented in RedHatEnterpriseLinux.

FreeBSD

Goanna has been tested a little on FreeBSD, and it seems to work. All dependencies can be found in ports. Goanna does need to be built with GNU make; FreeBSD's default make doesn't work. Install the gmake port and use gmake.

Mac OS X

General Notes

Mac OS X has GL/gl.h, but it isn't in the default include path. Therefore, configure needs some guidance to find it. Pass --with-opengl=/usr/X11R6 to configure and it should find it just fine.

OS X has a rather brain-dead linker. If you get libglade-WARNING messages speaking of an inability to find a widget creation function, make sure that you haven't stripped the goanna binary.

Building with DarwinPorts

Goanna has been tested on Mac OS X with DarwinPorts. The following ports from DarwinPorts are needed:

  • gtk2
  • libglade2
  • libxml2
  • gtkglext
  • xercesc
  • pcre
  • hicolor-icon-theme
  • libsigcxx2

If you're building from Subversion or Mercurial, the following are also needed:

  • libtool
  • autoconf
  • automake

Example DarwinPorts? build sequence

$ cd libbamboo
$ ./autogen.sh
$ ./configure --prefix=/opt/sss --with-xerces=/opt/local
$ make && make install
$ cd ../goanna
$ ./autogen.sh
$ ./configure --prefix=/opt/sss --with-opengl=/usr/X11R6 --with-bamboo=/opt/sss
$ make && make install

Fink support

Goanna builds and runs with Fink on Mac OS X 10.4 and later, using Fink Unstable.

Building with Fink

Goanna requires Fink to be configured to use unstable repositories, and many needed packages must be built from source.

Before building Goanna and BambooLib with Fink, install the following Fink packages and their dependencies with fink install:

  • gtk+2-dev
  • libglade2
  • gtkglext1
  • xerces-c-dev
  • pcre
  • libxml2
  • hicolor-icon-theme

For building from Subversion or Mercurial, the following are also needed:

  • libtool14
  • autoconf
  • automake1.9

Fink Problems

There are currently no known problems building with Fink.

Example Fink build sequence

$ cd libbamboo
$ LIBTOOLIZE=glibtoolize ./autogen.sh
$ ./configure --prefix=/opt/sss --with-xerces=/sw
$ make && make install
$ cd ../goanna
$ LIBTOOLIZE=glibtoolize ./autogen.sh
$ ./configure --prefix=/opt/sss --with-opengl=/usr/X11R6 --with-bamboo=/opt/sss
$ make && make install

Windows

Windows support is possible. Entirely undeveloped