surf

Surf web browser.
git clone git://r-36.net/surf
Log | Files | Refs | README | 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!