.Dd $Mdocdate: August 23 2012 $

.Os

.Nm xombrero

.Nd lightweight web browser

.Nm xombrero

.Bk -words

.Op Fl nSTtV

.Op Fl f Ar file

.Op Fl s Ar session_name

.Op Ar url ...

.Ek

.Nm

is a minimalistic web browser that tries to stay out of the way so that

valuable screen real estate can be used for much more important stuff.

It has sane defaults and does not require one to learn a language to do any

configuration.

It was written by hackers for hackers

and it strives to be small, compact, and fast.

.Pp

.Nm

is very simple in its use.

Most actions are initiated via key or mouse bindings.

Key bindings are based on those of the

.Xr vi 1

text editor,

giving web browsing a similar feel to navigating a text document.

The

.Sx KEY BINDINGS

section below documents the various defaults and possible customizations.

.Pp

The options are as follows:

.Bl -tag -width Ds

.It Fl f Ar file

Specify an alternative configuration file.

.It Fl n

Open a new tab in a running

.Nm

for each specified URL.

This option requires

.Cm enable_socket

to be enabled.

.It Fl e Ar command

Execute arbitrary command (see the

.Sx COMMAND MODE

section below) in a running

.Nm

instance. This option requires

.Cm enable_socket

to be enabled. Example run: xombrero -e "tabnew openbsd.org"; xombrero -e

tabclose; xombrero -e wq.

.It Fl S

Disable the toolbar.

.It Fl s Ar session_name

Open session that was saved with ":session save" command.

.It Fl T

Disable visualization of tabs.

.It Fl t

Disable tabs.

Pages that would open in tabs open in new windows instead.

.It Fl V

Display version and exit.

.El

The following notation is used throughout this page:

.Pp

.Bl -tag -width Ds -offset indent -compact

.It Cm C-

Control

.It Cm S-

Shift

.It Cm M1-

Meta 1 (sometimes marked Alt)

.It Cm M2-

Meta 2

.It Cm M3-

Meta 3

.It Cm M4-

Meta 4 (sometimes marked Windows)

.It Cm M5-

Meta 2

.It Cm MB1

Mouse button 1

.El

.Pp

To browse to a specific address,

either use the mouse to click on the address bar

or press

.Cm F6

to shift the keyboard focus to the address bar.

The address is then entered manually.

.Pp

The mouse can be used to navigate the page in the traditional manner,

or the keyboard can be used instead.

For example,

.Cm PageUp

and

.Cm PageDown

will scroll up and down the page.

.Pp

To follow a link,

either click on it or use the

.Cm f

key and have

.Nm

assign numbers to each link on the page;

entering that number on the keyboard will prompt

.Nm

to follow the link.

.Nm

provides many actions accessed via key or mouse bindings.

Most can be reprogrammed using a

.Cm keybinding

entry in the configuration file.

Each keyboard shortcut requires exactly one entry in the configuration file.

A shortcut can have multiple entries in the configuration file.

The format of the keybinding entry is as follows:

.Pp

.D1 keybinding = (:)action,(!)keystroke(s)

.Pp

For example, "keybinding = tabnew,C-t" where

.Cm tabnew

is the action and

.Cm C-t

are

the keystrokes.

.Pp

Actions may be any xombrero command that can be run from the command

prompt.

There is one additional action,

.Cm unbind ,

which will unbind any previous actions to that keybinding.

.Pp

If the action begins with a colon, the action will be entered into the

command prompt instead of being executed.

For example, "keybinding = :session open ,M1-s" will open the command

prompt with ":open session " entered when using the M1-s keybinding.

.Pp

Keybindings which open the command prompt may also include the string

<uri>, which will be replaced by the current tab's URI.

For example, "keybinding = :open <uri>,F10" will open the command

prompt with <uri> replaced with the current URI.

.Pp

GTK has some default keybindings for manipulating text inside input

fields, such as the URI or search entry widget, for example

.Cm C-w

deletes a word. To override these defaults prefix your key with an

