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!