surf.1

   1 .TH SURF 1 surf\-VERSION
   2 .SH NAME
   3 surf \- simple webkit-based browser
   4 .SH SYNOPSIS
   5 .B surf
   6 .RB [-bgiknpsvx]
   7 .RB [-c\ cookiefile]
   8 .RB [-e\ xid]
   9 .RB [-r\ scriptfile]
  10 .RB [-t\ stylefile]
  11 .RB [-u\ useragent]
  12 .RB "URI"
  13 .SH DESCRIPTION
  14 surf is a simple Web browser based on WebKit/GTK+. It is able
  15 to display websites and follow links. It supports the XEmbed protocol
  16 which makes it possible to embed it in another application. Furthermore,
  17 one can point surf to another URI by setting its XProperties.
  18 .SH OPTIONS
  19 .TP
  20 .B \-b
  21 Disable Scrollbars
  22 .TP
  23 .B \-c cookiefile
  24 Specify the
  25 .I cookiefile
  26 to use.
  27 .TP
  28 .B \-e xid
  29 Reparents to window specified by
  30 .I xid.
  31 .TP
  32 .B \-g
  33 Disable giving the geolocation to websites.
  34 .TP
  35 .B \-i
  36 Disable Images
  37 .TP
  38 .B \-k
  39 Enable kiosk mode (disable key strokes and right click)
  40 .TP
  41 .B \-n
  42 Disable the Web Inspector (Developer Tools).
  43 .TP
  44 .B \-p
  45 Disable Plugins
  46 .TP
  47 .B \-r scriptfile
  48 Specify the user
  49 .I scriptfile.
  50 .TP
  51 .B \-s
  52 Disable Javascript
  53 .TP
  54 .B \-t stylefile
  55 Specify the user
  56 .I stylefile.
  57 .TP
  58 .B \-u useragent
  59 Specify the
  60 .I useragent
  61 which surf should use.
  62 .TP
  63 .B \-v
  64 Prints version information to standard output, then exits.
  65 .TP
  66 .B \-x
  67 Prints xid to standard output. This can be used to script the browser by using
  68 .BR xprop(1).
  69 .SH USAGE
  70 .B Escape
  71 Stops loading current page or stops download.
  72 .TP
  73 .B Ctrl\-h
  74 Walks back the history.
  75 .TP
  76 .B Ctrl\-l
  77 Walks forward the history.
  78 .TP
  79 .B Ctrl\-k
  80 Scrolls page upwards.
  81 .TP
  82 .B Ctrl\-j
  83 Scrolls page downwards.
  84 .TP
  85 .B Ctrl\-b
  86 Scroll up one whole page view.
  87 .TP
  88 .B Ctrl\-Space
  89 Scroll down one whole page view.
  90 .TP
  91 .B Ctrl\-i
  92 Scroll horizontally to the right.
  93 .TP
  94 .B Ctrl\-u
  95 Scroll horizontally to the left.
  96 .TP
  97 .B Ctrl\-Shift\-k or Ctrl\-+
  98 Zooms page in.
  99 .TP
 100 .B Ctrl\-Shift\-j or Ctrl\--
 101 Zooms page out
 102 .TP
 103 .B Ctrl\-Shift\-q
 104 Resets Zoom
 105 .TP
 106 .B Ctrl\-f and Ctrl\-\\
 107 Opens the search-bar.
 108 .TP
 109 .B Ctrl\-n
 110 Go to next search result.
 111 .TP
 112 .B Ctrl\-Shift\-n
 113 Go to previous search result.
 114 .TP
 115 .B Ctrl\-g
 116 Opens the URL-bar.
 117 .TP
 118 .B Ctrl\-p
 119 Loads URI from primary selection.
 120 .TP
 121 .B Esc
 122 Stop loading the page.
 123 .TP
 124 .B Ctrl\-Shift\-p
 125 Calls Printpage Dialog.
 126 .TP
 127 .B Ctrl\-r
 128 Reloads the website.
 129 .TP
 130 .B Ctrl\-Shift\-r
 131 Reloads the website without using cache.
 132 .TP
 133 .B Ctrl\-y
 134 Copies current URI to primary selection.
 135 .TP
 136 .B Ctrl\-o
 137 Show the sourcecode of the current page.
 138 .TP
 139 .B Ctrl\-Shift\-b
 140 Toggle scrollbars
 141 .TP
 142 .B Ctrl\-Shift\-c
 143 Toggle caret browsing.
 144 .TP
 145 .B Ctrl\-Shift\-i
 146 Toggle auto-loading of images.
 147 .TP
 148 .B Ctrl\-Shift\-m
 149 Toggle if the
 150 .I stylefile
 151 file should be loaded.
 152 .TP
 153 .B Ctrl\-Shift\-o
 154 Open the Web Inspector (Developer Tools) window for the current page.
 155 .TP
 156 .B Ctrl\-Shift\-s
 157 Toggle script execution.
 158 .TP
 159 .B Ctrl\-Shift\-v
 160 Toggle the enabling of plugins on that surf instance.
 161 .TP
 162 .B F11
 163 Toggle fullscreen mode.
 164 .SH ENVIRONMENT
 165 .B SURF_USERAGENT
 166 If this variable is set upon startup, surf will use it as the
 167 .I useragent
 168 string
 169 .TP
 170 .B http_proxy
 171 If this variable is set and not empty upon startup, surf will use it as the http proxy
 172 .SH PLUGINS
 173 For using plugins in surf, first determine your running architecture. Then get
 174 the appropriate plugin for that architecture and copy it to
 175 .BR /usr/lib/browser-plugins
 176 or
 177 .BR /usr/lib64/browser-plugins.
 178 Surf should load them automatically.
 179 .BR
 180 If you want to use a 32bit plugin on a 64bit system,
 181 .BR nspluginwrapper(1)
 182 will help you.
 183 .SH SEE ALSO
 184 .BR dmenu(1),
 185 .BR xprop(1),
 186 .BR tabbed(1),
 187 .BR nspluginwrapper(1)
 188 .SH BUGS
 189 Please report them!