exclamation mark (!), like this: "keybinding = tabclose,!C-w".

The

.Cm clearall

key word is special and is meant to reset the key binding list to the GTK+

and WebKit defaults.

This keyword should be the first

.Cm keybinding

entry in the configuration file.

.Pp

Shift should be used sparingly since it gets in the way of non-USA keyboards.

See the accompanying configuration file for examples.

.Pp

The various bindings are documented below.

The relevant keybinding action is given afterwards, in parentheses.

.Ss Command mode

These commands are used to focus or unfocus input on the default input of a web

page.

.Pp

.Bl -tag -width Ds -offset indent -compact

.It Cm ESC

Go to command mode; unfocus current entry on web page.

.Pq Cm command_mode

.It Cm i

Go to insert mode; focus on default entry on web page.

.Pq Cm insert_mode

.El

.Ss Search Commands

These commands are used to search for text strings within a web page.

.Pp

.Bl -tag -width Ds -offset indent -compact

.It Cm /

Start a search

.Pq Cm search

.It Cm \&?

Start a backwards search

.Pq Cm searchb

.It Cm n

Next item matching search

.Pq Cm searchnext

.It Cm N

Previous item matching search

.Pq Cm searchprev

.El

.Ss Focus Commands

These commands are used to shift the focus of

.Nm

from one area to another.

.Pp

.Bl -tag -width Ds -offset indent -compact

.It Cm F6

Focus on address bar

.Pq Cm focusaddress

.It Cm F7

Focus on search entry

.Pq Cm focussearch

.El

.Ss Command Aliases

These commands allow the user to map specific actions to specific keys.

.Pp

.Bl -tag -width Ds -offset indent -compact

.It Cm F1

Alias for "help"

.It Cm F2

Alias for "proxy toggle"

.It Cm F4

Alias for "toplevel toggle"

.El

.Ss Prompt Aliases

These commands allow the user to open a prompt.

These can be useful when the

.Fl S

option is used.

.Pp

.Bl -tag -width Ds -offset indent -compact

.It Cm F9

Alias for ":open "

.It Cm F10

Alias for ":open <uri>"

.It Cm F11

Alias for ":tabnew "

.It Cm F12

Alias for ":tabnew <uri>"

.El

.Ss Navigation Commands

These commands allow the user to navigate web pages and,

to some extent,

control the browser.

.Pp

.Bl -tag -width "Space, C-f, PageDownXXX" -offset indent -compact

.It Cm F5, C-r, C-l

Reload page

.Pq Cm reload

.It Cm Backspace, M-Left

Previous page

.Pq Cm goback

.It Cm S-BackSpace, M-Right

Forward page

.Pq Cm goforward

.It Cm j, Down

Next line on page

.Pq Cm scrolldown

.It Cm k, Up

Previous line on page

.Pq Cm scrollup

.It Cm G, End

Bottom of page

.Pq Cm scrollbottom

.It Cm gg, Home

Top of page

.Pq Cm scrolltop

.It Cm Space, C-f, PageDown

Page down

.Pq Cm scrollpagedown

.It Cm C-b, PageUp

Page up

.Pq Cm scrollpageup

.It Cm l, Right

Page right

.Pq Cm scrollright

.It Cm h, Left

Page left

.Pq Cm scrollleft

.It Cm $

Page far right

.Pq Cm scrollfarright

.It Cm 0

Page far left

.Pq Cm scrollfarleft

.It Cm M-f

Favorites

.Pq Cm fav

.It Cm M-j

Cookie jar

.Pq Cm cookiejar

.It Cm M-d

Download manager

.Pq Cm dl

.It Cm C-p

Print page

.Pq Cm print

.It Cm M-h

Global history

.Pq Cm history

.It Cm C-j

Toggle Java Script enabled for FQDN

.Pq Cm js

.It Cm C-s

Toggle source view

.Pq Cm togglesrc

.It Cm M-c

Toggle cookie enabled for FQDN

.Pq Cm cookie

