surf \- simple webkit-based browser
.SH SYNOPSIS
.B surf
-.RB [-bBdDfFgGiIkKmMnNpPsSvx]
+.RB [-bBdDfFgGiIkKmMnNpPsStTvwxX]
.RB [-a\ cookiepolicies]
.RB [-c\ cookiefile]
+.RB [-C\ stylefile]
.RB [-e\ xid]
.RB [-r\ scriptfile]
-.RB [-t\ stylefile]
.RB [-u\ useragent]
.RB [-z\ zoomlevel]
-.RB "URI"
+.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
.TP
.B \-a cookiepolicies
Define the order of
-.I cookie policies.
-The default is "Aa@" but could be
+.I cookie policies\fR.
+The default is "@Aa" but could be
redefined in the
-.I config.h,
+.IR 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
+Disable Scrollbars.
.TP
.B \-B
-Enable Scrollbars
+Enable Scrollbars.
.TP
-.B \-c cookiefile
+.B \-c cookiefile
Specify the
.I cookiefile
to use.
.TP
+.B \-C stylefile
+Specify the user
+.IR stylefile .
+This does disable the site-specific styles.
+.TP
.B \-d
Disable the disk cache.
.TP
.TP
.B \-e xid
Reparents to window specified by
-.I xid.
+.IR xid .
.TP
.B \-f
-Run surf in fullscreen mode.
+Start surf in windowed mode (not fullscreen).
.TP
.B \-F
-Disable to run in fullscreen by default.
+Start surf in fullscreen mode.
.TP
.B \-g
Disable giving the geolocation to websites.
Enable giving the geolocation to websites.
.TP
.B \-i
-Disable Images
+Disable Images.
.TP
.B \-I
-Enable Images
+Enable Images.
.TP
.B \-k
-Disable kiosk mode (disable key strokes and right click)
+Disable kiosk mode (disable key strokes and right click).
.TP
.B \-K
-Enable kiosk mode (disable key strokes and right click)
+Enable kiosk mode (disable key strokes and right click).
.TP
.B \-m
-Disable the site-specific styles.
+Disable application of user style sheets.
.TP
.B \-M
-Enable the site-specific styles.
+Enable application of user style sheets.
.TP
.B \-n
Disable the Web Inspector (Developer Tools).
Enable the Web Inspector (Developer Tools).
.TP
.B \-p
-Disable Plugins
+Disable Plugins.
.TP
.B \-P
-Enable Plugins
+Enable Plugins.
.TP
-.B \-r scriptfile
+.B \-r scriptfile
Specify the user
-.I scriptfile.
+.IR scriptfile .
.TP
.B \-s
-Disable Javascript
+Disable Javascript.
.TP
.B \-S
-Enable Javascript
+Enable Javascript.
.TP
-.B \-t stylefile
-Specify the user
-.I stylefile.
-This does disable the site-specific styles.
+.B \-t
+Disable strict TLS check.
+.TP
+.B \-T
+Enable strict TLS check.
.TP
-.B \-u useragent
+.B \-u useragent
Specify the
.I useragent
which surf should use.
.B \-v
Prints version information to standard output, then exits.
.TP
-.B \-x
+.B \-w
Prints xid to standard output. This can be used to script the browser in for
example
-.BR xdotool(1).
+.BR xdotool(1) .
.TP
-.B \-z zoomlevel
+.B -x
+Disable custom certificates.
+.TP
+.B -X
+Enable custom certificates.
+.TP
+.B \-z zoomlevel
Specify the
.I zoomlevel
which surf should use.
-.BR xprop(1).
.SH USAGE
.B Escape
Stops loading current page or stops download.
Zooms page in.
.TP
.B Ctrl\-Shift\-j or Ctrl\--
-Zooms page out
+Zooms page out.
.TP
.B Ctrl\-Shift\-q
-Resets Zoom
+Resets Zoom.
.TP
.B Ctrl\-f and Ctrl\-/
Opens the search-bar.
.B Ctrl\-y
Copies current URI to primary selection.
.TP
-.B Ctrl\-o
-Show the sourcecode of the current page.
+.B Ctrl\-t
+Display the current TLS certificate in a popup window.
.TP
.B Ctrl\-Shift\-a
Toggle through the the
-.I cookie policies.
+.I cookie policies\fR.
This will not reload the page.
.TP
.B Ctrl\-Shift\-b
.TP
.B Ctrl\-Shift\-m
Toggle if the
-.I stylefile
+.I stylefile
file should be loaded. This will reload the page.
.TP
.B Ctrl\-Shift\-o
.B Ctrl\-Shift\-s
Toggle script execution. This will reload the page.
.TP
+.B Ctrl\-Shift\-t
+Toggle strict TLS check. This will reload the page.
+.TP
.B Ctrl\-Shift\-v
Toggle the enabling of plugins on that surf instance. This will reload the
page.
.B F11
Toggle fullscreen mode.
.SH INDICATORS OF OPERATION
-For all indicators, unless otherwsie specified, a lower case letter means disabled and an upper case letter means enabled.
+Surf is showing indicators of operation in front of the site title.
+For all indicators, unless otherwise specified, a lower case letter means disabled and an upper case letter means enabled.
.TP
.B A
all cookies accepted
.TP
.B m M
styles
+.TP
+.B f F
+frame flattening
+.TP
+.B x X
+custom certificates
+.TP
+.B t T
+strict TLS
.SH INDICATORS OF WEB PAGE
+The second part of the indicators specifies modes of the web page itself.
.SS First character: encryption
.TP
.B -
unencrypted
.TP
.B T
-encrypted (SSL)
+encrypted (TLS)
.TP
.B U
attempted encryption but failed
.B SURF_USERAGENT
If this variable is set upon startup, surf will use it as the
.I useragent
-string
+string.
.TP
.B http_proxy
-If this variable is set and not empty upon startup, surf will use it as the http proxy
+If this variable is set and not empty upon startup, surf will use it as the http proxy.
+.SH SIGNALS
+Surf will reload the current page on
+.BR SIGHUP .
.SH PLUGINS
For using plugins in surf, first determine your running architecture. Then get
the appropriate plugin for that architecture and copy it to