2f3b1e5f34188e2d6928ae3d5fb34f4a87ed26ad
[surf.git] / surf.1
1 .TH SURF 1 surf\-VERSION
2 .SH NAME
3 surf \- simple webkit-based browser
4 .SH SYNOPSIS
5 .B surf
6 .RB [-c\ cookiefile]
7 .RB [-e\ xid]
8 .RB [-i]
9 .RB [-p]
10 .RB [-r\ scriptfile]
11 .RB [-s]
12 .RB [-t\ stylefile]
13 .RB [-u\ useragent]
14 .RB [-v]
15 .RB [-x]
16 .RB "URI"
17 .SH DESCRIPTION
18 surf is a simple Web browser based on WebKit/GTK+. It is able
19 to display websites and follow links. It supports the XEmbed protocol
20 which makes it possible to embed it in another application. Furthermore,
21 one can point surf to another URI by setting its XProperties.
22 .SH OPTIONS
23 .TP
24 .B \-c cookiefile 
25 Specify the cookiefile to use.
26 .TP
27 .B \-e xid
28 Reparents to window specified by xid.
29 .TP
30 .B \-i
31 Disable Images
32 .TP
33 .B \-p
34 Disable Plugins
35 .TP
36 .B \-r scriptfile 
37 Specify the user scriptfile.
38 .TP
39 .B \-s
40 Disable Javascript
41 .TP
42 .B \-t stylefile
43 Specify the user stylefile.
44 .TP
45 .B \-u useragent 
46 Specify the useragent which surf should use.
47 .TP
48 .B \-v
49 Prints version information to standard output, then exits.
50 .TP
51 .B \-x
52 Prints xid to standard output. This can be used to script the browser by using
53 .BR xprop(1).
54 .SH USAGE
55 .B Escape
56 Stops loading current page or stops download.
57 .TP
58 .B Ctrl\-h
59 Walks back the history.
60 .TP
61 .B Ctrl\-l
62 Walks forward the history.
63 .TP
64 .B Ctrl\-k
65 Scrolls page upwards.
66 .TP
67 .B Ctrl\-j
68 Scrolls page downwards.
69 .TP
70 .B Ctrl\-Shift\-k
71 Zooms page in.
72 .TP
73 .B Ctrl\-Shift\-j
74 Zooms page out
75 .TP
76 .B Ctrl\-Shift\-i
77 Resets Zoom
78 .TP
79 .B Ctrl\-f
80 Opens the search-bar.
81 .TP
82 .B Ctrl\-n
83 Go to next search result.
84 .TP
85 .B Ctrl\-Shift\-n
86 Go to previous search result.
87 .TP
88 .B Ctrl\-g
89 Opens the URL-bar.
90 .TP
91 .B Ctrl\-p
92 Loads URI from primary selection.
93 .TP
94 .B Ctrl\-Shift\-p
95 Calls Printpage Dialog.
96 .TP
97 .B Ctrl\-r
98 Reloads the website.
99 .TP
100 .B Ctrl\-Shift\-r
101 Reloads the website without using cache.
102 .TP
103 .B Ctrl\-y
104 Copies current URI to primary selection.
105 .TP
106 .B Ctrl\-o
107 show the sourcecode of the current page.
108 .SH ENVIRONMENT
109 .TP
110 .B SURF_USERAGENT
111 If this variable is set upon startup, surf will use it as the useragent string
112 .TP
113 .B http_proxy
114 If this variable is set and not empty upon startup, surf will use it as the http proxy
115 .SH SEE ALSO
116 .BR dmenu(1),
117 .BR xprop(1),
118 .BR tabbed(1)
119 .SH BUGS
120 Please report them!