surf \- simple webkit-based browser
.SH SYNOPSIS
.B surf
-.RB [ \-ehvx ]
+.RB [-biknpsvx]
+.RB [-c\ cookiefile]
+.RB [-e\ xid]
+.RB [-r\ scriptfile]
+.RB [-t\ stylefile]
+.RB [-u\ useragent]
.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 \-e
-Prints xid to standard output and waits until an application reparents the
-window.
+.B \-b
+Disable Scrollbars
.TP
-.B \-h
-Prints usage information to standard output, then exits.
+.B \-c cookiefile
+Specify the
+.I cookiefile
+to use.
+.TP
+.B \-e xid
+Reparents to window specified by
+.I xid.
+.TP
+.B \-i
+Disable Images
+.TP
+.B \-k
+Enable kiosk mode (disable key strokes and right click)
+.TP
+.B \-n
+Disable the Web Inspector (Developer Tools).
+.TP
+.B \-p
+Disable Plugins
+.TP
+.B \-r scriptfile
+Specify the user
+.I scriptfile.
+.TP
+.B \-s
+Disable Javascript
+.TP
+.B \-t 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.
Prints xid to standard output. This can be used to script the browser by using
.BR xprop(1).
.SH USAGE
+.B Escape
+Stops loading current page or stops download.
.TP
.B Ctrl\-h
Walks back the history.
.B Ctrl\-l
Walks forward the history.
.TP
-.B Ctrl\-/
+.B Ctrl\-k
+Scrolls page upwards.
+.TP
+.B Ctrl\-j
+Scrolls page downwards.
+.TP
+.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 or Ctrl\--
+Zooms page out
+.TP
+.B Ctrl\-Shift\-q
+Resets Zoom
+.TP
+.B Ctrl\-f and Ctrl\-\\
Opens the search-bar.
.TP
+.B Ctrl\-n
+Go to next search result.
+.TP
+.B Ctrl\-Shift\-n
+Go to previous search result.
+.TP
.B Ctrl\-g
Opens the URL-bar.
.TP
.B Ctrl\-p
Loads URI from primary selection.
.TP
+.B Esc
+Stop loading the page.
+.TP
+.B Ctrl\-Shift\-p
+Calls Printpage Dialog.
+.TP
.B Ctrl\-r
Reloads the website.
.TP
.TP
.B Ctrl\-y
Copies current URI to primary selection.
+.TP
+.B Ctrl\-o
+Show the sourcecode of the current page.
+.TP
+.B Ctrl\-Shift\-b
+Toggle scrollbars
+.TP
+.B Ctrl\-Shift\-c
+Toggle caret browsing.
+.TP
+.B Ctrl\-Shift\-i
+Toggle auto-loading of images.
+.TP
+.B Ctrl\-Shift\-m
+Toggle if the
+.I stylefile
+file should be loaded.
+.TP
+.B Ctrl\-Shift\-o
+Open the Web Inspector (Developer Tools) window for the current page.
+.TP
+.B Ctrl\-Shift\-s
+Toggle script execution.
+.TP
+.B Ctrl\-Shift\-v
+Toggle the enabling of plugins on that surf instance.
+.TP
+.B F11
+Toggle fullscreen mode.
+.SH ENVIRONMENT
+.B SURF_USERAGENT
+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 dmenu(1),
+.BR xprop(1),
+.BR tabbed(1),
+.BR nspluginwrapper(1)
.SH BUGS
Please report them!