aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorjoe <rbo@gmx.us>2025-09-30 18:03:23 +0200
committerjoe <rbo@gmx.us>2025-09-30 18:03:23 +0200
commit29dab718af747d7b8207c1cbfb49de65f0a26306 (patch)
tree69493e61ed9702b33d45436d06c040bc4456571c /README
downloadsurf-29dab718af747d7b8207c1cbfb49de65f0a26306.tar.gz
surf-29dab718af747d7b8207c1cbfb49de65f0a26306.tar.bz2
surf-29dab718af747d7b8207c1cbfb49de65f0a26306.tar.xz
surf-29dab718af747d7b8207c1cbfb49de65f0a26306.tar.zst
surf-29dab718af747d7b8207c1cbfb49de65f0a26306.zip
surfin
Diffstat (limited to 'README')
-rw-r--r--README40
1 files changed, 40 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..da4577f
--- /dev/null
+++ b/README
@@ -0,0 +1,40 @@
+surf - simple webkit-based browser
+==================================
+surf is a simple Web browser based on WebKit/GTK+.
+
+Requirements
+------------
+In order to build surf you need GTK+ and Webkit/GTK+ header files.
+
+In order to use the functionality of the url-bar, also install dmenu[0].
+
+Installation
+------------
+Edit config.mk to match your local setup (surf is installed into
+the /usr/local namespace by default).
+
+Afterwards enter the following command to build and install surf (if
+necessary as root):
+
+ make clean install
+
+Running surf
+------------
+run
+ surf [URI]
+
+See the manpage for further options.
+
+Running surf in tabbed
+----------------------
+For running surf in tabbed[1] there is a script included in the distribution,
+which is run like this:
+
+ surf-open.sh [URI]
+
+Further invocations of the script will run surf with the specified URI in this
+instance of tabbed.
+
+[0] http://tools.suckless.org/dmenu
+[1] http://tools.suckless.org/tabbed
+