Enable the insert mode. Thanks to stanio@cs.tu-berlin.de!
[surf.git] / 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
83 Zooms page in.
84 .TP
85 .B Ctrl\-Shift\-j
86 Zooms page out
87 .TP
88 .B Ctrl\-Shift\-i
89 Resets Zoom
90 .TP
91 .B i
92 Enter insert mode. There all keybindings have effect with and without
93 pressing the modkey.
94 .TP
95 .B ESC
96 Leave the insert mode.
97 .TP
98 .B Ctrl\-h
99 Navigate back one step in history.
100 .TP
101 .B Ctrl\-l
102 Navigate forward one step in history.
103 .TP
104 .B Ctrl\-f and Ctrl\-\\
105 Opens the search-bar.
106 .TP
107 .B Ctrl\-n
108 Go to next search result.
109 .TP
110 .B Ctrl\-Shift\-n
111 Go to previous search result.
112 .TP
113 .B Ctrl\-g
114 Opens the URL-bar.
115 .TP
116 .B Ctrl\-p
117 Loads URI from primary selection.
118 .TP
119 .B Ctrl\-Shift\-p
120 Calls Printpage Dialog.
121 .TP
122 .B Ctrl\-r
123 Reloads the website.
124 .TP
125 .B Ctrl\-Shift\-r
126 Reloads the website without using cache.
127 .TP
128 .B Ctrl\-y
129 Copies current URI to primary selection.
130 .TP
131 .B Ctrl\-o
132 Show the sourcecode of the current page.
133 .TP
134 .B Ctrl\-v
135 Toggle the enabling of plugins on that surf instance.
136 .TP
137 .B Ctrl\-Shift\-i
138 Toggle auto-loading of images.
139 .TP
140 .B Ctrl\-c
141 Toggle caret browsing.
142 .TP
143 .B Ctrl\-Shift\-s
144 Toggle script execution.
145 .SH ENVIRONMENT
146 .TP
147 .B SURF_USERAGENT
148 If this variable is set upon startup, surf will use it as the useragent string
149 .TP
150 .B http_proxy
151 If this variable is set and not empty upon startup, surf will use it as the http proxy
152 .SH SEE ALSO
153 .BR dmenu(1),
154 .BR xprop(1),
155 .BR tabbed(1)
156 .SH BUGS
157 Please report them!