X-Git-Url: https://git.danieliu.xyz/?a=blobdiff_plain;f=surf.1;h=5b194ecf2ed51856ecab864cc0719c5d98cbe026;hb=780cca964ca0cf622746ad6e8cae8beb8047d1df;hp=ce72203c6175e07c7ee56ee1d7130938407088f1;hpb=b8f45a588d7fde9d16c1919783dfb4ebff395001;p=surf.git diff --git a/surf.1 b/surf.1 index ce72203..5b194ec 100644 --- a/surf.1 +++ b/surf.1 @@ -3,12 +3,14 @@ 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 [-s] -.RB [-v] -.RB [-x] +.RB [-r\ scriptfile] +.RB [-t\ stylefile] +.RB [-u\ useragent] +.RB [-z\ zoomlevel] .RB "URI" .SH DESCRIPTION surf is a simple Web browser based on WebKit/GTK+. It is able @@ -17,23 +19,96 @@ 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 \-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 all third party cookies. +.TP +.B \-b +Disable Scrollbars +.TP +.B \-B +Enable Scrollbars +.TP +.B \-c cookiefile +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 +.I scriptfile. +.TP .B \-s Disable Javascript .TP +.B \-S +Enable 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. .TP .B \-x Prints xid to standard output. This can be used to script the browser by using +.TP +.B \-z zoomlevel +Specify the +.I zoomlevel +which surf should use. .BR xprop(1). .SH USAGE .B Escape @@ -51,16 +126,28 @@ Scrolls page upwards. .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\-\e Opens the search-bar. .TP .B Ctrl\-n @@ -82,16 +169,68 @@ Calls Printpage Dialog. 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. +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 +.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) .SH BUGS Please report them!