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 [-c\ cookiefile]
   7 .RB [-e\ xid]
   8 .RB [-i]
   9 .RB [-p]
  10 .RB [-r\ scriptfile]
  11 .RB [-s]
  12 .RB [-t\ stylefile]
  13 .RB [-u\ useragent]
  14 .RB [-v]
  15 .RB [-x]
  16 .RB "URI"
  17 .SH DESCRIPTION
  18 surf is a simple Web browser based on WebKit/GTK+. It is able
  19 to display websites and follow links. It supports the XEmbed protocol
  20 which makes it possible to embed it in another application. Furthermore,
  21 one can point surf to another URI by setting its XProperties.
  22 .SH OPTIONS
  23 .TP
  24 .B \-c cookiefile
  25 Specify the cookiefile to use.
  26 .TP
  27 .B \-e xid
  28 Reparents to window specified by xid.
  29 .TP
  30 .B \-i
  31 Disable Images
  32 .TP
  33 .B \-p
  34 Disable Plugins
  35 .TP
  36 .B \-r scriptfile
  37 Specify the user scriptfile.
  38 .TP
  39 .B \-s
  40 Disable Javascript
  41 .TP
  42 .B \-t stylefile
  43 Specify the user stylefile.
  44 .TP
  45 .B \-u useragent
  46 Specify the useragent which surf should use.
  47 .TP
  48 .B \-v
  49 Prints version information to standard output, then exits.
  50 .TP
  51 .B \-x
  52 Prints xid to standard output. This can be used to script the browser by using
  53 .BR xprop(1).
  54 .SH USAGE
  55 .B Escape
  56 Stops loading current page or stops download.
  57 .TP
  58 .B Ctrl\-h
  59 Walks back the history.
  60 .TP
  61 .B Ctrl\-l
  62 Walks forward the history.
  63 .TP
  64 .B Ctrl\-k
  65 Scrolls page upwards.
  66 .TP
  67 .B Ctrl\-j
  68 Scrolls page downwards.
  69 .TP
  70 .B Ctrl\-b
  71 Scroll up one whole page view.
  72 .TP
  73 .B Ctrl\-Space
  74 Scroll down one whole page view.
  75 .TP
  76 .B Ctrl\-i
  77 Scroll horizontally to the right.
  78 .TP
  79 .B Ctrl\-u
  80 Scroll horizontally to the left.
  81 .TP
  82 .B Ctrl\-Shift\-k or Ctrl\-+
  83 Zooms page in.
  84 .TP
  85 .B Ctrl\-Shift\-j or Ctrl\--
  86 Zooms page out
  87 .TP
  88 .B Ctrl\-Shift\-q
  89 Resets Zoom
  90 .TP
  91 .B Ctrl\-h
  92 Navigate back one step in history.
  93 .TP
  94 .B Ctrl\-l
  95 Navigate forward one step in history.
  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\-c
 131 Toggle caret browsing.
 132 .TP
 133 .B Ctrl\-Shift\-i
 134 Toggle auto-loading of images.
 135 .TP
 136 .B Ctrl\-Shift\-s
 137 Toggle script execution.
 138 .TP
 139 .B Ctrl\-Shift\-v
 140 Toggle the enabling of plugins on that surf instance.
 141 .TP
 142 .B F11
 143 Toggle fullscreen mode.
 144 .SH ENVIRONMENT
 145 .B SURF_USERAGENT
 146 If this variable is set upon startup, surf will use it as the useragent string
 147 .TP
 148 .B http_proxy
 149 If this variable is set and not empty upon startup, surf will use it as the http proxy
 150 .SH PLUGINS
 151 For using plugins in surf, first determine your running architecture. Then get
 152 the appropriate plugin for that architecture and copy it to
 153 .BR /usr/lib/browser-plugins
 154 or
 155 .BR /usr/lib64/browser-plugins.
 156 Surf should load them automatically.
 157 .BR
 158 If you want to use a 32bit plugin on a 64bit system,
 159 .BR nspluginwrapper(1)
 160 will help you.
 161 .SH SEE ALSO
 162 .BR dmenu(1),
 163 .BR xprop(1),
 164 .BR tabbed(1),
 165 .BR nspluginwrapper(1)
 166 .SH BUGS
 167 Please report them!