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