.It Cm M-p

Toggle plugins enabled for FQDN

.Pq Cm plugin

.El

.Ss Tab Manipulation

.Nm

supports tabbed browsing.

That is, web pages may be opened in separate tabs,

allowing the user to quickly move from one page to another,

and back.

These commands then are used to create, destroy, and move between tabs.

.Pp

.Bl -tag -width "C-plus, C-equalXXX" -offset indent -compact

.It Cm C-MB1

Open new tab with the clicked link

.It Cm C-t

Create new tab with focus in URL entry

.Pq Cm tabnew

.It Cm C-T

Create new tab with focus in URL entry as the last tab in the browser

.Pq Cm 999tabnew

.It Cm C-w

Destroy current tab

.Pq Cm tabclose

.It Cm U

Undo close tab

.Pq Cm tabundoclose

.It Cm C-Left, C-PageUp

Go to the previous tab

.Pq Cm tabprevious

.It Cm C-Right, C-PageDown

Go to the next tab

.Pq Cm tabnext

.It Cm C-[1..9]

Jump to page

.Ar N

.Pq Cm tabnext [1..9]

.It Cm C-<

Jump to first page

.Pq Cm tabfirst

.It Cm C->

Jump to last page

.Pq Cm tablast

.It Cm C-minus

Zoom out by 4%

.Pq Cm focusout

.It Cm C-plus, C-equal

Zoom in by 4%

.Pq Cm focusin

.It Cm C-0

Set zoom level to 100%

.Pq Cm focusreset

.El

.Ss Yanking and pasting

These commands copy and paste text to and from the clipboard.

.Pp

.Bl -tag -width Ds -offset indent -compact

.It Cm p

Paste the contents of the clipboard into the address bar

.Pq Cm pasteuricur

.It Cm P

Paste the contents of the clipboard into a new tab

.Pq Cm pasteurinew

.It Cm y

Yank the current URL into the clipboard

.Pq Cm yankuri

.El

.Ss Hyperlink Following

This allows the user to follow hyperlinks

without using a mouse.

Enter the corresponding number to follow the link.

Alternatively one can type the name of the link and when there are no more

possibilities

.Nm

will follow the link.

.Pp

.Bl -tag -width Ds -offset indent -compact

.It Cm f, '.'

Highlight all links and prefix them with a number.

.Pq Cm hinting

.It Cm F, ','

Highlight all links and prefix them with a number but open in a new tab.

.Pq Cm hinting_newtab

.El

.Ss Exiting

Commands to exit the browser.

.Pp

.Bl -tag -width Ds -offset indent -compact

.It Cm C-q

Quit

.Pq Cm quitall

.El

.Ss Low-Contrast Color Scheme

These commands toggle the page style between the default CSS and a

low-contrast color scheme with light grey text on a dark grey background.

If the

.Cm userstyle

setting is changed, that stylesheet will be used instead of the

low-contrast color scheme.

.Pp

.Bl -tag -width Ds -offset indent -compact

.It Cm s

Toggle the current tab's style.

.Pq Cm userstyle

.It Cm S

Toggle the global page style mode.

Will also affect new tabs.

.Pq Cm userstyle_global

.El

.Ss Insert-mode commands

The following commands are only available when editing an input-field

.Pp

.Bl -tag -width Ds -offset indent -compact

.It Cm C-i

Edit the contents of the currently active input-element in an external editor.

.Pq Cm editelement

.El

Command mode works in a similar fashion to the

.Xr vi 1

editor;

it is entered by typing a colon and exited by typing Esc.

The commands and their descriptions are listed below.

.Bl -tag -width Ds -offset indent

.It Cm about , version

Show the "About" page.

.It Cm buffers , ls , tabs

Displays the currently open tabs and lets the user switch tab by typing

the tab number or using the mouse.

.It Cm ca

Display CA certificates.

.It Cm cert , cert show

Download and display certificates of domain on tab.

.It Cm cert save

Save certificate into a local store.

The next time the site is visited it is compared against the store.

