path: root/Docs/PACKAGING-GTK
diff options
authorMichael Drake <>2008-03-21 23:47:23 +0000
committerMichael Drake <>2008-03-21 23:47:23 +0000
commitb8d548d152e1e6929ab2f40f33228b734bba0c12 (patch)
tree3aa0c7f386023984e38af4eca1280116095f760b /Docs/PACKAGING-GTK
parent39fcb0ac799745b069f2257c3b28b2014c1904a3 (diff)
Update GTK docs.
svn path=/trunk/netsurf/; revision=4030
Diffstat (limited to 'Docs/PACKAGING-GTK')
1 files changed, 20 insertions, 5 deletions
diff --git a/Docs/PACKAGING-GTK b/Docs/PACKAGING-GTK
index 0e3475ac4..42c589991 100644
@@ -6,7 +6,11 @@
NetSurf for UNIX-like OSes.
We consider the Debian (and thus Ubuntu) packages excellent examples to
- crib from. It does everything right.
+ crib from. They do everything right.
+ Launching NetSurf
The GTK port of NetSurf requires access to some resources at run time.
These are stored in gtk/res/ in the source tree. Some of these files are
@@ -38,6 +42,10 @@
as this still allows the user some flexibility in changing what NetSurf
+ User agent string
You may also want to change NetSurf's user agent string to include the
name of your distribution. The user agent string is build by a function
kept in utils/useragent.c - you'll want to change the macro called
@@ -45,16 +53,23 @@
mind when changing it. The first two printf parameters are major and minor
version numbers, the second two are OS name (uname -s) and architecure
(uname -m). You might want change this to something like:
- "NetSurf/%d.%d (%s; %s; Debian GNU/Linux)"
+ "NetSurf/%d.%d (%s; %s; Debian GNU/Linux)"
or similar. Please don't be tempted to mention Mozilla or similar - let's
let that lie die.
- If the user hasn't specified one in their Preferences, NetSurf defaults to
- visiting a "portal" welcome page on - if you
- wish to change this, you need to do it two places currently; in the
+ Home page URL
+ If the user hasn't specified a home page URL in their Preferences, NetSurf
+ defaults to a "portal" welcome page on - if
+ you wish to change this, you need to do it two places currently; in the
function gui_init2() in gtk/gtk_gui.c and nsgtk_window_home_button_clicked()
in gtk/gtk_scaffolding.c.
If you make significant changes to NetSurf in your package, please ask your
users to report bugs to your bug tracker, not ours. We'd also be interested
in seeing the diffs for these changes - we may be able to integrate them