summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Docs/BUILDING-GTK26
-rwxr-xr-xnetsurf12
2 files changed, 36 insertions, 2 deletions
diff --git a/Docs/BUILDING-GTK b/Docs/BUILDING-GTK
new file mode 100644
index 000000000..da28abe6f
--- /dev/null
+++ b/Docs/BUILDING-GTK
@@ -0,0 +1,26 @@
+To build the GTK version of NetSurf on a UNIX-like platform (although it has
+only been tested on Debian, Ubuntu and FreeBSD), simply run "make gtk" once
+you have got the relevent build dependancies installed. Under a Debian-like
+OS, this should suffice:
+
+ apt-get install libglade2-dev libcurl3-dev libxml2-dev lemon re2c
+
+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.
+
+lemon and re2c are the parser and lexer generators used to create NetSurf's CSS
+support. If you have trouble finding lemon for your platform, it forms part of
+the SQLite distribution, and consists of a single C file and a single runtime
+data file, and is trivial to build yourself.
+
+Type "make gtk". Currently, this produces a huge number of warnings, mostly
+due to confused signedness. These havn't been fixed yet but are mostly
+harmless.
+
+Once you've built NetSurf, you should have an executable called nsgtk. You
+can't run this directly without setting up some environment variables so that
+NetSurf can find its resources (such as the window definitions, text resources,
+etc). A small shell script called "netsurf" is provided to make it easy to run
+NetSurf from the build tree.
+
diff --git a/netsurf b/netsurf
index 8f0f8b70e..373425d83 100755
--- a/netsurf
+++ b/netsurf
@@ -1,9 +1,17 @@
#!/bin/sh
+# This file is part of NetSurf, http://netsurf-browser.org/
+# Licensed under the GNU General Public License,
+# http://www.opensource.org/licenses/gpl-license
+# Copyright 2007 Rob Kendrick <rjek@netsurf-browser.org>
+
if [ -d ~/.netsurf ]; then
LOG=~/.netsurf/log.txt
-else
+elif [ -d /tmp ]; then
LOG=/tmp/netsurf-log.txt
+else
+ LOG=netsurf-log.txt
fi
-export NETSURFRES=`dirname $0`/gtk/res/
+NETSURFRES=`dirname $0`/gtk/res/
+export NETSURFRES
exec `dirname $0`/nsgtk "$@" 2>$LOG