surf.1 - surf - Surf web browser.
(HTM) git clone git://r-36.net/surf
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
(DIR) LICENSE
---
surf.1 (6106B)
---
1 .TH SURF 1 surf\-VERSION
2 .SH NAME
3 surf \- simple webkit-based browser
4 .SH SYNOPSIS
5 .B surf
6 .RB [-bBdDfFgGiIkKlLmMnNpPsStTvwWx]
7 .RB [-a\ cookiepolicies]
8 .RB [-c\ cookiefile]
9 .RB [-e\ xid]
10 .RB [-r\ scriptfile]
11 .RB [-y\ stylefile]
12 .RB [-u\ useragent]
13 .RB [-z\ zoomlevel]
14 .RB "URI"
15 .SH DESCRIPTION
16 surf is a simple Web browser based on WebKit/GTK+. It is able
17 to display websites and follow links. It supports the XEmbed protocol
18 which makes it possible to embed it in another application. Furthermore,
19 one can point surf to another URI by setting its XProperties.
20 .SH OPTIONS
21 .TP
22 .B \-a cookiepolicies
23 Define the order of
24 .I cookie policies.
25 The default is "Aa@" but could be
26 redefined in the
27 .I config.h,
28 with "A" meaning to
29 accept all cookies, "a" to deny all cookies and "@", which tells surf to
30 accept no third party cookies.
31 .TP
32 .B \-b
33 Disable Scrollbars
34 .TP
35 .B \-B
36 Enable Scrollbars
37 .TP
38 .B \-c cookiefile
39 Specify the
40 .I cookiefile
41 to use.
42 .TP
43 .B \-d
44 Disable the disk cache.
45 .TP
46 .B \-D
47 Enable the disk cache.
48 .TP
49 .B \-e xid
50 Reparents to window specified by
51 .I xid.
52 .TP
53 .B \-f
54 Start surf in windowed mode (not fullscreen).
55 .TP
56 .B \-F
57 Start surf in fullscreen mode.
58 .TP
59 .B \-g
60 Disable giving the geolocation to websites.
61 .TP
62 .B \-G
63 Enable giving the geolocation to websites.
64 .TP
65 .B \-i
66 Disable Images
67 .TP
68 .B \-I
69 Enable Images
70 .TP
71 .B \-k
72 Disable kiosk mode (disable key strokes and right click)
73 .TP
74 .B \-K
75 Enable kiosk mode (disable key strokes and right click)
76 .TP
77 .B \-l
78 Disable loading of non-HTTPS resources on HTTPS pages.
79 .TP
80 .B \-L
81 Enable loading of non-HTTPS resources on HTTPS pages.
82 .TP
83 .B \-m
84 Disable application of user style sheets.
85 .TP
86 .B \-M
87 Enable application of user style sheets.
88 .TP
89 .B \-n
90 Disable the Web Inspector (Developer Tools).
91 .TP
92 .B \-N
93 Enable the Web Inspector (Developer Tools).
94 .TP
95 .B \-p
96 Disable Plugins
97 .TP
98 .B \-P
99 Enable Plugins
100 .TP
101 .B \-r scriptfile
102 Specify the user
103 .I scriptfile.
104 .TP
105 .B \-s
106 Disable Javascript
107 .TP
108 .B \-S
109 Enable Javascript
110 .TP
111 .B \-t
112 Disable strict SSL/TLS checking.
113 .TP
114 .B \-T
115 Enable strict SSL/TLS checking.
116 .TP
117 .B \-u useragent
118 Specify the
119 .I useragent
120 which surf should use.
121 .TP
122 .B \-v
123 Prints version information to standard output, then exits.
124 .TP
125 .B \-w
126 Disable private browsing.
127 .TP
128 .B \-W
129 Enable private browsing.
130 .TP
131 .B \-x
132 Prints xid to standard output. This can be used to script the browser in for
133 example
134 .TP
135 .B \-y stylefile
136 Specify the user
137 .I stylefile.
138 This does disable the site-specific styles.
139 .BR xdotool(1).
140 .TP
141 .B \-z zoomlevel
142 Specify the
143 .I zoomlevel
144 which surf should use.
145 .BR xprop(1).
146 .SH USAGE
147 .B Escape
148 Stops loading current page or stops download.
149 .TP
150 .B Ctrl\-h
151 Walks back the history.
152 .TP
153 .B Ctrl\-l
154 Walks forward the history.
155 .TP
156 .B Ctrl\-k
157 Scrolls page upwards.
158 .TP
159 .B Ctrl\-j
160 Scrolls page downwards.
161 .TP
162 .B Ctrl\-b
163 Scroll up one whole page view.
164 .TP
165 .B Ctrl\-Space
166 Scroll down one whole page view.
167 .TP
168 .B Ctrl\-i
169 Scroll horizontally to the right.
170 .TP
171 .B Ctrl\-u
172 Scroll horizontally to the left.
173 .TP
174 .B Ctrl\-Shift\-k or Ctrl\-+
175 Zooms page in.
176 .TP
177 .B Ctrl\-Shift\-j or Ctrl\--
178 Zooms page out
179 .TP
180 .B Ctrl\-Shift\-q
181 Resets Zoom
182 .TP
183 .B Ctrl\-f and Ctrl\-/
184 Opens the search-bar.
185 .TP
186 .B Ctrl\-n
187 Go to next search result.
188 .TP
189 .B Ctrl\-Shift\-n
190 Go to previous search result.
191 .TP
192 .B Ctrl\-g
193 Opens the URL-bar (requires dmenu installed).
194 .TP
195 .B Ctrl\-p
196 Loads URI from primary selection.
197 .TP
198 .B Ctrl\-Shift\-p
199 Calls Printpage Dialog.
200 .TP
201 .B Ctrl\-r
202 Reloads the website.
203 .TP
204 .B Ctrl\-Shift\-r
205 Reloads the website without using the cache.
206 .TP
207 .B Ctrl\-y
208 Copies current URI to primary selection.
209 .TP
210 .B Ctrl\-o
211 Show the sourcecode of the current page.
212 .TP
213 .B Ctrl\-Shift\-a
214 Toggle through the the
215 .I cookie policies.
216 This will not reload the page.
217 .TP
218 .B Ctrl\-Shift\-b
219 Toggle scrollbars. This will reload the page.
220 .TP
221 .B Ctrl\-Shift\-c
222 Toggle caret browsing. This will reload the page.
223 .TP
224 .B Ctrl\-Shift\-i
225 Toggle auto-loading of images. This will reload the page.
226 .TP
227 .B Ctrl\-Shift\-m
228 Toggle if the
229 .I stylefile
230 file should be loaded. This will reload the page.
231 .TP
232 .B Ctrl\-Shift\-o
233 Open the Web Inspector (Developer Tools) window for the current page.
234 .TP
235 .B Ctrl\-Shift\-s
236 Toggle script execution. This will reload the page.
237 .TP
238 .B Ctrl\-Shift\-v
239 Toggle the enabling of plugins on that surf instance. This will reload the
240 page.
241 .TP
242 .B Ctrl\-Shift\-y
243 Toggle if a proxy should be used (if one is set in the environment).
244 .TP
245 .B F11
246 Toggle fullscreen mode.
247 .SH INDICATORS OF OPERATION
248 Surf is showing indicators of operation in front of the site title.
249 For all indicators, unless otherwise specified, a lower case letter means disabled and an upper case letter means enabled.
250 .TP
251 .B A
252 all cookies accepted
253 .TP
254 .B a
255 no cookies accepted
256 .TP
257 .B @
258 all except third-party cookies accepted
259 .TP
260 .B c C
261 caret browsing
262 .TP
263 .B g G
264 geolocation
265 .TP
266 .B d D
267 disk cache
268 .TP
269 .B i I
270 images
271 .TP
272 .B s S
273 scripts
274 .TP
275 .B v V
276 plugins
277 .TP
278 .B m M
279 styles
280 .SH INDICATORS OF WEB PAGE
281 The second part of the indicators specifies modes of the web page itself.
282 .SS First character: encryption
283 .TP
284 .B -
285 unencrypted
286 .TP
287 .B T
288 encrypted (SSL)
289 .TP
290 .B U
291 attempted encryption but failed
292 .SS Second character: proxying
293 .TP
294 .B -
295 no proxy
296 .TP
297 .B P
298 using proxy
299 .SH ENVIRONMENT
300 .B SURF_USERAGENT
301 If this variable is set upon startup, surf will use it as the
302 .I useragent
303 string
304 .TP
305 .B http_proxy
306 If this variable is set and not empty upon startup, surf will use it as the http proxy
307 .TP
308 .B no_proxy
309 If both http_proxy is set and no_proxy contain a
310 .BR comma-separated
311 list of domain extensions and both is not empty upon startup, proxy will
312 .BR not
313 be used for each of the elements in no_proxy.
314 .SH PLUGINS
315 For using plugins in surf, first determine your running architecture. Then get
316 the appropriate plugin for that architecture and copy it to
317 .BR /usr/lib/browser-plugins
318 or
319 .BR /usr/lib64/browser-plugins.
320 Surf should load them automatically.
321 .BR
322 If you want to use a 32bit plugin on a 64bit system,
323 .BR nspluginwrapper(1)
324 will help you.
325 .SH SEE ALSO
326 .BR dmenu(1),
327 .BR xprop(1),
328 .BR tabbed(1),
329 .BR nspluginwrapper(1),
330 .BR xdotool(1)
331 .SH BUGS
332 Please report them!