If the certificate matches,

the address bar will be blue;

if it doesn't the bar will be red.

.It Cm cookie

The

.Cm cookie

command is used to manipulate the cookie whitelist.

Used by itself it expands to

.Cm cookie show all .

.It Cm cookiejar

Show cookie jar contents.

.It Cm cookie purge

Remove all cookies from the cookie jar.

.It Cm cookie save, cookie save fqdn

Save the current fully qualified domain name (FQDN)

to the persistent whitelist.

For example,

the www.peereboom.us domain would result in saving www.peereboom.us.

.It Cm cookie save domain

Save the top level domain name to the persistent whitelist.

For example,

the www.peereboom.us domain would result in saving .peereboom.us.

.Pp

This action enables cookies if it is currently disabled for this entry.

.It Cm cookie show all

Show all persistent and session entries in the cookie whitelist.

.It Cm cookie show persistent

Show all persistent entries in the cookie whitelist.

.It Cm cookie show session

Show all session entries in the cookie whitelist.

.It Cm cookie toggle domain

Toggle cookie support for the current top level domain.

.It Cm cookie toggle, cookie toggle fqdn

Toggle cookie support for the current FQDN.

.It Cm dl

Show download manager.

.It Cm encoding <encoding>

If

.Cm <encoding>

is set the tab's encoding will be set to

.Cm <encoding>

and

.Nm

reloads the tab.

If

.Cm <encoding>

is not set

.Nm

will display the current tab encoding.

.It Cm editsrc

Opens the source for the current tab in the editor specified by the

setting

.Cm external_editor

and then checks for changes to the file opened. If it is changed, the

page will be updated.

.It Cm editelement

If a text-element is currently active (<input> or <textarea>), it's

contents will be opened in the same fashion as for the command

.Cm editsrc

above

.It Cm fav

Show favorites.

.It Cm favadd

Add the current page to favorites.

.It Cm favedit

Shows favorites list and links to remove entries.

.It Cm fullscreen , f

Toggle hiding tabs and url entry toolbar.

.It Cm h , hist , history

Show global history.

.It Cm help

Show help page.

.It Cm home

Go to home URL.

.It Cm https

The

.Cm https

command is used to manitulate the items in the HTTPS force list.

Used by itself it expands to

.Cm https show all .

.It Cm https save, save fqdn

Saves the FQDN to the persistent force HTTPS list.

For example,

the www.peereboom.us domain would result in saving www.peereboom.us.

.It Cm https save domain

Saves the top level domain name to the persistent whitelist.

For example,

the www.peereboom.us domain would result in saving .peereboom.us.

.It Cm https show all

Show all persistent ans session entries in the HTTPS force list.

.It Cm https show persistent

Shows all persistent entries in the HTTPS force list.

.It Cm https show session

Shows all session entries in the HTTPS force list.

.It Cm https toggle, https toggle fqdn

Toggle this FQDN in the HTTPS force list.

.It Cm https toggle domain

Toggle the top level domain in the HTTPS force list.

.It Cm js

The

.Cm js

command is used to manipulate the Java Script whitelist.

Used by itself it expands to

.Cm js show all .

.It Cm js save, save fqdn

Saves the FQDN to the persistent whitelist.

For example,

the www.peereboom.us domain would result in saving www.peereboom.us.

.It Cm js save domain

Saves the top level domain name to the persistent whitelist.

For example,

the www.peereboom.us domain would result in saving .peereboom.us.

.Pp

This action enables Java Script if it is currently disabled for this entry.

.It Cm js show all

Shows all persistent and session entries in the JS whitelist.

.It Cm js show persistent

Shows all persistent entries in the JS whitelist.

.It Cm js show session

Shows all session entries in the JS whitelist.

.It Cm js toggle, js toggle fqdn

Toggle Java Script execution for the current FQDN.

.It Cm js toggle domain

Toggle Java Script execution for the current top level domain.

.It Cm loadimages

If auto_load_images is disabled, load all images for current site.

