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