mirror of
git://git.suckless.org/surf
synced 2024-12-13 10:15:26 +00:00
168 lines
3.1 KiB
Groff
168 lines
3.1 KiB
Groff
.TH SURF 1 surf\-VERSION
|
|
.SH NAME
|
|
surf \- simple webkit-based browser
|
|
.SH SYNOPSIS
|
|
.B surf
|
|
.RB [-c\ cookiefile]
|
|
.RB [-e\ xid]
|
|
.RB [-i]
|
|
.RB [-p]
|
|
.RB [-r\ scriptfile]
|
|
.RB [-s]
|
|
.RB [-t\ stylefile]
|
|
.RB [-u\ useragent]
|
|
.RB [-v]
|
|
.RB [-x]
|
|
.RB "URI"
|
|
.SH DESCRIPTION
|
|
surf is a simple Web browser based on WebKit/GTK+. It is able
|
|
to display websites and follow links. It supports the XEmbed protocol
|
|
which makes it possible to embed it in another application. Furthermore,
|
|
one can point surf to another URI by setting its XProperties.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-c cookiefile
|
|
Specify the cookiefile to use.
|
|
.TP
|
|
.B \-e xid
|
|
Reparents to window specified by xid.
|
|
.TP
|
|
.B \-i
|
|
Disable Images
|
|
.TP
|
|
.B \-p
|
|
Disable Plugins
|
|
.TP
|
|
.B \-r scriptfile
|
|
Specify the user scriptfile.
|
|
.TP
|
|
.B \-s
|
|
Disable Javascript
|
|
.TP
|
|
.B \-t stylefile
|
|
Specify the user stylefile.
|
|
.TP
|
|
.B \-u useragent
|
|
Specify the 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
|
|
.BR xprop(1).
|
|
.SH USAGE
|
|
.B Escape
|
|
Stops loading current page or stops download.
|
|
.TP
|
|
.B Ctrl\-h
|
|
Walks back the history.
|
|
.TP
|
|
.B Ctrl\-l
|
|
Walks forward the history.
|
|
.TP
|
|
.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\-h
|
|
Navigate back one step in history.
|
|
.TP
|
|
.B Ctrl\-l
|
|
Navigate forward one step in history.
|
|
.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
|
|
.B Ctrl\-Shift\-r
|
|
Reloads the website without using cache.
|
|
.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\-c
|
|
Toggle caret browsing.
|
|
.TP
|
|
.B Ctrl\-Shift\-i
|
|
Toggle auto-loading of images.
|
|
.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 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 nspluginwrapper(1)
|
|
.SH BUGS
|
|
Please report them!
|