.It Cm open , op , o URL

Open URL.

.It Cm plugin

The

.Cm plugin

command is used to manipulate the plugin whitelist.

Used by itself it expands to

.Cm plugin show all .

.It Cm plugin save, save fqdn

Saves the FQDN to the persistent whitelist.

For example,

the www.peereboom.us domain would result in saving www.peereboom.us.

.It Cm plugin save domain

Saves the top level domain name to the persistent whitelist.

For example,

the www.peereboom.us domain would result in saving .peereboom.us.

.Pp

This action enables plugins if they are currently disabled for this entry.

.It Cm plugin show all

Shows all persistent and session entries in the plugin whitelist.

.It Cm plugin show persistent

Shows all persistent entries in the plugin whitelist.

.It Cm plugin show session

Shows all session entries in the plugin whitelist.

.It Cm plugin toggle, plugin toggle fqdn

Toggle plugin execution for the current FQDN.

.It Cm plugin toggle domain

Toggle plugin execution for the current top level domain.

.It Cm print

Print page.

.It Cm proxy

The

.Cm proxy

command is used to manipulate the currently set proxy.

Used by itself it expands to

.Cm proxy show .

.It Cm proxy show

Displays the current

.Cm http_proxy

setting.

.It Cm proxy toggle

Enables or disables the proxy for

.Nm .

Note that

.Cm http_proxy

must be set before it can be toggled.

.It Cm qa , qall , quitall

Quit

.Nm .

.It Cm quit , q

Close current tab and quit

.Nm

if it is the last tab.

.It Cm restart

Restart

.Nm

and reload all current tabs.

.It Cm run_script [path_to_script]

Runs the script path_to_script with the current uri as the argument.

If path_to_script is not provided, the value of default_script is used

instead.

.It Cm script [filename]

Run an external JavaScript script file in the current tab context.

.It Cm session , Cm session show

Display the current session name.

By default the session name is main_session.

To create a new session use the

.Cm session save

command.

A session is defined as the lifetime of the browser application.

.It Cm session delete <session_name>

Delete session session_name from persistent storage.

If session_name is the current session then the session will revert to

main_session.

.It Cm session open <session_name>

Open session_name and close all currently open tabs.

Going forward this session is named session_name.

.It Cm session save <session_name>

Save current tabs to session_name session.

This will close the current session and going forward this session is named

session_name.

.It Cm set

The set command is used to inspect, clear or change runtime options.

There are 3 methods to use

.Cm :set .

When used by itself as

.Cm :set

the command displays all options as currently set.

.Pp

To set a value use

.Cm :set option=value .

For example,

.Cm :set http_proxy=http://127.0.0.1:8080 .

.Pp

To clear a value use

.Cm :set option= .

For example,

.Cm :set http_proxy= .

.Pp

Note, not all options can be set at runtime.

.It Cm stats

Show blocked cookie statistics.

These statistics vary based on settings and are not persistent.

.It Cm statustoggle , statust

Toggle status bar.

.It Cm stop

Stop loading the current web page.

.It Cm tabclose

Close current tab.

.It Cm tabhide

Hide tabs.

.It Cm tabnew , tabedit [URL]

Create new tab and optionally open provided URL.

.It Cm tabnext

Go to the next tab.

.It Cm tabonly

Close all tabs except the currently focused one.

.It Cm tabprevious

Go to the previous tab.

.It Cm tabshow

Show tabs in GUI.

.It Cm toplevel , toplevel toggle

Toggle the top level domain name cookie and JS session whitelist.

This is to enable/disable short lived full site functionality without

permanently adding the top level domain to the persistent whitelist.

.It Cm urlhide , urlh

Hide url entry and tool bar.

.It Cm urlshow , urls

Show url entry and tool bar.

.It Cm userstyle <stylesheet>

Toggle the current tab between using a custom stylesheet and the

page's default CSS.

If there is no stylesheet argument to this command, the stylesheet

specified by the

.Cm userstyle

