3 .\" Copyright (c) 2010 Marco Peereboom <marco@peereboom.us>
5 .\" Permission to use, copy, modify, and distribute this software for any
6 .\" purpose with or without fee is hereby granted, provided that the above
7 .\" copyright notice and this permission notice appear in all copies.
9 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
22 .Nd Lightweight web browser with vi key bindings
32 is a minimalistic web browser that tries to stay out of the way so that
33 valuable screen real estate can be used for much more important stuff.
34 It has sane defaults and does not require one to learn a language to do any
36 It was written by hackers for hackers and it strives to be small, compact and
41 starts up, it reads settings from its configuration file,
44 .Sx CONFIGURATION FILES
47 The following notation is used throughout this page:
49 .Bl -tag -width Ds -offset indent -compact
61 is very simple in its use.
62 Most of the actions are initiated via key or mouse bindings.
65 section below for defaults and customizations.
67 The options are as follows:
72 Disable visualization of tabs.
74 Display version and exit.
76 Use alternate config file.
82 .Sh CONFIGURATION FILES
84 tries to open the user specific file,
86 If that file is unavailable,
87 it then uses built-in defaults.
89 The format of the file is \*(Ltkeyword\*(Gt = \*(Ltsetting\*(Gt.
92 .Dl http_proxy = http://127.0.0.1:8080
94 Enabling or disabling an option is done by using 1 or 0 respectively.
96 The file supports the following keywords:
98 .Bl -tag -width "title_class_enabledXXX" -offset indent -compact
99 .It Cm ctrl_click_focus
100 Give focus in newly created tab instead of opening it in the background.
101 .It Cm read_only_cookies
102 Mark cookies file read-only and discard all cookies once the sessions is
104 .It Cm cookies_enabled
106 .It Cm enable_scripts
108 .It Cm enable_plugins
110 .It Cm default_font_size
111 Set the default browsing font size.
113 Proxy server in URI format.
115 Locations where files are downloaded to.
116 This directory must exist and
118 validates that during startup.
120 Enables a backward, forward and stop button to the toolbar.
121 Additionally if search_string is set it'll enable an entry box for searches.
123 Default search engine string.
124 See xxxterm.conf file for details.
128 overrides http_proxy if it is specified as an environment variable.
131 provides many functions (or actions) accessed via key or mouse bindings.
133 The current mouse bindings are described below:
135 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
137 Open new tab with the clicked link.
140 The default key bindings are described below:
142 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
162 Previous line on page
164 Previous line on page
192 Create new tab with focus in URI entry
199 Note: WebKit & GTK+ have many default key bindings that are not overruled and
200 therefore are available as-is.
202 Command mode is entered by typing a colon and exited by typing Esc.
203 The commands and descriptions are listed below:
205 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
209 .It Cm open, op, o <URI>
211 .It Cm tabnew, tabedit, tabe [URI]
212 Create new tab and optionally open provided URI
213 .It Cm tabclose, tabc
216 Close current tab and quit
218 if it is the last tab
219 .It Cm tabprevious, tabp
220 Go to the previous tab
226 .Bl -tag -width "/etc/xxxterm.confXXX" -compact
227 .It Pa ~/.xxxterm.conf
229 user specific settings.
236 was inspired by vimprobable2 and the bloat in other UNIX web browsers.
242 .An Marco Peereboom Aq marco@peereboom.us