surf \- simple webkit-based browser
.SH SYNOPSIS
.B surf
+.RB [-bBfFgGiIkKnNpPsSvx]
+.RB [-a\ cookiepolicies]
.RB [-c\ cookiefile]
.RB [-e\ xid]
-.RB [-i]
-.RB [-p]
.RB [-r\ scriptfile]
-.RB [-s]
.RB [-t\ stylefile]
-.RB [-v]
-.RB [-x]
+.RB [-u\ useragent]
+.RB [-z\ zoomlevel]
.RB "URI"
.SH DESCRIPTION
surf is a simple Web browser based on WebKit/GTK+. It is able
one can point surf to another URI by setting its XProperties.
.SH OPTIONS
.TP
+.B \-a cookiepolicies
+Define the order of
+.I cookie policies.
+The default is "Aa@" but could be
+redefined in the
+.I config.h,
+with "A" meaning to
+accept all cookies, "a" to deny all cookies and "@", which tells surf to
+accept no third party cookies.
+.TP
+.B \-b
+Disable Scrollbars
+.TP
+.B \-B
+Enable Scrollbars
+.TP
.B \-c cookiefile
-Specify the cookiefile to use.
+Specify the
+.I cookiefile
+to use.
.TP
.B \-e xid
-Reparents to window specified by xid.
+Reparents to window specified by
+.I xid.
+.TP
+.B \-f
+Run surf in fullscreen mode.
+.TP
+.B \-F
+Disable to run in fullscreen by default.
+.TP
+.B \-g
+Disable giving the geolocation to websites.
+.TP
+.B \-G
+Enable giving the geolocation to websites.
.TP
.B \-i
Disable Images
.TP
+.B \-I
+Enable Images
+.TP
+.B \-k
+Disable kiosk mode (disable key strokes and right click)
+.TP
+.B \-K
+Enable kiosk mode (disable key strokes and right click)
+.TP
+.B \-n
+Disable the Web Inspector (Developer Tools).
+.TP
+.B \-N
+Enable the Web Inspector (Developer Tools).
+.TP
.B \-p
Disable Plugins
.TP
+.B \-P
+Enable Plugins
+.TP
.B \-r scriptfile
-Specify the user scriptfile.
+Specify the user
+.I scriptfile.
.TP
.B \-s
Disable Javascript
.TP
+.B \-S
+Enable Javascript
+.TP
.B \-t stylefile
-Specify the user stylefile.
+Specify the user
+.I stylefile.
+.TP
+.B \-u useragent
+Specify the
+.I useragent
+which surf should use.
.TP
.B \-v
Prints version information to standard output, then exits.
.TP
.B \-x
-Prints xid to standard output. This can be used to script the browser by using
+Prints xid to standard output. This can be used to script the browser in for
+example
+.BR xdotool(1).
+.TP
+.B \-z zoomlevel
+Specify the
+.I zoomlevel
+which surf should use.
.BR xprop(1).
.SH USAGE
.B Escape
.B Ctrl\-j
Scrolls page downwards.
.TP
-.B Ctrl\-Shift\-k
+.B Ctrl\-b
+Scroll up one whole page view.
+.TP
+.B Ctrl\-Space
+Scroll down one whole page view.
+.TP
+.B Ctrl\-i
+Scroll horizontally to the right.
+.TP
+.B Ctrl\-u
+Scroll horizontally to the left.
+.TP
+.B Ctrl\-Shift\-k or Ctrl\-+
Zooms page in.
.TP
-.B Ctrl\-Shift\-j
+.B Ctrl\-Shift\-j or Ctrl\--
Zooms page out
.TP
-.B Ctrl\-Shift\-i
+.B Ctrl\-Shift\-q
Resets Zoom
.TP
-.B Ctrl\-f
+.B Ctrl\-f and Ctrl\-/
Opens the search-bar.
.TP
.B Ctrl\-n
Go to previous search result.
.TP
.B Ctrl\-g
-Opens the URL-bar.
+Opens the URL-bar (requires dmenu installed).
.TP
.B Ctrl\-p
Loads URI from primary selection.
Reloads the website.
.TP
.B Ctrl\-Shift\-r
-Reloads the website without using cache.
+Reloads the website without using the cache.
.TP
.B Ctrl\-y
Copies current URI to primary selection.
.TP
.B Ctrl\-o
-show the sourcecode of the current page.
-.SH ENVIRONMENT
+Show the sourcecode of the current page.
+.TP
+.B Ctrl\-Shift\-a
+Toggle through the the
+.I cookie policies.
+This will not reload the page.
+.TP
+.B Ctrl\-Shift\-b
+Toggle scrollbars. This will reload the page.
+.TP
+.B Ctrl\-Shift\-c
+Toggle caret browsing. This will reload the page.
.TP
+.B Ctrl\-Shift\-i
+Toggle auto-loading of images. This will reload the page.
+.TP
+.B Ctrl\-Shift\-m
+Toggle if the
+.I stylefile
+file should be loaded. This will reload the page.
+.TP
+.B Ctrl\-Shift\-o
+Open the Web Inspector (Developer Tools) window for the current page.
+.TP
+.B Ctrl\-Shift\-s
+Toggle script execution. This will reload the page.
+.TP
+.B Ctrl\-Shift\-v
+Toggle the enabling of plugins on that surf instance. This will reload the
+page.
+.TP
+.B F11
+Toggle fullscreen mode.
+.SH ENVIRONMENT
.B SURF_USERAGENT
-If this variable is set upon startup, surf will use it as the useragent string
+If this variable is set upon startup, surf will use it as the
+.I useragent
+string
.TP
.B http_proxy
If this variable is set and not empty upon startup, surf will use it as the http proxy
+.SH PLUGINS
+For using plugins in surf, first determine your running architecture. Then get
+the appropriate plugin for that architecture and copy it to
+.BR /usr/lib/browser-plugins
+or
+.BR /usr/lib64/browser-plugins.
+Surf should load them automatically.
+.BR
+If you want to use a 32bit plugin on a 64bit system,
+.BR nspluginwrapper(1)
+will help you.
.SH SEE ALSO
.BR dmenu(1),
.BR xprop(1),
-.BR tabbed(1)
+.BR tabbed(1),
+.BR nspluginwrapper(1),
+.BR xdotool(1)
.SH BUGS
Please report them!