README - surf - Surf web browser.
(HTM) git clone git://r-36.net/surf
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
(DIR) LICENSE
---
README (1346B)
---
1 surf - simple webkit-based browser
2 ==================================
3 surf is a simple Web browser based on WebKit/GTK+.
4
5 Requirements
6 ------------
7 In order to build surf you need GTK+ and Webkit/GTK+ header files.
8
9 In order to use the functionality of the url-bar, also install dmenu[0].
10
11 Surf is running a "download" script when a file needs to be downloaded and a
12 "plumb" script when some URI needs to be opened, which is not beginning with
13 "about:", "http://" or "https://". Please create them in your $PATH prior to
14 using surf.
15
16 An example file for the User-Agent switching file is supplied in
17 "useragents.txt". You may need to adapt them to the current world situation.
18
19 Installation
20 ------------
21 Edit config.mk to match your local setup (surf is installed into
22 the /usr/local namespace by default).
23
24 Afterwards enter the following command to build and install surf (if
25 necessary as root):
26
27 make clean install
28
29 Running surf
30 ------------
31 run
32 surf [URI]
33
34 See the manpage for further options.
35
36 Running surf in tabbed
37 ----------------------
38 For running surf in tabbed[1] there is a script included in the distribution,
39 which is run like this:
40
41 surf-open.sh [URI]
42
43 Further invocations of the script will run surf with the specified URI in this
44 instance of tabbed.
45
46 [0] http://tools.suckless.org/dmenu
47 [1] http://tools.suckless.org/tabbed
48