2009-06-08 06:16:39 +00:00
|
|
|
.TH SURF 1 surf\-VERSION
|
|
|
|
.SH NAME
|
2009-08-27 08:13:34 +00:00
|
|
|
surf \- simple webkit-based browser
|
2009-06-08 06:16:39 +00:00
|
|
|
.SH SYNOPSIS
|
|
|
|
.B surf
|
2013-08-31 18:00:41 +00:00
|
|
|
.RB [-bBfFgGiIkKnNpPsSvx]
|
2014-01-30 19:36:06 +00:00
|
|
|
.RB [-a\ cookiepolicies]
|
2012-10-31 20:13:50 +00:00
|
|
|
.RB [-c\ cookiefile]
|
2010-03-24 23:05:37 +00:00
|
|
|
.RB [-e\ xid]
|
2012-10-31 20:13:50 +00:00
|
|
|
.RB [-r\ scriptfile]
|
|
|
|
.RB [-t\ stylefile]
|
2012-10-31 20:25:14 +00:00
|
|
|
.RB [-u\ useragent]
|
2013-10-19 16:55:53 +00:00
|
|
|
.RB [-z\ zoomlevel]
|
2009-09-06 11:27:28 +00:00
|
|
|
.RB "URI"
|
2009-06-08 06:16:39 +00:00
|
|
|
.SH DESCRIPTION
|
2009-09-04 11:23:36 +00:00
|
|
|
surf is a simple Web browser based on WebKit/GTK+. It is able
|
2009-08-27 08:13:34 +00:00
|
|
|
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.
|
2009-06-08 06:16:39 +00:00
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
2014-01-30 19:36:06 +00:00
|
|
|
.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
|
2014-01-30 19:57:24 +00:00
|
|
|
accept no third party cookies.
|
2014-01-30 19:36:06 +00:00
|
|
|
.TP
|
2013-02-21 14:59:07 +00:00
|
|
|
.B \-b
|
|
|
|
Disable Scrollbars
|
|
|
|
.TP
|
2013-05-21 19:30:00 +00:00
|
|
|
.B \-B
|
|
|
|
Enable Scrollbars
|
|
|
|
.TP
|
2012-10-31 20:13:50 +00:00
|
|
|
.B \-c cookiefile
|
2013-02-16 15:18:05 +00:00
|
|
|
Specify the
|
|
|
|
.I cookiefile
|
|
|
|
to use.
|
2012-10-31 20:13:50 +00:00
|
|
|
.TP
|
2010-01-20 13:46:22 +00:00
|
|
|
.B \-e xid
|
2013-02-16 15:18:05 +00:00
|
|
|
Reparents to window specified by
|
|
|
|
.I xid.
|
2009-06-08 06:16:39 +00:00
|
|
|
.TP
|
2013-08-25 17:50:40 +00:00
|
|
|
.B \-f
|
|
|
|
Run surf in fullscreen mode.
|
|
|
|
.TP
|
2013-08-31 18:00:41 +00:00
|
|
|
.B \-F
|
|
|
|
Disable to run in fullscreen by default.
|
|
|
|
.TP
|
2013-04-28 19:26:56 +00:00
|
|
|
.B \-g
|
|
|
|
Disable giving the geolocation to websites.
|
|
|
|
.TP
|
2013-05-21 19:30:00 +00:00
|
|
|
.B \-G
|
|
|
|
Enable giving the geolocation to websites.
|
|
|
|
.TP
|
2010-03-24 23:05:37 +00:00
|
|
|
.B \-i
|
|
|
|
Disable Images
|
|
|
|
.TP
|
2013-05-21 19:30:00 +00:00
|
|
|
.B \-I
|
|
|
|
Enable Images
|
|
|
|
.TP
|
2013-03-11 20:26:22 +00:00
|
|
|
.B \-k
|
2013-05-21 19:30:00 +00:00
|
|
|
Disable kiosk mode (disable key strokes and right click)
|
|
|
|
.TP
|
|
|
|
.B \-K
|
2013-03-11 20:26:22 +00:00
|
|
|
Enable kiosk mode (disable key strokes and right click)
|
|
|
|
.TP
|
2013-01-26 14:53:33 +00:00
|
|
|
.B \-n
|
|
|
|
Disable the Web Inspector (Developer Tools).
|
|
|
|
.TP
|
2013-05-21 19:30:00 +00:00
|
|
|
.B \-N
|
|
|
|
Enable the Web Inspector (Developer Tools).
|
|
|
|
.TP
|
2010-03-24 23:05:37 +00:00
|
|
|
.B \-p
|
|
|
|
Disable Plugins
|
|
|
|
.TP
|
2013-05-21 19:30:00 +00:00
|
|
|
.B \-P
|
|
|
|
Enable Plugins
|
|
|
|
.TP
|
2012-10-31 20:13:50 +00:00
|
|
|
.B \-r scriptfile
|
2013-02-16 15:18:05 +00:00
|
|
|
Specify the user
|
|
|
|
.I scriptfile.
|
2012-10-31 20:13:50 +00:00
|
|
|
.TP
|
2010-03-24 23:05:37 +00:00
|
|
|
.B \-s
|
|
|
|
Disable Javascript
|
2009-06-08 06:16:39 +00:00
|
|
|
.TP
|
2013-05-21 19:30:00 +00:00
|
|
|
.B \-S
|
|
|
|
Enable Javascript
|
|
|
|
.TP
|
2012-10-31 20:13:50 +00:00
|
|
|
.B \-t stylefile
|
2013-02-16 15:18:05 +00:00
|
|
|
Specify the user
|
|
|
|
.I stylefile.
|
2012-10-31 20:13:50 +00:00
|
|
|
.TP
|
2012-10-31 20:25:14 +00:00
|
|
|
.B \-u useragent
|
2013-02-16 15:18:05 +00:00
|
|
|
Specify the
|
|
|
|
.I useragent
|
|
|
|
which surf should use.
|
2012-10-31 20:25:14 +00:00
|
|
|
.TP
|
2009-06-08 06:16:39 +00:00
|
|
|
.B \-v
|
2009-08-27 08:13:34 +00:00
|
|
|
Prints version information to standard output, then exits.
|
2009-06-08 06:16:39 +00:00
|
|
|
.TP
|
|
|
|
.B \-x
|
2009-08-27 08:13:34 +00:00
|
|
|
Prints xid to standard output. This can be used to script the browser by using
|
2013-10-19 16:55:53 +00:00
|
|
|
.TP
|
|
|
|
.B \-z zoomlevel
|
|
|
|
Specify the
|
|
|
|
.I zoomlevel
|
|
|
|
which surf should use.
|
2009-09-04 11:23:36 +00:00
|
|
|
.BR xprop(1).
|
2009-06-08 06:16:39 +00:00
|
|
|
.SH USAGE
|
2009-12-15 16:16:01 +00:00
|
|
|
.B Escape
|
|
|
|
Stops loading current page or stops download.
|
2009-06-08 06:16:39 +00:00
|
|
|
.TP
|
2009-09-06 08:56:09 +00:00
|
|
|
.B Ctrl\-h
|
2009-06-08 06:16:39 +00:00
|
|
|
Walks back the history.
|
|
|
|
.TP
|
2009-09-06 08:56:09 +00:00
|
|
|
.B Ctrl\-l
|
2009-06-08 06:16:39 +00:00
|
|
|
Walks forward the history.
|
|
|
|
.TP
|
2009-10-17 13:17:58 +00:00
|
|
|
.B Ctrl\-k
|
|
|
|
Scrolls page upwards.
|
|
|
|
.TP
|
|
|
|
.B Ctrl\-j
|
|
|
|
Scrolls page downwards.
|
|
|
|
.TP
|
2012-11-15 14:26:48 +00:00
|
|
|
.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
|
2012-12-02 21:41:18 +00:00
|
|
|
.B Ctrl\-Shift\-k or Ctrl\-+
|
2009-10-17 13:17:58 +00:00
|
|
|
Zooms page in.
|
|
|
|
.TP
|
2012-12-02 21:41:18 +00:00
|
|
|
.B Ctrl\-Shift\-j or Ctrl\--
|
2009-10-17 13:17:58 +00:00
|
|
|
Zooms page out
|
|
|
|
.TP
|
2012-12-02 21:48:41 +00:00
|
|
|
.B Ctrl\-Shift\-q
|
2009-10-17 13:17:58 +00:00
|
|
|
Resets Zoom
|
|
|
|
.TP
|
2013-05-11 20:01:02 +00:00
|
|
|
.B Ctrl\-f and Ctrl\-\e
|
2009-06-08 06:16:39 +00:00
|
|
|
Opens the search-bar.
|
|
|
|
.TP
|
2009-12-15 16:16:01 +00:00
|
|
|
.B Ctrl\-n
|
|
|
|
Go to next search result.
|
|
|
|
.TP
|
|
|
|
.B Ctrl\-Shift\-n
|
|
|
|
Go to previous search result.
|
|
|
|
.TP
|
2009-06-08 06:16:39 +00:00
|
|
|
.B Ctrl\-g
|
2014-05-17 17:24:25 +00:00
|
|
|
Opens the URL-bar (requires dmenu installed).
|
2009-06-08 06:16:39 +00:00
|
|
|
.TP
|
2009-06-10 11:33:26 +00:00
|
|
|
.B Ctrl\-p
|
|
|
|
Loads URI from primary selection.
|
|
|
|
.TP
|
2009-10-17 13:17:58 +00:00
|
|
|
.B Ctrl\-Shift\-p
|
|
|
|
Calls Printpage Dialog.
|
|
|
|
.TP
|
2009-06-08 06:16:39 +00:00
|
|
|
.B Ctrl\-r
|
|
|
|
Reloads the website.
|
|
|
|
.TP
|
|
|
|
.B Ctrl\-Shift\-r
|
2014-01-30 19:36:06 +00:00
|
|
|
Reloads the website without using the cache.
|
2009-06-10 11:33:26 +00:00
|
|
|
.TP
|
|
|
|
.B Ctrl\-y
|
|
|
|
Copies current URI to primary selection.
|
2009-10-17 13:17:58 +00:00
|
|
|
.TP
|
|
|
|
.B Ctrl\-o
|
2012-11-15 14:26:48 +00:00
|
|
|
Show the sourcecode of the current page.
|
|
|
|
.TP
|
2014-01-30 19:36:06 +00:00
|
|
|
.B Ctrl\-Shift\-a
|
|
|
|
Toggle through the the
|
|
|
|
.I cookie policies.
|
|
|
|
This will not reload the page.
|
|
|
|
.TP
|
2013-02-21 14:59:07 +00:00
|
|
|
.B Ctrl\-Shift\-b
|
2014-01-30 19:36:06 +00:00
|
|
|
Toggle scrollbars. This will reload the page.
|
2013-01-26 14:53:33 +00:00
|
|
|
.TP
|
2012-11-20 15:14:28 +00:00
|
|
|
.B Ctrl\-Shift\-c
|
2014-01-30 19:36:06 +00:00
|
|
|
Toggle caret browsing. This will reload the page.
|
2012-11-15 14:26:48 +00:00
|
|
|
.TP
|
|
|
|
.B Ctrl\-Shift\-i
|
2014-01-30 19:36:06 +00:00
|
|
|
Toggle auto-loading of images. This will reload the page.
|
2012-11-15 14:26:48 +00:00
|
|
|
.TP
|
2013-02-16 15:18:05 +00:00
|
|
|
.B Ctrl\-Shift\-m
|
|
|
|
Toggle if the
|
|
|
|
.I stylefile
|
2014-01-30 19:36:06 +00:00
|
|
|
file should be loaded. This will reload the page.
|
2013-02-16 15:18:05 +00:00
|
|
|
.TP
|
2013-02-21 14:59:07 +00:00
|
|
|
.B Ctrl\-Shift\-o
|
|
|
|
Open the Web Inspector (Developer Tools) window for the current page.
|
|
|
|
.TP
|
2012-11-15 14:26:48 +00:00
|
|
|
.B Ctrl\-Shift\-s
|
2014-01-30 19:36:06 +00:00
|
|
|
Toggle script execution. This will reload the page.
|
2012-11-20 15:14:28 +00:00
|
|
|
.TP
|
|
|
|
.B Ctrl\-Shift\-v
|
2014-01-30 19:36:06 +00:00
|
|
|
Toggle the enabling of plugins on that surf instance. This will reload the
|
|
|
|
page.
|
2012-12-03 20:27:39 +00:00
|
|
|
.TP
|
|
|
|
.B F11
|
|
|
|
Toggle fullscreen mode.
|
2012-03-26 07:33:42 +00:00
|
|
|
.SH ENVIRONMENT
|
|
|
|
.B SURF_USERAGENT
|
2013-02-16 15:18:05 +00:00
|
|
|
If this variable is set upon startup, surf will use it as the
|
|
|
|
.I useragent
|
|
|
|
string
|
2012-03-26 07:33:42 +00:00
|
|
|
.TP
|
|
|
|
.B http_proxy
|
|
|
|
If this variable is set and not empty upon startup, surf will use it as the http proxy
|
2012-12-04 06:26:12 +00:00
|
|
|
.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.
|
2009-06-08 06:16:39 +00:00
|
|
|
.SH SEE ALSO
|
2011-11-09 14:09:59 +00:00
|
|
|
.BR dmenu(1),
|
|
|
|
.BR xprop(1),
|
2012-12-04 06:26:12 +00:00
|
|
|
.BR tabbed(1),
|
|
|
|
.BR nspluginwrapper(1)
|
2009-06-08 06:16:39 +00:00
|
|
|
.SH BUGS
|
|
|
|
Please report them!
|