summaryrefslogtreecommitdiff
path: root/Docs
diff options
context:
space:
mode:
authorMichael Drake <tlsa@netsurf-browser.org>2008-03-29 23:26:37 +0000
committerMichael Drake <tlsa@netsurf-browser.org>2008-03-29 23:26:37 +0000
commitba18c561233efbbda35aebc22e8454d2626efcca (patch)
tree16d6de60d07b8a7a09e6ef2b906f675580dc7d5a /Docs
parent05dca28d582a1b98ea9c5f8fce96e13045977926 (diff)
downloadnetsurf-ba18c561233efbbda35aebc22e8454d2626efcca.tar.gz
netsurf-ba18c561233efbbda35aebc22e8454d2626efcca.tar.bz2
Restructure and update.
svn path=/trunk/netsurf/; revision=4060
Diffstat (limited to 'Docs')
-rw-r--r--Docs/BUILDING-GTK71
1 files changed, 46 insertions, 25 deletions
diff --git a/Docs/BUILDING-GTK b/Docs/BUILDING-GTK
index 2dd3ef4af..3e940b00a 100644
--- a/Docs/BUILDING-GTK
+++ b/Docs/BUILDING-GTK
@@ -1,7 +1,17 @@
--------------------------------------------------------------------------------
- Build Instructions for GTK NetSurf 21 March 2008
+ Build Instructions for GTK NetSurf 29 March 2008
--------------------------------------------------------------------------------
+ This document provides instructions for building the GTK version of NetSurf
+ and provides guidance on obtaining NetSurf's build dependencies.
+
+ GTK NetSurf has been tested on Debian, Ubuntu, Fedora 8, FreeBSD, NetBSD and
+ Solaris 10.
+
+
+ Building and executing NetSurf
+=================================
+
To build GTK NetSurf on a UNIX-like platform, provided you have the relevant
build dependencies installed, simply run:
@@ -12,7 +22,7 @@
may need to "make clean" before attempting to build after installing the
dependencies.
- Run NetSurf by executing the 'netsurf' shell script:
+ Run NetSurf by executing the "netsurf" shell script:
$ ./netsurf
@@ -20,16 +30,18 @@
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.
+ If you are 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:
+ Many of NetSurf's dependencies are packaged on various operating systems.
+ The remainder must be installed manually.
+
+
+ Package installation
+----------------------
Debian-like OS:
@@ -41,6 +53,29 @@
$ yum install libglade2-devel curl-devel libxml2-devel libmng-devel
$ yum install librsvg2-devel lcms-devel re2c
+
+ Librosprite
+-------------
+
+ Sprite file support is enabled by default. This requires librosprite to be
+ built and installed. If you don't want to do this, remove all references to
+ librosprite in the Makefile and remove the following line from utils/config.h:
+
+ #define WITH_NSSPRITE
+
+ To build librosprite, check out from svn://svn.rjek.com/jshaw/libsprite/trunk
+ Build and install it:
+
+ $ sudo make install
+
+ Optionally, specify an install prefix:
+
+ $ PREFIX=/path/to/install make install
+
+
+ Lemon
+-------
+
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:
@@ -51,6 +86,10 @@
$ sed -e's!lempar.c!/usr/local/share/lemon/lempar.c!' lemon.c > lem.c
$ gcc -o /usr/local/bin/lemon lem.c
+
+ General requirements
+----------------------
+
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.
@@ -58,21 +97,3 @@
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 utils/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