netsurf/Docs/BUILDING-GTK
James Shaw 0ab7a1bd37 Fix instructions on disabling librosprite. Move #include for when
librosprite isn't installed

svn path=/trunk/netsurf/; revision=4054
2008-03-29 14:34:21 +00:00

78 lines
2.9 KiB
Plaintext

--------------------------------------------------------------------------------
Build Instructions for GTK NetSurf 21 March 2008
--------------------------------------------------------------------------------
To build GTK NetSurf on a UNIX-like platform, provided you have the relevant
build dependencies installed, simply run:
$ make
If that produces errors, you probably don't have some of NetSurf's build
dependencies installed. See "Obtaining NetSurf's dependencies" below. You
may need to "make clean" before attempting to build after installing the
dependencies.
Run NetSurf by executing the 'netsurf' shell script:
$ ./netsurf
This script makes it easy to run the nsgtk binary from the build tree. It
sets up some environment variables which enable NetSurf to find its
resources.
Tested on Debian, Ubuntu, Fedora 8, FreeBSD, NetBSD and Solaris 10.
If you're packaging NetSurf, see the PACKAGING-GTK document.
Obtaining NetSurf's dependencies
==================================
Assuming you have GCC and GNU Make etc installed install the dependencies
for your system. Instructions for specific systems are below:
Debian-like OS:
$ apt-get install libglade2-dev libcurl3-dev libxml2-dev libmng-dev
$ apt-get install librsvg2-dev lemon re2c
Fedora:
$ yum install libglade2-devel curl-devel libxml2-devel libmng-devel
$ yum install librsvg2-devel lcms-devel re2c
If your distribution does not package 'lemon' (Fedora doesn't) then you'll
need to download it and build it yourself. You may find it comes with the
SQLite packages (SQLite's parser is built with lemon). If not, try this:
$ mkdir -p /usr/local/share/lemon
$ wget http://www.sqlite.org/cvstrac/getfile/sqlite/tool/lemon.c
$ wget -O /usr/local/share/lemon/lempar.c http://www.sqlite.org/cvstrac/getfile/sqlite/tool/lempar.c
$ sed -e's!lempar.c!/usr/local/share/lemon/lempar.c!' lemon.c > lem.c
$ gcc -o /usr/local/bin/lemon lem.c
NetSurf requires at minimum GTK 2.8. Earlier versions will not work. It also
depends on Cairo for rendering, but you should have this already with
versions of GTK 2.8 or later.
This will pull in loads of things, like all the GTK dev libraries, the PNG
and JPEG libraries, colour management libraries, zlib, OpenSSL etc that
NetSurf also depends on.
Compiling Sprite file support for GTK
=======================================
By default, sprite rendering is enabled. This requires librosprite to be
built and installed. If you don't want to do this, remove the following line
from util/config.h:
#define WITH_NSSPRITE
Remove all references to librosprite in the Makefile.
To build librosprite, check out from svn://svn.rjek.com/jshaw/libsprite/trunk
Build and install it:
$ make install
Optionally, specify an install prefix:
$ PREFIX=/path/to/install make install