setting will be used instead.

This

.Cm userstyle

setting is set by default to a low-contrast color scheme.

If a stylesheet is specified, the current tab will be toggled with

this stylesheet instead.

.Pp

If the

.Cm userstyle

setting is left unchanged, this command without any arguments will

toggle between the default page's CSS and the low-contrast color

scheme.

.Pp

Additional stylesheets may be used in addition to the low-contrast

color scheme by specifying additonal keybindings. For example,

.Pp

.D1 keybinding = userstyle ~/style.css,v

.D1 keybinding = userstyle_global ~/style.css,V

.Pp

will map toggling between ~/style.css to the v and V keys while

keeping the low-contrast feature mapped to the s and S keys.

.It Cm userstyle_global <stylesheet>

Same as

.Cm userstyle

but the change affects all open tabs, and newly created tabs will use

this style.

.It Cm w

Save open tabs to current session.

The tabs will be restored next time the session is opened.

See the session command for additional details.

.It Cm wq

Save open tabs and quit.

The tabs will be restored next time

.Nm

the session is opened.

See the session command for additional details.

.El

In addition to shortcuts and commands

.Nm

provides buffer commands. Buffer commands are short, multi character

vi-like commands, often requiring an argument. Partial buffer commands

are

displayed in the buffer command statusbar element (see

.Cm statusbar_elems ) .

Pressing Esc or switching to another tab cancels a partially entered

buffer command. In the following list

.Cm arg

denotes the argument a buffer command accepts. Buffer commands are

defined as extended regular experssions.

Note that if a character is used as a shortcut it will not be interpreted

as the beginning of a buffer command. This is the case with

.Cm 0 .

.Pp

.Bl -tag -width "['][a-zA-Z0-9]XXX" -offset indent -compact

.It Cm gg

go to the top of the page

.It Cm gG

go to the bottom of the page

.It Cm [0-9]+%

go to the

.Cm arg

percent of the page

.It Cm zz

go to 50% of the page

.It Cm [0-9]*gu

go

.Cm arg

levels up. If

.Cm arg

is missing, 1 is assumed. Going a

level up means going to a URI obtained from the current one by removing

the last slash ('/') character and everything that follows it

.It Cm gU

go to the root level, i.e. going up as many levels as possible.

.It Cm gh

open the home page in the current tab

.It Cm m[a-zA-Z0-9]

set a mark denoted by

.Cm arg

at the current page position. These marks behave like those in vi or

less.

.It Cm ['][a-zA-Z0-9']

go to the position where mark

.Cm arg

was set. The special mark "'" points to the previous page position, after a

"gg", "gG", "zz", "%" or "'" buffer command.

.It Cm M[a-zA-Z0-9]

set the current uri as quickmark

.Cm arg

.It Cm go[a-zA-Z0-9]

open the uri marked as quickmark

.Cm arg

in the current tab

.It Cm gn[a-zA-Z0-9]

open the uri marked as quickmark

.Cm arg

in a new tab

.It Cm [0-9]+t

activate tab number

.It Cm g0

go to first tab

.It Cm g$

go to last tab

.It Cm [0-9]*gt

go to the

.Cm arg

next tab

.It Cm [0-9]*gT

go to the

.Cm arg

previous tab

.Cm arg

.It Cm ZZ

quit

.Nm

.It Cm ZR

restart

.Nm

.It Cm zi

zoom in by 4%

.It Cm zo

zoom out by 4%

.It Cm z0

set zoom level to 100%

.It Cm [0-9]+Z

set zoom level to

.Cm arg

%

.El

Quickmarks are like bookmarks, except they are refered to by a single

character (a letter or a digit), instead of a longer name. See the

.Cm M[a-zA-Z0-9] ,

.Cm go[a-zA-Z0-9]

and

.Cm gn[a-zA-Z0-9]

buffer commands for usage. Quickmarks are stored in

.Pa ~/.xombrero/quickmarks

and are saved automatically after each

.Cm M[a-zA-Z0-9]

buffer command.

The about screens are internally generated web pages by

.Nm

for user interaction.

These are entered in the address bar and the format is

.Cm about:screen

where screen is the desired screen to display.

For example about:favorites.

Any about screen can be used as the home page as specified by

.Cm home

in the configuration file.

.Pp

.Bl -tag -width "downloadsXXX" -offset indent -compact

.It Cm about

show the about screen

.It Cm blank

show a blank screen

.It Cm cookiewl

show the cookie whitelist screen

.It Cm cookiejar

show the cookiejar screen

.It Cm downloads

show the downloads screen

.It Cm favorites

show the favorites screen

.It Cm help

show the help web page

.It Cm history

show the history screen

.It Cm jswl

show the Java Script whitelist screen

.It Cm set

show the settings screen

.It Cm stats

show the statistics screen

.El

This section describes advanced usage settings.

Most users should use

.Cm browser_mode

instead to setup

.Nm

and skip over this section.

.Pp

.Nm

has a number of whitelists to control blocking cookies and Java Script

execution for FQDNs or domains.

When properly enabled these whitelists require either the FQDN or top level

domain to exist in the whitelists in order to allow cookies to be stored or

Java Script to execute.

Both Java Script and cookies have two whitelists associated with them.

The whitelists are called session and persistent.

Items in the session whitelists are only allowed for the lifetime of the

.Nm

instance.

Items in the persistent whitelists are stored on disk and are restored

upon restarting.

.Pp

Setting up the whitelists is a little tricky due to intricacies of WebKit.

In fact the semantics are different for cookies and Java Script.

.Pp

Cookie whitelist requires the following configuration to be set:

.Pp

.Bl -tag -width "enable_cookie_whitelistXXX" -offset indent -compact

.It Cm cookies_enabled

This is a WebKit setting and must be set to

.Pa 1

(ENABLED)

in order to be able to use a

cookie whitelist.

.It Cm enable_cookie_whitelist

This needs to be set to

.Pa 1

to enable the cookie whitelist functionality.

.It Cm cookie_wl

These entries in the configuration file are the actual domains names in the

cookie whitelist.

.El

.Pp

Java Script whitelist requires the following configuration to be set:

.Pp

.Bl -tag -width "enable_js_whitelistXXX" -offset indent -compact

.It Cm enable_scripts

This is a WebKit setting and must be set to

.Pa 0

(DISABLED)

in order to be able to use a

Java Script whitelist.

.It Cm enable_js_whitelist

This needs to be set to

.Pa 1

to enable the Java Script whitelist functionality.

.It Cm js_wl

These entries in the configuration file are the actual domains names in the

Java Script whitelist.

.El

.Pp

Plugin whitelist requires the following configuration to be set:

.Pp

.Bl -tag -width "enable_plugin_whitelistXXX" -offset indent -compact

.It Cm enable_plugins

This is a WebKit setting and must be set to

.Pa 1

(ENABLED)

in order to be able to use a

plugin whitelist.

.It Cm enable_plugin_whitelist

This needs to be set to

.Pa 1

to enable the plugin whitelist functionality.

.It Cm pl_wl

These entries in the configuration file are the actual domains names in the

plugin whitelist.

.El

.Pp

See the

.Pa FILES

section for additional configuration file entries and details

that alter runtime behavior.

.Bl -tag -width "/etc/xombrero.confXXX" -compact

.It Pa ~/.xombrero.conf

.Nm

user specific settings.

.It Pa ~/.xombrero

.Nm

scratch directory.

.El

.Pp

.Nm

tries to open the user specific file,

.Pa ~/.xombrero.conf .

If that file is unavailable,

it then uses built-in defaults.

Any settings saved at runtime will be saved to the file

.Pa ~/.xombrero/runtime

and will be loaded as well.

.Pp

The format of the file is \*(Ltkeyword\*(Gt = \*(Ltsetting\*(Gt.

For example:

.Pp

.Dl http_proxy = http://127.0.0.1:8080