Use m4 for generating keys and settings; move util to m4; move util/src to src/util; mv api to doc/api; adding bash-completion

--HG--
rename : api/Makefile => doc/api/Makefile
rename : api/jsapi.7.txt => doc/api/jsapi.7.txt
rename : api/jsapi.txt => doc/api/jsapi.txt
rename : util/Makefile => m4/Makefile

4 files changed, 0 insertions, 10462 deletions

diff --git a/api/Makefile b/api/Makefile
deleted file mode 100644
index 1073edde..00000000
--- a/api/Makefile
+++ /dev/null
@@ -1,18 +0,0 @@
-# See COPYING for copyright and license details
-
-all: web man webman
-
-web: jsapi.html
-
-man: dwb-js.7
-
-webman: jsapi.7.html
-
-jsapi.html: jsapi.txt
-	asciidoc -b html5 -a toc2 $<
-
-jsapi.7.html: jsapi.7.txt
-	asciidoc -b html5 -a toc2 $<
-
-dwb-js.7: jsapi.7.txt
-	a2x -v --doctype manpage --format manpage $<
diff --git a/api/dwb-js.7 b/api/dwb-js.7
deleted file mode 100644
index 16a6ef3b..00000000
--- a/api/dwb-js.7
+++ /dev/null
@@ -1,4343 +0,0 @@
-'\" t
-.\"     Title: dwb-js
-.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
-.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/>
-.\"      Date: 02/26/2013
-.\"    Manual: \ \&
-.\"    Source: \ \&
-.\"  Language: English
-.\"
-.TH "DWB\-JS" "7" "02/26/2013" "\ \&" "\ \&"
-.\" -----------------------------------------------------------------
-.\" * Define some portability stuff
-.\" -----------------------------------------------------------------
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" http://bugs.debian.org/507673
-.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.ie \n(.g .ds Aq \(aq
-.el       .ds Aq '
-.\" -----------------------------------------------------------------
-.\" * set default formatting
-.\" -----------------------------------------------------------------
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.\" -----------------------------------------------------------------
-.\" * MAIN CONTENT STARTS HERE *
-.\" -----------------------------------------------------------------
-.SH "NAME"
-dwb-js \- dwb\*(Aqs javascript api documentation
-.SH "DESCRIPTION"
-.sp
-dwb provides a javascript api that can be used to write userscripts or extensions for dwb\&.
-.SH "GETTING STARTED"
-.sp
-Scripts that use the javascript api must be located in \fB$XDG_CONFIG_HOME/dwb/userscripts\fR like any other script\&. Scripts that use the javascript api must either start with
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-#!javascript
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-or with
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-//!javascript
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-All native javascript methods can be used in scripts, however there are limitations:
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-The execution context of userscripts is completely seperated from the web execution context\&. Due to security concerns it is not possible to communicate with the web execution context, it is only possible to inject scripts into the web context\&.
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-In contrast to the global window object in the web execution context, the global object is a readonly object, i\&.e\&. it is not possible to set properties on the global object, see also
-\fBGlobal data\fR
-for details\&.
-.RE
-.SH "GLOBAL"
-.SS "Properties"
-.PP
-\fIglobal (Object, read)\fR
-.RS 4
-Refers to the global object
-.RE
-.PP
-\fIsession (SoupSession, read)\fR
-.RS 4
-The webkit session
-.RE
-.SS "Methods"
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBBoolean bind(String shortcut, Function callback, [String name])\fR
-.RS 4
-.sp
-Bind a javascript function to a shortcut\&. This is the preferred method of binding keys to shortcuts since the shortcut is evaluated using the native method, but also the keyPress\-signal can be used to bind shortcuts\&.
-.PP
-\fIshortcut\fR
-.RS 4
-A shortcut shortcut, will be parsed the same way as if set in dwb:keys
-.RE
-.PP
-\fIcallback\fR
-.RS 4
-Callback function that will be called when the shortcut is pressed
-.RE
-.PP
-\fIname\fR
-.RS 4
-A name that identifies the function on command line, optional
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-true if the function was bound successfully
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBBoolean execute(String command)\fR
-.RS 4
-.sp
-Executes a dwb command
-.PP
-\fIcommand\fR
-.RS 4
-a dwb command to execute, will be parsed the same way as if executed from commandline
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-true if execution was successful
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBBoolean exit()\fR
-.RS 4
-.sp
-Exit dwb, must be called if the script is running from commandline\&.
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBObject include(String path, [Boolean global])\fR
-.RS 4
-.sp
-Includes a file\&. Note that there is only one context, all scripts are executed in this context\&. Included files are not visible in other scripts unless true is passed as second parameter\&.
-.PP
-\fIpath\fR
-.RS 4
-Path to a file to include
-.RE
-.PP
-\fIglobal\fR
-.RS 4
-Whether to include the script into the global scope, optional
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-The return value of the included file
-.RE
-.if n \{\
-.sp
-.\}
-.RS 4
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBNote\fR
-.ps -1
-.br
-.sp
-Scripts included with include are either visible in the global scope or invisible, even in the including script\&. To use an included script it can return an object with its public objects:
-.sp .5v
-.RE
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-// included script
-
-var private = 37;
-return {
-  getPrivate : function () {
-    return private;
-  }
-};
-
-// Scripts that includes the above
-var i = include("/path/to/script");
-var p = i\&.getPrivate();               // 37
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-or define a module that can be shared:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-// included script
-
-var private = 37;
-provide("foo", {
-    getPrivate : function() {
-        return private;
-    }
-});
-
-// Scripts that includes the above
-var i = include("/path/to/script");
-require(["foo"], function(foo) {
-    var bar = foo\&.getPrivate();               // 37
-})
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid provide(String name, Object module)\fR
-.RS 4
-.sp
-Defines a module that can be used in other scripts, see MODULES for details\&.
-.PP
-\fIname\fR
-.RS 4
-Name of the module
-.RE
-.PP
-\fImodule\fR
-.RS 4
-The module
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid replace(String name, Object module)\fR
-.RS 4
-.sp
-Same as provide but replaces the module if it was already defined\&.
-.PP
-\fIname\fR
-.RS 4
-Name of the module
-.RE
-.PP
-\fImodule\fR
-.RS 4
-The module, if omitted the module will be deleted, all references to that module will reference an empty object afterwards, optional\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid require(Array names, Function callback)\fR
-.RS 4
-.sp
-Load modules defined with provide\&.
-.PP
-\fInames\fR
-.RS 4
-An array of module names or null to get all modules, a module name can also contain a path, the path must be seperated with a
-\fB!\fR
-from the module name, see also MODULES for details\&.
-.RE
-.PP
-\fIcallback\fR
-.RS 4
-A callback function that is called after initialization of all scripts and modules\&. The parameters of the callback function correspond to the names array\&. If
-\fBnames\fR
-is null the function is called with one parameter that contains all modules, see also MODULES for examples\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid sendRequest(String uri, Function callback, [String method])\fR
-.RS 4
-.sp
-Sends a http\-request\&.
-.PP
-\fIuri\fR
-.RS 4
-The uri the request will be sent to\&.
-.RE
-.PP
-\fIcallback\fR
-.RS 4
-A callback that will be called when the request is finished, the callback has 2 parameters, the first will be an object that contains body and headers, the second the associated SoupMessage\&.
-.RE
-.PP
-\fImethod\fR
-.RS 4
-The http request method, default GET, optional\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBObject sendRequestSync(String uri, [String method])\fR
-.RS 4
-.sp
-Sends a http\-request synchronously\&.
-.PP
-\fIuri\fR
-.RS 4
-The uri the request will be sent to\&.
-.RE
-.PP
-\fImethod\fR
-.RS 4
-The http request method, default GET, optional\&.
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-Object that contains the response body, the response headers and the http status code of the request\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid tabComplete(String label, Array items, Function callback, [Boolean readonly])\fR
-.RS 4
-.sp
-Initiates tab completion\&.
-.PP
-\fIlabel\fR
-.RS 4
-The command line label
-.RE
-.PP
-\fIitems\fR
-.RS 4
-An array of objects, each object can have 2 properties, left which will be the left completion label and right which will be the right completion label\&.
-.RE
-.PP
-\fIcallback\fR
-.RS 4
-Callback function, the first argument will be the returned string from the url bar\&.
-.RE
-.PP
-\fIreadonly\fR
-.RS 4
-Whether the items are readonly, default false, optional\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBNumber timerStart(Number interval, Function func)\fR
-.RS 4
-.sp
-Executes a function repeatedly until the function returns false or timerStop is called on the id returned from this function
-.PP
-\fIinterval\fR
-.RS 4
-Interval in milliseconds
-.RE
-.PP
-\fIfunc\fR
-.RS 4
-Function to execute
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-An id that can be passed to timerStop
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBNumber timerStop(Number id)\fR
-.RS 4
-.sp
-Stops a timer started by timerStart
-.PP
-\fIid\fR
-.RS 4
-The id returned from timerStart
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-true if the timer was stopped
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBNumber unbind(Function func|String name)\fR
-.RS 4
-.sp
-Unbind a shortcut that was previously bound with bind
-.PP
-\fIfunc\fR or \fIname\fR
-.RS 4
-Either the function or the optional name passed to bind\&.
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-true if the function was unbound
-.RE
-.RE
-.SH "GLOBAL OBJECTS"
-.SS "data"
-.sp
-The data object can be used to determine internally used data securely\&. All properties are readonly Strings\&.
-.PP
-\fIdata\&.bookmarks\fR
-.RS 4
-Bookmark file
-.RE
-.PP
-\fIdata\&.cacheDir\fR
-.RS 4
-Cache directory
-.RE
-.PP
-\fIdata\&.configDir\fR
-.RS 4
-Config directory
-.RE
-.PP
-\fIdata\&.cookies\fR
-.RS 4
-Cookie file
-.RE
-.PP
-\fIdata\&.cookiesWhitelist\fR
-.RS 4
-Whitelist for persistent cookies
-.RE
-.PP
-\fIdata\&.customKeys\fR
-.RS 4
-Custom keyboard shortcuts
-.RE
-.PP
-\fIdata\&.history\fR
-.RS 4
-History file
-.RE
-.PP
-\fIdata\&.keys\fR
-.RS 4
-Shortcuts configuration file
-.RE
-.PP
-\fIdata\&.pluginsWhitelist\fR
-.RS 4
-Whitelist for the plugin blocker
-.RE
-.PP
-\fIdata\&.profile\fR
-.RS 4
-Profile which will be
-\fBdefault\fR
-unless another profile is specified on command line
-.RE
-.PP
-\fIdata\&.quickmarks\fR
-.RS 4
-Quickmark file
-.RE
-.PP
-\fIdata\&.scriptWhitelist\fR
-.RS 4
-Whitelist for scripts
-.RE
-.PP
-\fIdata\&.session\fR
-.RS 4
-File with stored sessions for this profile
-.RE
-.PP
-\fIdata\&.sessionCookiesWhitelist\fR
-.RS 4
-Whitelist for session cookies
-.RE
-.PP
-\fIdata\&.settings\fR
-.RS 4
-Settings configuration file
-.RE
-.PP
-\fIdata\&.searchEngines\fR
-.RS 4
-Searchengines
-.RE
-.SS "io"
-.sp
-The io object implements methods for input and output\&.
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid io.debug([Object detail])\fR
-.RS 4
-.sp
-Prints a debug message and the call stack to stderr\&.
-.PP
-\fIdetail\fR
-.RS 4
-Message details, optional
-.RE
-.PP
-\fIdetail\&.message\fR
-.RS 4
-The message to show, optional
-.RE
-.PP
-\fIdetail\&.error\fR
-.RS 4
-An Error object, optional
-.RE
-.PP
-\fIdetail\&.arguments\fR
-.RS 4
-Arguments, optional
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBArray io.dirNames(String path)\fR
-.RS 4
-.sp
-Get directory entries\&.
-.PP
-\fIpath\fR
-.RS 4
-A path to a directory
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-An array with the directory names
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid io.error(String text)\fR
-.RS 4
-.sp
-Shows an error message in the browser window\&.
-.PP
-\fItext\fR
-.RS 4
-The message to show
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid io.notify(String text)\fR
-.RS 4
-.sp
-Shows a message in the browser window\&.
-.PP
-\fItext\fR
-.RS 4
-The message to show
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid io.print(String text, [String stream])\fR
-.RS 4
-.sp
-Print text to stdout or stderr
-.PP
-\fItext\fR
-.RS 4
-the text to print
-.RE
-.PP
-\fIstream\fR
-.RS 4
-pass "stderr" to print to stderr, optional
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBString io.prompt(String text, [Boolean visible])\fR
-.RS 4
-.sp
-Gets user input synchronously\&.
-.PP
-\fItext\fR
-.RS 4
-The message for the prompt
-.RE
-.PP
-\fIvisible\fR
-.RS 4
-Whether the chars should be visible, pass false for a password prompt, default true, optional
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-The text that was entered or null
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBString io.read(String path)\fR
-.RS 4
-.sp
-Read from a file\&.
-.PP
-\fIpath\fR
-.RS 4
-Path to a file that should be read
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-A string with the file content
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBBoolean io.write(String path, String mode, String text)\fR
-.RS 4
-.sp
-Write to a file
-.PP
-\fIpath\fR
-.RS 4
-Path to a file to write to
-.RE
-.PP
-\fImode\fR
-.RS 4
-Either "a" to append to the file, or "w" to strip the file or create a new file\&.
-.RE
-.PP
-\fItext\fR
-.RS 4
-The text that should be written to the file
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-true if writing was successful
-.RE
-.RE
-.SS "system"
-.sp
-The system object implements system methods\&.
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBBoolean system.fileTest(String path, FileTest flags)\fR
-.RS 4
-.sp
-Checks for FileTest flags on a file\&.
-.PP
-\fIpath\fR
-.RS 4
-Path to a file to check
-.RE
-.PP
-\fIflags\fR
-.RS 4
-The flags to test
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-true if any of the test on the flags is true
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBString system.getEnv(String name)\fR
-.RS 4
-.sp
-Get a system environment variable
-.PP
-\fIname\fR
-.RS 4
-Name of the variable
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-The variable or null if the variable wasn\(cqt found
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBBoolean system.mkdir(String path, Number mode)\fR
-.RS 4
-.sp
-Creates a directory and all parent directories\&.
-.PP
-\fIpath\fR
-.RS 4
-Path to create
-.RE
-.PP
-\fImode\fR
-.RS 4
-The permissions the directory will get
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-true if creation was successful or directory already existed
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBDeferred system.spawn(String command, [Function stdin], [Function stderr])\fR
-.RS 4
-.sp
-Executes a shell command using the default search path
-.PP
-\fIcommand\fR
-.RS 4
-The command to execute
-.RE
-.PP
-\fIstdout(String)\fR
-.RS 4
-Callback function for stdin, pass null if only stderr is needed, optional
-.RE
-.PP
-\fIstderr(String)\fR
-.RS 4
-Callback function for stderr, optional
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-A deferred, it will be resolved if the child exits normally, it will be rejected if the child process exits abnormally, the first parameter of the reject function will be the status code of the child process\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBObject system.spawnSync(String command)\fR
-.RS 4
-.sp
-Executes a shell command synchronously using the default search path
-.PP
-\fIcommand\fR
-.RS 4
-The command to execute
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-An object that contains stdout, stderr and status\&.
-.RE
-.RE
-.SS "tabs"
-.sp
-The tabs object implements methods and properties to get webview objects\&.
-.PP
-\fItabs\&.current (webview, read)\fR
-.RS 4
-The currently focused webview
-.RE
-.PP
-\fItabs\&.length (Number, read)\fR
-.RS 4
-Total number of tabs
-.RE
-.PP
-\fItabs\&.number (Number, read)\fR
-.RS 4
-Number of the currently focused tab
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBwebview tabs.nth(Number n)\fR
-.RS 4
-.sp
-Gets the webview object of the nth tab
-.PP
-\fIn\fR
-.RS 4
-Number of the tab
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-The corresponding webview
-.RE
-.RE
-.SS "util"
-.sp
-The util object implements helper methods\&.
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBString util.getBody(Function func)\fR
-.RS 4
-.sp
-Gets the body of a function, useful for scripts that will be injected into sites\&.
-.PP
-\fIfunc\fR
-.RS 4
-A function
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-The body of the function as a string
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBNumber util.getMode()\fR
-.RS 4
-.sp
-Gets the the current mode\&.
-.PP
-\fIreturns\fR
-.RS 4
-The mode, see Modes for possible modes\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBString util.domainFromHost(String hostname)\fR
-.RS 4
-.sp
-Gets the base domain name from a hostname where the base domain name is the effective second level domain name, e\&.g\&. for www\&.example\&.com it will be example\&.com, for www\&.example\&.co\&.uk it will be example\&.co\&.uk\&.
-.PP
-\fIhostname\fR
-.RS 4
-a hostname
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-the base domain
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBString util.getSelection()\fR
-.RS 4
-.sp
-Get selected text from the focused webview\&.
-.PP
-\fIreturns\fR
-.RS 4
-The selection or null if no text was selected\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBString util.markupEscape(String text)\fR
-.RS 4
-.sp
-Escapes text for usage with pango markup\&.
-.PP
-\fItext\fR
-.RS 4
-A text to escape
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-The escaped text or
-\fInull\fR;
-.RE
-.sp
-dwb also adds additional methods to builtin objects
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid Object.forEach(Function func(String key, Object value, Object this))\fR
-.RS 4
-.sp
-Executes a function for each enumarable property of this similar to Array\&.forEach\&.
-.PP
-\fIfunc\fR
-.RS 4
-The function to execute
-.RE
-.PP
-\fIkey\fR
-.RS 4
-The property name
-.RE
-.PP
-\fIvalue\fR
-.RS 4
-The property value
-.RE
-.PP
-\fIthis\fR
-.RS 4
-The object forEach is called on
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBNumber Array.fastIndexOf(Object object)\fR
-.RS 4
-.sp
-This method is basically the same as Array\&.indexOf but without type checking\&.
-.PP
-\fIobject\fR
-.RS 4
-The object to search for
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-The index in the array or \-1 if the Object wasn\(cqt found\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBNumber Array.fastLastIndexOf(Object object)\fR
-.RS 4
-.sp
-This method is basically the same as Array\&.lastIndexOf but without type checking\&.
-.PP
-\fIobject\fR
-.RS 4
-The object to search for
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-The index in the array or \-1 if the Object wasn\(cqt found\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid Function.debug([Object scope])\fR
-.RS 4
-.sp
-A wrapper method for debugging callbacks, especially useful if it is combined with script\&.
-.PP
-\fIscope\fR
-.RS 4
-
-\fBscript\fR
-or
-\fBthis\fR, optional
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-A new function that calls script\&.debug on errors\&.
-.RE
-.RE
-.SS "clipboard"
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid clipboard.get(Selection selection, [Function callback])\fR
-.RS 4
-.sp
-Gets the X11 clipboard\&.
-.PP
-\fIselection\fR
-.RS 4
-The Selection to get
-.RE
-.PP
-\fIcallback\fR
-.RS 4
-If a callback function is used the clipboard will be fetched asynchronously, the first parameter will be the content of the clipboard, else it will be fetched synchronously
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-If no callback was provided it returns the text content of the clipboard\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid clipboard.set(Selection selection, String text)\fR
-.RS 4
-.sp
-Sets the X11 clipboard\&.
-.PP
-\fIselection\fR
-.RS 4
-The Selection to set
-.RE
-.PP
-\fItext\fR
-.RS 4
-Text that will be stored in the clipboard\&.
-.RE
-.RE
-.SS "gui"
-.sp
-Most gtk\-widgets can be accessed from scripts, an overview of the layout can be found under https://portix\&.bitbucket\&.org/dwb/resources/layout\&.html\&.
-.PP
-\fIgui\&.window (GtkWindow, read)\fR
-.RS 4
-The main window\&.
-.RE
-.PP
-\fIgui\&.mainBox (GtkBox, read)\fR
-.RS 4
-The the main container, child of
-\fBgui\&.window\fR\&.
-.RE
-.PP
-\fIgui\&.tabBox (GtkBox, read)\fR
-.RS 4
-The box used for tab labels, child of
-\fBgui\&.mainBox\fR\&.
-.RE
-.PP
-\fIgui\&.contentBox (GtkBox, read)\fR
-.RS 4
-The box used for the main content, it contains all webviews, child of
-\fBgui\&.mainBox\fR\&.
-.RE
-.PP
-\fIgui\&.statusWidget (GtkEventBox, read)\fR
-.RS 4
-The outmost statusbar widget, used for setting the statusbars colors, child of
-\fBgui\&.mainBox\fR\&.
-.RE
-.PP
-\fIgui\&.statusAlignment (GtkAlignment, read)\fR
-.RS 4
-Used for the statusbar alignment, child of
-\fBgui\&.statusWidget\fR\&.
-.RE
-.PP
-\fIgui\&.statusBox (GtkBox, read)\fR
-.RS 4
-The box that contains the statusbar widgets, grandchild of
-\fBgui\&.statusAlignment\fR\&.
-.RE
-.PP
-\fIgui\&.messageLabel (GtkLabel, read)\fR
-.RS 4
-Label used for notifications, first child of
-\fBgui\&.statusBox\fR\&.
-.RE
-.PP
-\fIgui\&.entry (GtkEntry, read)\fR
-.RS 4
-The entry, second child of
-\fBgui\&.statusBox\fR\&.
-.RE
-.PP
-\fIgui\&.uriLabel (GtkLabel, read)\fR
-.RS 4
-Label used for displaying uris, third child of
-\fBgui\&.statusBox\fR\&.
-.RE
-.PP
-\fIgui\&.statusLabel (GtkLabel, read)\fR
-.RS 4
-Label used for status information, fourth child of
-\fBgui\&.statusBox\fR\&.
-.RE
-.SS "Deferred"
-.sp
-Deferred objects can be used to manage asynchronous operations\&. It can trigger a callback function when an asynchrounous operation has finished, and allows chaining of callbacks\&. Deferred basically has 2 callback chains, a \fIdone\fR\-chain and a \fIfail\fR\-chain\&. If a asynchronous operation is successful the deferred should be resolved and the done callback chain of the deferred is called\&. If a asynchronous operation fails the deferred should be rejected and the fail callback chain of the deferred is called\&.
-.sp
-Deferreds implement the following methods:
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid Deferred.always(Function callback)\fR
-.RS 4
-.sp
-Registers a function for then done and fail chain\&.
-.PP
-\fIcallback\fR
-.RS 4
-A callback function that will be called when the Deferred is resolved or rejected\&. If the function returns a deferred the original deferred will be replaced with the new deferred\&.
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-A new deferred that can be used to chain callbacks\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid Deferred.done(Function callback)\fR
-.RS 4
-.sp
-Registers a function for the done\-chain\&.
-.PP
-\fIcallback\fR
-.RS 4
-A callback function that will be called when the Deferred is resolved\&. If the function returns a deferred the original deferred will be replaced with the new deferred\&.
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-A new deferred that can be used to chain callbacks\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBDeferred Deferred.fail(Function callback)\fR
-.RS 4
-.sp
-Registers a function for the fail\-chain\&.
-.PP
-\fIcallback\fR
-.RS 4
-A callback function that will be called when the deferred is rejected\&. If the function returns a deferred the original deferred will be replaced with the new deferred\&.
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-A new deferred that can be used to chain callbacks\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBDeferred Deferred.reject(arguments)\fR
-.RS 4
-.sp
-Rejects a deferred, the fail\-chain is called when a deferred is rejected\&.
-.PP
-\fIarguments\fR
-.RS 4
-Arguments passed to the
-\fIfail\fR
-callbacks\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid Deferred.resolve(arguments)\fR
-.RS 4
-.sp
-Resolves a deferred, the done\-chain is called when a deferred is resolved\&.
-.PP
-\fIarguments\fR
-.RS 4
-Arguments passed to the
-\fIdone\fR
-callbacks\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBDeferred Deferred.then(Function ondone, Function onfail)\fR
-.RS 4
-.sp
-Registers a function for the done and fail chain\&.
-.PP
-\fIondone\fR
-.RS 4
-A callback function that will be called when the deferred is resolved\&. If the function returns a deferred the original deferred will be replaced with the new deferred\&.
-.RE
-.PP
-\fIonfail\fR
-.RS 4
-A callback function that will be called when the deferred is rejected\&. If the function returns a deferred the original deferred will be replaced with the new deferred\&.
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-A new deferred that can be used to chain callbacks\&.
-.RE
-.sp
-Deferred also implements a static method:
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBValue Deferred.when(Value value, Function ondone, Function onfail)\fR
-.RS 4
-.sp
-Static method that can be used for synchronous and asynchronous operations\&. If if \fBvalue\fR is a Deferred \fBondone\fR is called when the Deferred is resolved and \fBonfail\fR is called if the Deferred is rejected, otherwise ondone is called and value is the first parameter of the callback\&.
-.PP
-\fIvalue\fR
-.RS 4
-A Deferred or a value\&.
-.RE
-.PP
-\fIondone\fR
-.RS 4
-Callback function\&.
-.RE
-.PP
-\fIonfail\fR
-.RS 4
-Callback function\&.
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-The value\&.
-.RE
-.sp
-Simple usage of a deferred:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-function loadUri(uri) {
-    var d = new Deferred();
-    tabs\&.current\&.loadUri(uri, function(wv) {
-        if (wv\&.loadStatus == LoadStatus\&.finished)
-        {
-            d\&.resolve("Finished");
-            return true;
-        }
-        else if (wv\&.loadStatus == LoadStatus\&.failed)
-        {
-            d\&.reject("Failed");
-            return true;
-        }
-    });
-    return d;
-}
-
-loadUri("http://www\&.example\&.com")\&.then(
-    function(response) {
-        io\&.print(response); // Finished
-    },
-    function(response) {
-        io\&.print(response); // Failed
-    }
-);
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Chaining of a deferred:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-function foo()
-{
-    var d = new Deferred();
-    timerStart(2000, function() {
-        d\&.reject("rejected");
-    });
-    return d;
-}
-
-function onResponse(response)
-{
-    io\&.print(response);
-}
-
-// Will print "rejected" twice to stdout after 2 seconds
-foo()\&.fail(onResponse)\&.fail(onResponse);
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Note that if the deferred is rejected only the fail chain is called, when it is resolved only the done chain is called\&.
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-function foo()
-{
-    var d = new Deferred();
-    timerStart(2000, function() {
-        d\&.reject("rejected");
-        // Already rejected, will not execute the done chain
-        d\&.resolve("rejected");
-    });
-    return d;
-}
-
-function onResponse(response)
-{
-    io\&.print(response);
-}
-
-// Only the fail will be executed
-
-foo()\&.fail(onResponse)\&.done(onResponse);
-foo()\&.done(onResponse)\&.fail(onResponse);
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Changing the deferred in a callback chain:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-function foo(message)
-{
-    var d = new Deferred();
-    timerStart(2000, function() {
-        d\&.resolve(message);
-    });
-    return d;
-}
-function callback1(response)
-{
-    io\&.print(response); // Prints "foo" after 2 seconds
-
-    // Return a new Deferred, will replace the old one\&.
-    return foo("bar");
-}
-function callback2(response)
-{
-    io\&.print(response); // Prints "bar" after 4 seconds
-}
-
-foo("foo")\&.done(callback1)\&.done(callback2);
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Using Deferred\&.when
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-function asyncOperation() {
-    var d = new Deferred();
-    \&.\&.\&.\&.
-    return d;
-}
-function syncOperation()
-{
-    var result = {};
-    \&.\&.\&.\&.
-    return result;
-}
-Deferred\&.when(asyncOperation(), function() {\&.\&.\&.});
-Deferred\&.when(syncOperation(), function() {\&.\&.\&.});
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.SS "settings"
-.sp
-Readonly object that can be used to query dwb\(cqs current settings, all settings can also be used in camelcase, to modify settings \fBexecute\fR can be used\&.
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-if (settings\&.enablePrivateBrowsing == true)
-    execute("set enable\-private\-browsing false");
-.fi
-.if n \{\
-.RE
-.\}
-.SH "WEBKIT OBJECTS"
-.sp
-All webkit objects correspond to gobject objects, i\&.e\&. they have the same properties, but the javascript properties are all camelcase\&. For example, a WebKitWebView has the property \fBzoom\-level\fR, the corresponding javascript property is \fBzoomLevel\fR:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-var webview = tabs\&.current
-webview\&.zoomLevel = webview\&.zoomLevel * 2;
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-To check if an object is derived from GObject the instanceof operator can be used:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-if (myObject instanceof GObject)
-{
-  \&.\&.\&.
-}
-.fi
-.if n \{\
-.RE
-.\}
-.SS "General methods"
-.sp
-The following methods are implemented by all Objects derived from GObject
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid object.blockSignal(Number signalid)\fR
-.RS 4
-.sp
-Blocks emission of a gobect signal\&.
-.PP
-\fIsignalid\fR
-.RS 4
-The signalid returned from
-\fBobject\&.connect\fR
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBNumber object.connect(String name, Function callback, [Boolean after])\fR
-.RS 4
-.sp
-Connect to a gobject\-signal, note that all signals are connected using the \fIsignal::\fR\- or with \fInotify::\fR\-prefix\&. If connecting to a signal the \fIsignal::\fR\-prefix must be omitted\&. The callback function will have the same parameters as the GObject signal callback, however some parameters may be undefined if they cannot be converted to javascript objects\&. All signal handlers are executed after dwb\(cqs default handler\&.
-.PP
-\fIname\fR
-.RS 4
-The signal name to connect to\&.
-.RE
-.PP
-\fIcallback\fR
-.RS 4
-Callback function that will be called when the signal is emitted\&.
-.RE
-.PP
-\fIafter\fR
-.RS 4
-Whether to install the handler after the default handler, default false\&.
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-The signal id of the signal\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBNumber object.connectBlocked(String name, Function callback, [Boolean after])\fR
-.RS 4
-.sp
-Connect to a gobject\-signal but block the emission of the own callback during execution of the callback, useful if the object is connected to a notify event and the the property is changed in the callback function\&.
-.PP
-\fIname\fR
-.RS 4
-The signal name to connect to\&.
-.RE
-.PP
-\fIcallback\fR
-.RS 4
-Callback function that will be called when the signal is emitted\&.
-.RE
-.PP
-\fIafter\fR
-.RS 4
-Whether to install the handler after the default handler, default false\&.
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-The signal id of the signal\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBBoolean object.disconnect(Number id)\fR
-.RS 4
-.sp
-Disconnect from a gobject\-signal\&.
-.PP
-\fIid\fR
-.RS 4
-The signal id obtained from connect
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-true if the signal was disconnected
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBNumber object.notify(String name, Function callback, [Boolean after])\fR
-.RS 4
-.sp
-Wrapper function for property\-change notification, the same as \fIobject\&.connect("notify::" + name, callback, after);\fR\&.
-.PP
-\fIname\fR
-.RS 4
-The property name to connect to, the name can also be in camelcase\&.
-.RE
-.PP
-\fIcallback\fR
-.RS 4
-Callback function that will be called when the property changes\&.
-.RE
-.PP
-\fIafter\fR
-.RS 4
-Whether to install the handler after the default handler, default after\&.
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-The signal id of the signal\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBNumber object.notifyBlocked(String name, Function callback, [Boolean after])\fR
-.RS 4
-.sp
-Wrapper function for property\-change notification, the same as \fIobject\&.connectBlocked("notify::" + name, callback, after);\fR\&.
-.PP
-\fIname\fR
-.RS 4
-The property name to connect to, the name can also be in camelcase\&.
-.RE
-.PP
-\fIcallback\fR
-.RS 4
-Callback function that will be called when the property changes\&.
-.RE
-.PP
-\fIafter\fR
-.RS 4
-Whether to install the handler after the default handler, default after\&.
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-The signal id of the signal\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBObject GObject.getPrivate(String key, Object identifier)\fR
-.RS 4
-.sp
-Gets a value previously set with GObject\&.setPrivate\&.
-.PP
-\fIkey\fR
-.RS 4
-The property name
-.RE
-.PP
-\fIidentifier\fR
-.RS 4
-The identifier passed to setPrivate
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-The object set with setPrivate or null\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid GObject.setPrivate(String key, String value, Object identifier)\fR
-.RS 4
-.sp
-Associates a private value with an object that can only be retrieved in the calling script\&.
-.PP
-\fIkey\fR
-.RS 4
-The property name
-.RE
-.PP
-\fIvalue\fR
-.RS 4
-The property value
-.RE
-.PP
-\fIidentifier\fR
-.RS 4
-A local object to identify the calling script, the identifier must either be of type Object or of type Function\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid object.unblockSignal(Number signalid)\fR
-.RS 4
-.sp
-Unblocks a signal previously blocked with \fBobject\&.blockSignal\fR\&.
-.PP
-\fIsignalid\fR
-.RS 4
-The signalid returned from
-\fBobject\&.connect\fR
-.RE
-.RE
-.SS "webview"
-.sp
-The webview object represents the widget that actually displays the site content\&.
-.PP
-\fIwv\&.allFrames (Array of frames, read)\fR
-.RS 4
-All frames of a webview including the mainframe
-.RE
-.PP
-\fIwv\&.focusedFrame (Frame, read)\fR
-.RS 4
-The focused frame of the webview
-.RE
-.PP
-\fIwv\&.historyList (Historylist, read)\fR
-.RS 4
-The focused frame of the webview
-.RE
-.PP
-\fIwv\&.mainFrame (Frame, read)\fR
-.RS 4
-The main frame of the webview
-.RE
-.PP
-\fIwv\&.number (Number, read)\fR
-.RS 4
-The number of the webview, starting at 0
-.RE
-.PP
-\fIwv\&.scrolledWindow (GtkScrollwindow, read)\fR
-.RS 4
-The parent widget of every webview, it is used for scrolling the webview\&.
-.RE
-.PP
-\fIwv\&.tabWidget (GtkEventBox, read)\fR
-.RS 4
-The main widget for tab labels, used for coloring tabs, child of
-\fBgui\&.tabBox\fR\&.
-.RE
-.PP
-\fIwv\&.tabBox (GtkBox, read)\fR
-.RS 4
-Horizontal box, child of
-\fBwv\&.tabWidget\fR\&.
-.RE
-.PP
-\fIwv\&.tabIcon (GtkImage, read)\fR
-.RS 4
-Favicon widget, child of
-\fBwv\&.tabBox\fR\&.
-.RE
-.PP
-\fIwv\&.tabLabel (GtkLabel, read)\fR
-.RS 4
-Text label of a tab, child of
-\fBwv\&.tabBox\fR\&.
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBString wv.inject(String script, [Object argument], [Boolean global])\fR
-.RS 4
-.sp
-Injects a script into a webview
-.PP
-\fIscript\fR
-.RS 4
-The script to inject
-.RE
-.PP
-\fIargument\fR
-.RS 4
-If the script isn\(cqt injected into the global scope the script is wrapped inside a function\&. argument then is accesible via
-\fIarguments\fR
-in the injected script, optional
-.RE
-.PP
-\fIglobal\fR
-.RS 4
-true to inject it into the global scope, false to encapsulate it in a function, optional
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-The return value of the script\&. If the script is injected globally inject always returns null\&. The return value is always converted to a string\&. To return objects call JSON\&.parse on the return value\&.
-.RE
-.if n \{\
-.sp
-.\}
-.RS 4
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBNote\fR
-.ps -1
-.br
-.sp
-If a script is injected from a loadStatus\-callback the script must be injected after LoadStatus\&.committed has been emitted\&. On LoadStatus\&.committed the document hasn\(cqt been created, if the script modifies the DOM it should be injected when LoadStatus\&.finished or documentLoaded is emitted\&. If only LoadStatus\&.committed or loadFinished\&.committed are used it is better to use the corresponding signals instead to reduce overhead\&.
-.sp .5v
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid wv.history(Number steps)\fR
-.RS 4
-.sp
-Loads a history item steps away from the current history item
-.PP
-\fIsteps\fR
-.RS 4
-Number of steps, pass a negative value to go back in history
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBBoolean wv.loadUri(String uri, [Function callback])\fR
-.RS 4
-.sp
-Loads an uri in a webview\&.
-.PP
-\fIuri\fR
-.RS 4
-The uri to load
-.RE
-.PP
-\fIcallback\fR
-.RS 4
-A callback function that will be called when the load status changes, return true to stop the emission, optional
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-true if the uri is loaded
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid wv.reload(void)\fR
-.RS 4
-.sp
-Reloads a webview
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid wv.stopLoading()\fR
-.RS 4
-.sp
-Stops any ongoing loading\&.
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBNumber wv.toPng(String filename, [Number width, Number height], [Boolean keepAspect])\fR
-.RS 4
-.sp
-Renders a webview to a png file\&.
-.PP
-\fIfilename\fR
-.RS 4
-The filename for the png\&.
-.RE
-.PP
-\fIwidth\fR
-.RS 4
-The width of the png, if width is < 0 and height is > 0 the image will have the same aspect ratio as the original webview, optional\&.
-.RE
-.PP
-\fIheight\fR
-.RS 4
-The height of the png, if height is < 0 and width is > 0 the image will have the same aspect ratio as the original webview, optional, mandatory if width is set\&.
-.RE
-.PP
-\fIkeepAspect\fR
-.RS 4
-Whether to keep the aspect ratio, if set to true the new image will have the same aspect ratio as the original webview, width and height are taken as maximum sizes and must both be > 0, optional\&.
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-A cairo_status_t (0 on success) or \-1 if an error occured\&.
-.RE
-.RE
-.SS "frame"
-.sp
-A frame represents a frame or iframe\&. Due to same origin policy it is not possible to inject scripts from a webview into iframes with a different domain\&. For this purpose the frame object can be used\&.
-.PP
-\fIframe\&.domain (String, read)\fR
-.RS 4
-The domain name of the frame which is the effective second level domain
-.RE
-.PP
-\fIframe\&.host (String, read)\fR
-.RS 4
-The host name of the frame
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBBoolean frame.inject(String script, [Boolean global])\fR
-.RS 4
-.sp
-Injects a script into a frame, see also webview\&.inject for details\&.
-.RE
-.SS "download"
-.sp
-Corresponds to a WebKitDownload\&.
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBnew Download(String uri)\fR
-.RS 4
-.sp
-Constructs a new download
-.PP
-\fIuri\fR
-.RS 4
-The uri of the download
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBBoolean download.start([Function callback])\fR
-.RS 4
-.sp
-Starts a download
-.PP
-\fIcallback\fR
-.RS 4
-A callback function that will be executed whenever the DownloadStatus changes, return true to stop the emission, optional\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid download.cancel()\fR
-.RS 4
-.sp
-Cancels a download
-.RE
-.SS "historylist"
-.sp
-Corresponds to a WebkitWebBackForwardList\&.
-.PP
-\fIhistorylist\&.backLength\fR
-.RS 4
-Number of items that precede the current item
-.RE
-.PP
-\fIhistorylist\&.forwardLength\fR
-.RS 4
-Number of items that succeed the current item
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBWebKitWebHistoryItem historylist.getItem([Number position])\fR
-.RS 4
-.sp
-Gets a WebKitWebHistoryItem\&.
-.PP
-\fIposition\fR
-.RS 4
-The position of the item where 0 corresponds to the current item\&.
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-A WebKitWebHistoryItem\&.
-.RE
-.RE
-.SH "GTK WIDGETS"
-.sp
-It is possible to create new widgets but only widgets that are currently used by dwb can be created, the widgets used by dwb can be found under http://portix\&.bitbucket\&.org/dwb/resources/layout\&.html\&.
-.SS "Constructor"
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBnew GtkWindow(String type)\fR
-.RS 4
-.sp
-Constructs a new widget
-.PP
-\fItype\fR
-.RS 4
-The type of the widget, e\&.g\&. "GtkLabel"
-.RE
-.RE
-.SS "Methods"
-.sp
-All created widgets implement the following methods:
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid GtkWidget.destroy()\fR
-.RS 4
-.sp
-Destroys a widget\&. Note that only newly created widgets can be destroyed\&.
-.sp
-Widgets that implement the GtkBox interface implement the following methods:
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid GtkWidget.packEnd(GtkWidget child, boolean expand, boolean fill, int padding)\fR
-.RS 4
-.sp
-Adds a widget to a GtkBox\&.
-.PP
-\fIchild\fR
-.RS 4
-The child widget
-.RE
-.PP
-\fIexpand\fR
-.RS 4
-Whether to expand the widget
-.RE
-.PP
-\fIfill\fR
-.RS 4
-Whether to fill the remaining space
-.RE
-.PP
-\fIpadding\fR
-.RS 4
-Padding in the box
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid GtkWidget.packStart(GtkWidget child, boolean expand, boolean fill, int padding)\fR
-.RS 4
-.sp
-Adds a widget to a GtkBox\&.
-.PP
-\fIchild\fR
-.RS 4
-The child widget
-.RE
-.PP
-\fIexpand\fR
-.RS 4
-Whether to expand the widget
-.RE
-.PP
-\fIfill\fR
-.RS 4
-Whether to fill the remaining space
-.RE
-.PP
-\fIpadding\fR
-.RS 4
-Padding in the box
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid GtkWidget.reorderChild(GtkWidget child, int postion)\fR
-.RS 4
-.sp
-Moves a widget to a new position\&.
-.PP
-\fIchild\fR
-.RS 4
-The child widget
-.RE
-.PP
-\fIposition\fR
-.RS 4
-The new position
-.RE
-.sp
-Widgets derived from GtkContainer implement the following methods:
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid GtkWidget.add(GtkWidget child)\fR
-.RS 4
-.sp
-Adds a widget to a GtkContainer\&.
-.PP
-\fIchild\fR
-.RS 4
-The child widget
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBExample\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-var label = new GtkWidget("GtkLabel");
-gui\&.statusBox\&.packStart(label, false, false, 0);
-label\&.label = "foobar";
-label\&.visible = true;
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.SH "SIGNALS"
-.sp
-With the signals object \fBdwb\fR communicates with the script on certain events\&. To connect to a signal one can call the connect function that is implemented by the signals object, that takes 2 arguments, the name of the signal and a callback function\&.
-.sp
-The callback function has a varying number of parameters\&. The last paramter is always a json\-object which might be empty or contain additional data relevant to the signal\&. A callback function should either return true or false or nothing which is equivalent to false\&. If multiple callbacks are connected to the same signal and one callback function returns true the overall return value will be true\&.
-.sp
-\fBdwb\fR only emits signals as long as one callback is connected to a signal\&. To reduce overhead one should disconnect from signals when no longer needed\&.
-.sp
-The signals object is not a readonly object, properties can be added to the object which are visible in all scripts but it should be avoided to add properties on the signals object\&. signals should only be used to connect to signals or define custom signals\&.
-.sp
-The signals object implements the following methods
-.SS "Methods"
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBNumber signals.connect(String signal, Function callback)\fR
-.RS 4
-.sp
-Connect to a signal
-.PP
-\fIsignal\fR
-.RS 4
-The signal to connect to
-.RE
-.PP
-\fIcallback\fR
-.RS 4
-The callback function which will be called when the signal is emitted
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-Unique id for this connection, can be passed to disconnect
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBNumber signals.connectWebView(String signal, Function callback)\fR
-.RS 4
-.sp
-Connect all webviews to a GObject signal
-.PP
-\fIsignal\fR
-.RS 4
-The signal to connect to
-.RE
-.PP
-\fIcallback\fR
-.RS 4
-The callback function which will be called when the signal is emitted, the arguments of the callback function correspond to the GObject callback
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBBoolean signals.emit(String signal, \&...)\fR
-.RS 4
-.sp
-Emits a signal with a variable number of arguments passed to the callback function
-.PP
-\fIsignal\fR
-.RS 4
-The signal to emit
-.RE
-.PP
-\fI\&...\fR
-.RS 4
-Objects passed to the callback function
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-Overall return value from all connected callback functions
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBBoolean signals.disconnect(Number id|Function callback)\fR
-.RS 4
-.sp
-Disconnect from a signal
-.PP
-\fIid|callback\fR
-.RS 4
-The id returned from
-\fBconnect\fR
-or the callback function passed to
-\fBconnect\fR\&. Note that if the same callback is used more than once the signal must be disconnected by id, otherwise the behaviour is undefined\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid signals.disconnectByName(String signal)\fR
-.RS 4
-.sp
-Disconnect from all signals with matching name, It should be avoided to call disconnectByName on signals implemented by dwb since it will completely stop the emission of the signal in all scripts\&.
-.PP
-\fIsignal\fR
-.RS 4
-The callback function passed to connect
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-true if signals were disconnected, false if no signal was disconnected
-.RE
-.RE
-.SS "Emitted signals"
-.sp
-Custom signals can be created by simply calling
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("nameOfNewSignal", callbackFunction);
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Signals emitted by dwb are the following:
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBbuttonPress\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("buttonPress", function(webview, hittestresult, event));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when a button is pressed on the webview, return true to prevent the default action
-.PP
-\fIwebview\fR
-.RS 4
-The webview which received the signal
-.RE
-.PP
-\fIhittestresult\fR
-.RS 4
-Hittestresult under the cursor
-.RE
-.PP
-\fIevent\&.button\fR
-.RS 4
-The button that is pressed, usually a value between 1 and 5
-.RE
-.PP
-\fIevent\&.state\fR
-.RS 4
-A bitmap of modifiers pressed, see Modifier
-.RE
-.PP
-\fIevent\&.time\fR
-.RS 4
-The time in milliseconds when the button was pressed
-.RE
-.PP
-\fIevent\&.type\fR
-.RS 4
-A ClickType
-.RE
-.PP
-\fIevent\&.x\fR
-.RS 4
-x\-position relative to the window
-.RE
-.PP
-\fIevent\&.xRoot\fR
-.RS 4
-x\-position relative to the screen
-.RE
-.PP
-\fIevent\&.y\fR
-.RS 4
-y\-position relative to the window
-.RE
-.PP
-\fIevent\&.yRoot\fR
-.RS 4
-y\-position relative to the screen
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBbuttonRelease\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("buttonRelease", function(webview, hittestresult, event));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when a button is released, return true to prevent the default action
-.PP
-\fIwebview\fR
-.RS 4
-The webview which received the signal
-.RE
-.PP
-\fIhittestresult\fR
-.RS 4
-Hittestresult under the cursor
-.RE
-.PP
-\fIevent\fR
-.RS 4
-Same as buttonPress but without
-\fIevent\&.type\fR
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBchangeMode\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("changeMode", function(webview, mode));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when the mode changes, return true to prevent the change\&.
-.PP
-\fIwebview\fR
-.RS 4
-The focused webview
-.RE
-.PP
-\fImode\fR
-.RS 4
-A mode, see also Modes for possible modes
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBclose\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("close", function());
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when dwb is closed
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBcreateTab\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("createTab", function(webview));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when a tab is created
-.PP
-\fIwebview\fR
-.RS 4
-The webview that corresponds to the created tab
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBcloseTab\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("closeTab", function(webview));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when a tab is closed
-.PP
-\fIwebview\fR
-.RS 4
-The webview that corresponds to the tab
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBdocumentLoaded\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("documentLoaded",  function(webview, frame));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when a the DOM document of a frame has been loaded\&.
-.PP
-\fIwebview\fR
-.RS 4
-The webview that emitted the signal
-.RE
-.PP
-\fIframe\fR
-.RS 4
-The frame that contains the document
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBdownload\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("download", function(webview, download, json));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted before a download starts, before a file or action has been chosen, return true if the signal was handled\&.
-.PP
-\fIwebview\fR
-.RS 4
-The webview that emitted the signal
-.RE
-.PP
-\fIdownload\fR
-.RS 4
-The Download
-.RE
-.PP
-\fIjson\&.referer\fR
-.RS 4
-The referer
-.RE
-.PP
-\fIjson\&.mimeType\fR
-.RS 4
-The mimetype of the file
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBdownloadStart\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("downloadStart", function(download, json));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted before a download starts after a path or application has been chosen, return true if the signal was handled\&. Note that destinationUri has not been set on the download\&.
-.PP
-\fIdownload\fR
-.RS 4
-The Download
-.RE
-.PP
-\fIjson\&.referer\fR
-.RS 4
-The referer
-.RE
-.PP
-\fIjson\&.mimeType\fR
-.RS 4
-The mimetype of the file
-.RE
-.PP
-\fIjson\&.destinationUri\fR
-.RS 4
-The chosen destination path or null if an application was chosen\&.
-.RE
-.PP
-\fIjson\&.application\fR
-.RS 4
-The chosen application or null if a path was chosen\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBdownloadStatus\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("downloadStatus", function(download));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when the DownloadStatus changes\&.
-.PP
-\fIdownload\fR
-.RS 4
-The Download
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBexecuteCommand\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("executeCommand", function(commandinfo));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when a command is executed, return true to prevent execution\&.
-.PP
-\fIcommandinfo\&.command\fR
-.RS 4
-The command that is executed
-.RE
-.PP
-\fIcommandinfo\&.argument\fR
-.RS 4
-An argument, if the command isn\(cqt executed from commandline this will always be null\&.
-.RE
-.PP
-\fIcommandinfo\&.nummod\fR
-.RS 4
-The numerical modifier\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBframeCreated\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("frameCreated", function(webview, frame));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when a frame is created
-.PP
-\fIwebview\fR
-.RS 4
-The webview the frame belongs to
-.RE
-.PP
-\fIframe\fR
-.RS 4
-The frame
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBframeStatus\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("frameStatus", function(webview, frame));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when the LoadStatus of a frame changes
-.PP
-\fIwebview\fR
-.RS 4
-The webview the frame belongs to
-.RE
-.PP
-\fIframe\fR
-.RS 4
-The frame
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBkeyPress\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("keyPress", function(webview, json));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when a key is pressed, return true to prevent the default action
-.PP
-\fIwebview\fR
-.RS 4
-The focused webview
-.RE
-.PP
-\fIjson\&.isModifier\fR
-.RS 4
-Whether or not the key is a modifier
-.RE
-.PP
-\fIjson\&.keyCode\fR
-.RS 4
-Hardware keycode
-.RE
-.PP
-\fIjson\&.keyVal\fR
-.RS 4
-Keycode as listed in gdkkeysyms\&.h
-.RE
-.PP
-\fIjson\&.name\fR
-.RS 4
-A string represantation of the key
-.RE
-.PP
-\fIjson\&.state\fR
-.RS 4
-A bitmap of modifiers pressed, see Modifier
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBkeyRelease\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("keyRelease", function(webview, json));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when a key is released, return true to prevent the default action
-.PP
-\fIwebview\fR
-.RS 4
-The focused webview
-.RE
-.PP
-\fIjson\fR
-.RS 4
-Same as keyPress
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBloadCommitted\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("loadCommitted", function(webview));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when the load has just commited, no data has been loaded when this signal is emitted\&. This is the preferred signal for injected scripts that do not manipulate the DOM\&.
-.PP
-\fIwebview\fR
-.RS 4
-The webview that emitted the signal
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBloadFinished\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("loadFinished", function(webview));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when the site has completely loaded\&.
-.PP
-\fIwebview\fR
-.RS 4
-The webview that emitted the signal
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBloadStatus\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("loadStatus", function(webview));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when the load status changes
-.PP
-\fIwebview\fR
-.RS 4
-The webview that emitted the signal
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBmimeType\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("mimeType", function(webview, frame, request, json));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Decide whether or not to show a given mimetype\&. Return true to stop the request\&.
-.PP
-\fIwebview\fR
-.RS 4
-The webview that emitted the signal
-.RE
-.PP
-\fIframe\fR
-.RS 4
-The frames requires the decision
-.RE
-.PP
-\fIrequest\fR
-.RS 4
-The network request
-.RE
-.PP
-\fIjson\&.mimeType\fR
-.RS 4
-The mimetype
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBmouseMove\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("mouseMove", function(webview, event));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when the pointer is moved\&.
-.PP
-\fIwebview\fR
-.RS 4
-The webview that emitted the signal
-.RE
-.PP
-\fIevent\fR
-.RS 4
-Same as buttonRelease
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBnavigation\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("navigation", function(webview, frame, request, action));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted before a new site is loaded, return true to stop the request\&.
-.PP
-\fIwebview\fR
-.RS 4
-The webview that emitted the signal
-.RE
-.PP
-\fIframe\fR
-.RS 4
-The frame that requires the navigation
-.RE
-.PP
-\fIrequest\fR
-.RS 4
-The network request
-.RE
-.PP
-\fIaction\fR
-.RS 4
-The navigation action
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBresource\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("resource", function(webview, frame, request, response));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted before a new resource is going to be loaded
-.PP
-\fIwebview\fR
-.RS 4
-The webview that emitted the signal
-.RE
-.PP
-\fIframe\fR
-.RS 4
-The frame that dispatched the request
-.RE
-.PP
-\fIrequest\fR
-.RS 4
-The network request
-.RE
-.PP
-\fIresponse\fR
-.RS 4
-The network response
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBstatusBarChange\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("statusBarChange", function(webview, data));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted before the status bar is updated, if the callback returns true dwb will not update the statusbar so it is possible to set the statusbar from the script\&.
-.PP
-\fIwebview\fR
-.RS 4
-The focused webview
-.RE
-.PP
-\fIdata\&.canGoBack\fR
-.RS 4
-Whether it is possible to navigate back in the webview
-.RE
-.PP
-\fIdata\&.canGoForward\fR
-.RS 4
-Whether it is possible to navigate forward in the webview
-.RE
-.PP
-\fIdata\&.isBookmarked\fR
-.RS 4
-Whether the site is bookmarked
-.RE
-.PP
-\fIdata\&.isQuickmarked\fR
-.RS 4
-Whether the site is quickmarked
-.RE
-.PP
-\fIdata\&.pluginsBlocked\fR
-.RS 4
-Whether plugins are blocked
-.RE
-.PP
-\fIdata\&.scriptsBlocked\fR
-.RS 4
-Whether scripts are blocked
-.RE
-.PP
-\fIdata\&.ssl\fR
-.RS 4
-SSL\-State of the page, can either be
-\fItrusted\fR,
-\fIuntrusted\fR
-or
-\fInone\fR
-.RE
-.PP
-\fIdata\&.type\fR
-.RS 4
-The type of the update, can be
-\fBstatus\fR
-and
-\fBuri\fR, status means that statusLabel und uriLabel need to be updated, uri means that only the uriLabel needs to be updated\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBtabButtonPress\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("tabButtonPress", function(webview, tabwidget, event));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when a button is pressed on a tabwidget, return true to prevent the default action
-.PP
-\fIwebview\fR
-.RS 4
-The webview which received the signal
-.RE
-.PP
-\fItabwidget\fR
-.RS 4
-The tabwidget
-.RE
-.PP
-\fIevent\fR
-.RS 4
-Same as buttonPress
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBtabFocus\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-signals\&.connect("tabFocus", function(webview, json));
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-Emitted when another tab gets focus, return true to stop the event
-.PP
-\fIwebview\fR
-.RS 4
-The new tab
-.RE
-.PP
-\fIjson\&.last\fR
-.RS 4
-The number of the previously focused tab
-.RE
-.RE
-.SH "ENUM OBJECTS"
-.sp
-Enum objects are objects that have only readonly properties, mapping gtk/webkit enums to javascript objects\&.
-.SS "ButtonContext"
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-const ButtonContext = {
-  document   : 1 << 1,
-  link       : 1 << 2,
-  image      : 1 << 3,
-  media      : 1 << 4,
-  selection  : 1 << 5,
-  editable   : 1 << 6
-};
-.fi
-.if n \{\
-.RE
-.\}
-.SS "ChecksumType"
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-const ChecksumType = {
-  md5     : 0,
-  sha1    : 1,
-  sha256  : 2
-};
-.fi
-.if n \{\
-.RE
-.\}
-.SS "ClickType"
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-const ClickType = {
-  click       : 4,
-  doubleClick : 5,
-  tripleClick : 6
-};
-.fi
-.if n \{\
-.RE
-.\}
-.SS "DownloadStatus"
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-const DownloadStatus = {
-  error       : \-1,
-  created     : 0,
-  started     : 1,
-  cancelled   : 2,
-  finished    : 3
-};
-.fi
-.if n \{\
-.RE
-.\}
-.SS "FileTest"
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-const FileTest = {
-  regular    : 1 << 0,
-  symlink    : 1 << 1,
-  dir        : 1 << 2,
-  executable : 1 << 3,
-  exists     : 1 << 4
-};
-.fi
-.if n \{\
-.RE
-.\}
-.SS "LoadStatus"
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-const LoadStatus = {
-  provisional       : 0,
-  committed         : 1,
-  finished          : 2,
-  firstVisualLayout : 3,
-  failed            : 4
-};
-.fi
-.if n \{\
-.RE
-.\}
-.SS "Modifier"
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-const Modifier = {
-  Shift     : 1 << 0,
-  Lock      : 1 << 1,
-  Control   : 1 << 2,
-  Mod1      : 1 << 3,
-  Mod2      : 1 << 4,
-  Mod3      : 1 << 5,
-  Mod4      : 1 << 6,
-  Mod5      : 1 << 7,
-  Button1   : 1 << 8,
-  Button2   : 1 << 9,
-  Button3   : 1 << 10,
-  Button4   : 1 << 11,
-  Button5   : 1 << 12,
-  Super     : 1 << 26,
-  Hyper     : 1 << 27,
-  Meta      : 1 << 28,
-  Release   : 1 << 30,
-  Modifier  : 0x5c001fff
-};
-.fi
-.if n \{\
-.RE
-.\}
-.SS "NavigationReason"
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-const NavigationReason = {
-  linkClicked     : 0,
-  formSubmitted   : 1,
-  backForward     : 2,
-  reload          : 3,
-  formResubmitted : 4,
-  other           : 5
-};
-.fi
-.if n \{\
-.RE
-.\}
-.SS "Modes"
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-const Modes = {
-  NormalMode  : 1<<0,
-  InsertMode  : 1<<1,
-  CommandMode : 1<<2
-};
-.fi
-.if n \{\
-.RE
-.\}
-.SS "Selection"
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-const Selection = {
-  primary   : 1,
-  clipboard : 2
-};
-.fi
-.if n \{\
-.RE
-.\}
-.SH "GLOBAL DATA"
-.sp
-Since all scripts share the same execution context, they are encapsulated in a function\&. To avoid conflicts with other scripts it is not allowed to set properties on the global object, i\&.e\&.
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-#!javascript
-
-// not allowed, the global object is readonly
-number = 0;
-io\&.print(number);     // undefined
-
-var number2 = 0;
-io\&.print(number2);    // 0
-
-// not allowed
-foo = function()
-{
-  io\&.print("foo");
-}
-foo();  // fails
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-For sharing data between scripts either signals or modules can be created\&.
-.SS "script and this"
-.sp
-In every script the variable \fBscript\fR refers to \fBthis\fR, the encapsulating function, it has the following properties and methods:
-.PP
-\fIscript\&.path (Object, read)\fR
-.RS 4
-The path of the script\&.
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid script.debug(Object params)\fR
-.RS 4
-.sp
-Same as io\&.debug but also prints additional information, e\&.g\&. if the object is an Error, this method will also print the corresponding source of the error\&.
-.RE
-.SH "MODULES"
-.sp
-With modules it is possible to share objects between scripts\&. Modules are defined with provide and loaded with require\&.
-.PP
-\fBDefining modules\fR. 
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-#!javascript
-
-provide("myModule", {
-  foo : 37,
-  doBar : function() {
-    io\&.print("bar");
-  }
-});
-provide("myOtherModule", {
-  act : function (arg) {
-    io\&.print(arg);
-  }
-});
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-\fBGetting some modules\fR. 
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-#!javascript
-
-require(["myModule", "myOtherModule"], function(myModule, myOtherModule) {
-  if (myModule\&.foo == 37)
-    myModule\&.doBar();
-
-  myOtherModule\&.act("foo");
-});
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-\fBGetting all modules\fR. 
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-#!javascript
-
-require(null, function(modules) {
-  if (modules\&.myModule\&.foo == 37)
-    modules\&.myModule\&.doBar();
-
-  modules\&.myOtherModule\&.act("foo");
-});
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-It is also possible to specify a path in the name array\&. The name then follows the format \fBname!path\fR:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-#!javascript
-
-require(["foo!/path/to/foo"], function(foo) {
-  io\&.print(foo\&.bar); // 37
-});
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-\fB/path/to/foo\fR. 
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-provide("foo", { bar : 37 });
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-The resolution chain is as follows, first all modules defined with \fBprovide\fR and module names requested by \fBrequire\fR are stored\&. If all scripts have been loaded the requirements are resolved\&. If a requirement contains a path and the module isn\(cqt defined yet the module will be loaded, if it is already defined the path is ignored and the stored module will be resolved:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-#!javascript
-
-require(["foo!/path/to/foo"], function(foo) {
-  io\&.print(foo\&.bar); // 42
-});
-provide("foo", { bar : 42 });
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-#!javascript
-
-require(["foo"], function(foo) {
-  io\&.print(foo); // undefined
-});
-require(["foo!/path/to/foo"]);
-
-require(["foo"], function(foo) {
-  io\&.print(foo); // { bar : 37 }
-});
-.fi
-.if n \{\
-.RE
-.\}
-.SH "EXTENSIONS"
-.sp
-\fBdwb\fR provides the possibility to load extensions\&. It is recommended to implement javascript\-userscripts as an extension to have consistent configuration locations for scripts\&. One advantage of extension also is that they can be loaded/unloaded on the fly\&.
-.SS "Prepackaged extensions"
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBformfiller\fR
-.RS 4
-.sp
-An extension that gets form data and fills forms with previously saved data\&.
-.PP
-\fBConfiguration options\fR
-.RS 4
-.PP
-\fIformData\fR
-.RS 4
-A path to a file where formdata will be saved, the default path is
-\fB$XDG_CONFIG_HOME/dwb/forms\fR
-.RE
-.PP
-\fIscGetForm\fR
-.RS 4
-Shortcut that gets and saves form data, the default value is
-\fBefg\fR
-.RE
-.PP
-\fIscFillForm\fR
-.RS 4
-Shortcut that fills a form, the default value is
-\fBeff\fR
-.RE
-.PP
-\fIuseGPG\fR
-.RS 4
-Whether to use gpg2 to encrypt the formData file with a password\&.
-.RE
-.PP
-\fIGPGOptEncrypt\fR
-.RS 4
-Additional options that will be passed to gpg2 for encryption, the default gpg2 options are: \-\-passphrase <password> \-\-batch \-\-no\-tty \-\-yes \-c \-\-output <formData> default value:
-\fB""\fR
-.RE
-.PP
-\fIGPGOptDecrypt\fR
-.RS 4
-Additional options that will be passed to gpg2 for decryption, the default gpg2 options are \-\-passphrase <password> \-\-batch \-\-no\-tty \-\-yes \-d <formData> default value:
-\fB""\fR
-.RE
-.PP
-\fIkeepPassword\fR
-.RS 4
-Whether to save the gpg password in memory, if set to false the user will be prompted for the password every time a form is filled or new data is saved, default value:
-\fBtrue\fR
-.RE
-.PP
-\fIkeepFormdata\fR
-.RS 4
-If useGPG is enabled and this value is set to true the complete formdata will be kept in memory, if set to false gpg2 will be called every time a form is filled, default value:
-\fBfalse\fR
-.RE
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBperdomainsettings\fR
-.RS 4
-.sp
-An extension that can be used for per\-domain\-settings\&. Valid settings are the properties of WebKitWebSettings but in camelcase, see http://webkitgtk\&.org/reference/webkitgtk/unstable/WebKitWebSettings\&.html for details\&.
-.PP
-\fBConfiguration options\fR
-.RS 4
-.PP
-\fIdomains\fR
-.RS 4
-Settings applied based on the effective second level domain
-.RE
-.PP
-\fIhosts\fR
-.RS 4
-Settings applied based on host name, this option is an object of the format
-.RE
-.PP
-\fIuris\fR
-.RS 4
-Settings applied based on the uri, this option is an object of the format
-.RE
-.PP
-\fIdefaults\fR
-.RS 4
-Default settings, for each setting in domains, hosts and uris a default\-value should be specified
-.RE
-.RE
-.PP
-\fBExample configuration\fR
-.RS 4
-Example using extensions\&.load:
-.RE
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-extensions\&.load("perdomainsettings", {
-  domains : {
-     "example\&.com" : {
-          "enablePlugins"  : true
-     },
-     "example\&.uk\&.com" :  {
-          "enablePlugins"  : true,
-          "enableScripts"  : false
-     }
-  },
-  hosts : {
-     "www\&.example1\&.com" :  {
-          "autoLoadImages" : true
-     }
-  },
-  uris : {
-     "http://www\&.example2\&.com/login\&.php" :  {
-          "autoLoadImages" : false
-     }
-  },
-  defaults : {
-     "enablePlugins"   : false,
-     "autoLoadImages"  : false,
-     "enableScripts"   :  true
-  }
-});
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBrequestpolicy\fR
-.RS 4
-.sp
-Extension that blocks requests from thirdparty domains with whitelisting support, either permanently or just for the session\&. It is also possible to block requests from certain domains on all sites, they have highest precedence and will also be blocked on sites where thirdparty requests are allowed in general\&.
-.PP
-\fBConfiguration options\fR
-.RS 4
-.PP
-\fIshortcut\fR
-.RS 4
-Shortcut to block / allow requests, default
-\fB"erp"\fR
-.RE
-.PP
-\fIunblockCurrent\fR
-.RS 4
-Shortcut to unblock always blocked requests, shows only domains from the current site, default
-\fB"erC"\fR
-.RE
-.PP
-\fIunblockAll\fR
-.RS 4
-Shortcut to unblock always blocked requests, shows all blocked domains, default
-\fB"erA"\fR
-.RE
-.PP
-\fIwhiteList\fR
-.RS 4
-A path to the whitelisting file, default is
-\fB$XDG_CONFIG_HOME/dwb/<profile>/requestpolicy\&.json\fR
-.RE
-.PP
-\fIautoreload\fR
-.RS 4
-Whether to automatically reload the website after the persistentList has changed, default
-\fBfalse\fR
-.RE
-.PP
-\fInotify\fR
-.RS 4
-Whether to notify about blocked request, default
-\fBfalse\fR
-.RE
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBunique_tabs\fR
-.RS 4
-.sp
-Extension that allows to remove duplicate tabs or avoids duplicate tabs automatically\&.
-.PP
-\fBConfiguration options\fR
-.RS 4
-.PP
-\fIshortcutRemoveDuplicates\fR
-.RS 4
-Shortcut that removes duplicate tabs, default
-\fBnull\fR
-.RE
-.PP
-\fIcommandRemoveDuplicates\fR
-.RS 4
-Command that remove s duplicate tabs, default
-\fBut_remove_duplicates\fR
-.RE
-.PP
-\fIautoFocus\fR
-.RS 4
-Autofocus a tab if an url is already opened, if the url would be loaded in a new tab the new tab is closed\&. Setting this to true makes commandRemoveDuplicates and shortcutRemoveDuplicates obsolete because there will be no duplicate tabs\&. Default value:
-\fBtrue\fR
-.RE
-.PP
-\fIshortcutToggleAutoFocus\fR
-.RS 4
-Shortcut that enables/disables autofocus, default
-\fBnull\fR
-.RE
-.PP
-\fIcommandToggleAutoFocus\fR
-.RS 4
-Command that enables/disables autofocus, default
-\fBut_toggle_autofocus\fR
-.RE
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBuserscripts\fR
-.RS 4
-.sp
-Extension that loads userscripts and injects them into websites, this extension is mostly greasemonkey compatible\&. Scripts can be loaded by either passing an array of paths to extensions\&.load or by putting scripts into $XDG_CONFIG_HOME/dwb/scripts/\&.
-.PP
-\fBConfiguration options\fR
-.RS 4
-The only configuration option is an array of paths to scripts
-.RE
-.PP
-\fBExample configuration\fR
-.RS 4
-Example using extensions\&.load:
-.RE
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-extensions\&.load("userscripts", [ "/path/to/script1", "/path/to/script2" ]);
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.SS "Using extensions"
-.sp
-Extensions can be loaded by an userscript
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-#!javascript
-
-extensions\&.load("extension_1");
-extensions\&.load("extension_2", {
-  configProp_1 : 22,
-  configProp_2 : "val2"
-});
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-To load/unload extensions on the fly \fBextensions\&.bind\fR can be used:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-#!javascript
-
-var myConfig = {
-  prop_1 : 37,
-  prop_2 : true,
-  prop_3 : "foo"
-};
-
-
-extensions\&.bind("myExtension", "Control m", {
-  command : "toggleMyExtension",
-  config : myConfig,
-  load : false
-});
-
-extensions\&.bind("mySecondExtension", "Control M");
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-The default searchpaths for extensions are $XDG_DATA_HOME/dwb/extensions/ and /usr/share/dwb/extensions/\&.
-.SS "Methods"
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid extensions.bind(String name, String shortcut, [Object options])\fR
-.RS 4
-.sp
-Bind an extension to a shortcut, the shortcut enables/disables the extension\&.
-.PP
-\fIname\fR
-.RS 4
-Name of the extension
-.RE
-.PP
-\fIshortcut\fR
-.RS 4
-Name of the extension
-.RE
-.PP
-\fIoptions\fR
-.RS 4
-An optional object with options where possible options are
-.PP
-options\&.load
-.RS 4
-Whether to load the extension on startup, default true
-.RE
-.PP
-options\&.config
-.RS 4
-Config passed to extensions\&.load
-.RE
-.PP
-options\&.command
-.RS 4
-Command that can be used on command line
-.RE
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid extensions.disableAll()\fR
-.RS 4
-.sp
-Disables all extensions\&.
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBBoolean extensions.load(String name, [Object config])\fR
-.RS 4
-.sp
-Loads an extension
-.PP
-\fIname\fR
-.RS 4
-Name of the extension
-.RE
-.PP
-\fIconfig\fR
-.RS 4
-The config for the script, if omitted the config is read from $XDG_CONFIG_HOME/dwb/extensionrc, optional
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-True if the extension was loaded
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBBoolean extensions.toggle(String name, [Object config])\fR
-.RS 4
-.sp
-Toggles an extension
-.PP
-\fIname\fR
-.RS 4
-Name of the extension
-.RE
-.PP
-\fIconfig\fR
-.RS 4
-The config for the extension\&. optional
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-True if the extension was loaded, false if it was unloaded\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBBoolean extensions.unload(String name)\fR
-.RS 4
-.sp
-Unloads an extension
-.PP
-\fIname\fR
-.RS 4
-Name of the extension
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-True if the extension was unloaded
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid extensions.error(String name, String message|Error e, [String message])\fR
-.RS 4
-.sp
-Print an error message and call stack to stderr\&.
-.PP
-\fIname\fR
-.RS 4
-Name of the extension
-.RE
-.PP
-\fImessage|e\fR
-.RS 4
-The error message or an Error
-.RE
-.PP
-\fImessage\fR
-.RS 4
-If the second parameter is an Error, an optional message can be specified\&.
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBObject extensions.getConfig(Object config, Object defaultConfig)\fR
-.RS 4
-.sp
-Parses config with given default config\&. Checks for each property of defaultConfig if the corresponding property of config is valid\&.
-.PP
-\fIconfig\fR
-.RS 4
-The configuration object
-.RE
-.PP
-\fIdefaultConfig\fR
-.RS 4
-The default configuration for the extension
-.RE
-.PP
-\fIreturns\fR
-.RS 4
-The parsed config
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid extensions.message(String name, String message)\fR
-.RS 4
-.sp
-Print a consistent message to stderr
-.PP
-\fIname\fR
-.RS 4
-Name of the extension
-.RE
-.PP
-\fImessage\fR
-.RS 4
-The message
-.RE
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBvoid extensions.warning(String name, String message)\fR
-.RS 4
-.sp
-Print a consistent warning to stderr
-.PP
-\fIname\fR
-.RS 4
-Name of the extension
-.RE
-.PP
-\fImessage\fR
-.RS 4
-The warning message
-.RE
-.RE
-.SS "Writing extensions"
-.sp
-The default searchpath for extensions is \fB$XDG_DATA_HOME/dwb/extensions\fR and \fBSHARE_DIR/dwb/extensions\fR where SHARE_DIR being the share directory of the installation, most likely /usr/share\&.
-.sp
-The configuration for extensions is in \fB$XDG_CONFIG_HOME/dwb/extensionrc\fR and should return a javascript object\&.
-.sp
-Every extension must implement one function named init that takes one argument, the config for the extension\&. The function should return true if the extension was successfully loaded, false otherwise\&. Every extension also may implement a function end that will be called when an extension is unloaded\&. If an extension registers to signals and binds shortcuts the extension should unregister all signals and unbind all shortcuts in this function\&. init and end should be returned from the extension\&.
-.sp
-Additionally the returned object can also have an defaultConfig\-property, the value will be passed to extensions\&.getConfig before calling the init function\&.
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBExample\fR
-.RS 4
-.sp
-A extension called \fBfoobar\fR in \fB$HOME/\&.local/share/dwb/extensions/foobar\fR:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-function foo(val) {
-  \&.\&.\&.\&.
-}
-function bar(val) {
-  \&.\&.\&.\&.
-}
-function loadStatusCallback(w) {
-  \&.\&.\&.
-}
-return {
-  defaultConfig : { foo : 37 },
-
-  init : function (config) {
-    if (config\&.foo > 36) {
-      bar(config\&.foo);
-      foo(config\&.bar);
-      bind("XX", bar, "dobar");
-      signals\&.connect("loadStatus", loadStatusCallback);
-      return true;
-    }
-
-    return false;
-  },
-
-  end : function () {
-    unbind("dobar");
-    signals\&.disconnectByFunction(loadStatusCallback);
-    return true;
-  }
-};
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBExample extensionrc\fR
-.RS 4
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-return {
-  foobar : { bar : "X", foo : 37 }, // config for extension foobar
-  barfoo : {  }                     // config for extension barfoo
-
-};
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBPublic api\fR
-.RS 4
-.sp
-Extensions that provide a public api can use provide or replace using the name of the extension\&.
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-var myPublicFunction = function()
-{
-  \&.\&.\&.
-};
-
-return {
-  init : function(config)
-  {
-    provide("myExtensionName",
-    {
-      config : config,
-      method : myPublicFunction
-    });
-  },
-  end : function()
-  {
-    replace("myExtensionName");
-  }
-};
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.SH "SEE ALSO"
-.sp
-\fBdwb\fR(1) \fBdwbem\fR(1)
diff --git a/api/jsapi.7.txt b/api/jsapi.7.txt
deleted file mode 100644
index 52fc211e..00000000
--- a/api/jsapi.7.txt
+++ /dev/null
@@ -1,2293 +0,0 @@
-// See COPYING for copyright and license details
-
-// vim: set ft=asciidoc:
-
-= dwb-js(7) =
-:doctype: manpage
-
-
-== NAME ==
-dwb-js - dwb's javascript api documentation
-
-
-== DESCRIPTION ==
-dwb provides a javascript api that can be used to write userscripts or
-extensions for dwb. 
-
-== GETTING STARTED == 
-Scripts that use the javascript api must be located in
-*$XDG_CONFIG_HOME/dwb/userscripts* like any other script. 
-Scripts that use the javascript api must either start with 
-
--------
-#!javascript
--------
-
-or with 
-
--------
-//!javascript
--------
-
-All native javascript methods can be used in scripts, however there are
-limitations:  
-
-* The execution context of userscripts is completely seperated from the web
-execution context. Due to security concerns it is not possible to communicate
-with the web execution context, it is only possible to inject scripts into the
-web context.
-* In contrast to the global window object in the web execution context, 
-the global object is a readonly object, i.e. it is not possible to set
-properties on the global object, see also *Global data* for details.
-
-== Global ==
-
-=== Properties
-
-_global (Object, read)_;; Refers to the global object
-_session (SoupSession, read)_;; The webkit session
-
-=== Methods ===
-
-
-==== Boolean bind(String shortcut, Function callback, [String name])
-
-****
-
-Bind a javascript function to a shortcut. This is the preferred method of
-binding keys to shortcuts since the shortcut is evaluated using the native
-method, but also the keyPress-signal can be used to bind shortcuts. 
-
-_shortcut_;; A shortcut shortcut, will be parsed the same way as if set in
-dwb:keys
-_callback_;; Callback function that will be called when the shortcut is pressed
-_name_;; A name that identifies the function on command line, optional
-_returns_;; true if the function was bound successfully
-****
-
-==== Boolean execute(String command)
-
-****
-Executes a dwb command
-
-_command_;; a dwb command to execute, will be parsed the same way as if executed
-from commandline
-_returns_;; true if execution was successful
-**** 
-
-==== Boolean exit()
-****
-
-Exit dwb, must be called if the script is running from commandline. 
-****
-
-
-==== Object include(String path, [Boolean global])
-****
-
-Includes a file. Note that there is only one context, all scripts are
-executed in this context. Included files are not visible in other scripts unless
-true is passed as second parameter. 
-
-_path_;; Path to a file to include
-_global_;; Whether to include the script into the global scope, optional
-_returns_;; The return value of the included file
-****
-
-NOTE: Scripts included with include are either visible in the global scope or
-invisible, even in the including script. To use an included script it can return
-an object with its public objects: 
-
-[source,javascript]
----------------------------------
-// included script 
-
-var private = 37;
-return {
-  getPrivate : function () {
-    return private;
-  }
-};
-
-// Scripts that includes the above
-var i = include("/path/to/script");
-var p = i.getPrivate();               // 37
----------------------------------
-
-or define a module that can be shared: 
-
-[source,javascript]
----------------------------------
-// included script 
-
-var private = 37;
-provide("foo", {
-    getPrivate : function() {
-        return private;
-    }
-});
-
-// Scripts that includes the above
-var i = include("/path/to/script");
-require(["foo"], function(foo) {
-    var bar = foo.getPrivate();               // 37
-})
----------------------------------
-
-
-==== void provide(String name, Object module)
-****
-Defines a module that can be used in other scripts, see MODULES for details.
-
-_name_;; Name of the module
-_module_;; The module
-****
-
-==== void replace(String name, Object module)
-****
-Same as provide but replaces the module if it was already defined.
-
-_name_;; Name of the module
-_module_;; The module, if omitted the module will be deleted, all references to
-that module will reference an empty object afterwards, optional.
-****
-
-==== void require(Array names, Function callback)
-****
-Load modules defined with provide.
-
-_names_;; An array of module names or null to get all modules, a module name can
-also contain a path, the path must be seperated with a *!* from the module name,
-see also MODULES for details.
-_callback_;; A callback function that is called after initialization of all
-scripts and modules. The parameters of the callback function correspond to the
-names array. If *names* is null the function is called with one parameter that
-contains all modules, see also MODULES for examples.
-****
-
-==== void sendRequest(String uri, Function callback, [String method])
-****
-
-Sends a http-request. 
-
-_uri_;; The uri the request will be sent to.
-_callback_;; A callback that will be called when the request is finished, the
-callback has 2 parameters, the first will be an object that contains body and
-headers, the second the associated SoupMessage.
-_method_;; The http request method, default GET, optional.
-****
-
-==== Object sendRequestSync(String uri, [String method])
-****
-
-Sends a http-request synchronously. 
-
-_uri_;; The uri the request will be sent to.
-_method_;; The http request method, default GET, optional.
-_returns_;; Object that contains the response body, the response headers and
-the http status code of
-the request. 
-****
-
-==== void tabComplete(String label, Array items, Function callback, [Boolean readonly])
-****
-
-Initiates tab completion.
-
-_label_;; The command line label
-_items_;; An array of objects, each object can have 2 properties, left which
-will be the left completion label and right which will be the right completion
-label.
-_callback_;; Callback function, the first argument will be the returned string
-from the url bar.
-_readonly_;; Whether the items are readonly, default false, optional.
-****
-
-==== Number timerStart(Number interval, Function func)
-****
-
-Executes a function repeatedly until the function returns false or
-timerStop is called on the id returned from this function
-
-_interval_;; Interval in milliseconds
-_func_;; Function to execute
-_returns_;; An id that can be passed to timerStop
-****
-
-==== Number timerStop(Number id)
-****
-
-Stops a timer started by timerStart
-
-_id_;; The id returned from timerStart
-_returns_;; true if the timer was stopped
-****
-
-==== Number unbind(Function func|String name)
-****
-
-Unbind a shortcut that was previously bound with bind
-
-_func_ or _name_;; Either the function or the optional name passed to bind.
-_returns_;; true if the function was unbound
-****
-
-
-== GLOBAL OBJECTS ==
-
-=== data ===
-The data object can be used to determine internally used data securely. All
-properties are readonly Strings.
-
-****
-_data.bookmarks_;; Bookmark file 
-_data.cacheDir_;; Cache directory 
-_data.configDir_;; Config directory 
-_data.cookies_;; Cookie file 
-_data.cookiesWhitelist_;; Whitelist for persistent cookies 
-_data.customKeys_;; Custom keyboard shortcuts 
-_data.history_;; History file 
-_data.keys_;; Shortcuts configuration file 
-_data.pluginsWhitelist_;; Whitelist for the plugin blocker
-_data.profile_;; Profile which will be *default* unless another profile is specified on command line
-_data.quickmarks_;; Quickmark file 
-_data.scriptWhitelist_;; Whitelist for scripts
-_data.session_;; File with stored sessions for this profile
-_data.sessionCookiesWhitelist_;; Whitelist for session cookies
-_data.settings_;; Settings configuration file
-_data.searchEngines_;; Searchengines 
-****
-
-
-=== io ===
-The io object implements methods for input and output. 
-
-==== void io.debug([Object detail])
-****
-
-Prints a debug message and the call stack to stderr. 
-
-_detail_;; Message details, optional
-_detail.message_;; The message to show, optional
-_detail.error_;; An Error object, optional 
-_detail.arguments_;; Arguments, optional
-****
-
-==== Array io.dirNames(String path)
-****
-
-Get directory entries.
-
-_path_;; A path to a directory
-_returns_;; An array with the directory names
-****
-
-==== void io.error(String text)
-****
-
-Shows an error message in the browser window.
-
-_text_;; The message to show
-****
-
-==== void io.notify(String text)
-****
-
-Shows a message in the browser window.
-
-_text_;; The message to show
-****
-
-==== void io.print(String text, [String stream])
-****
-
-Print text to stdout or stderr 
-
-_text_;; the text to print
-_stream_;; pass "stderr" to print to stderr, optional
-****
-
-==== String io.prompt(String text, [Boolean visible])
-****
-
-Gets user input synchronously.
-
-_text_;; The message for the prompt
-_visible_;; Whether the chars should be visible, pass false for a password
-prompt, default true, optional
-_returns_;; The text that was entered or null
-****
-
-
-==== String io.read(String path)
-****
-
-Read from a file.
-
-_path_;; Path to a file that should be read
-_returns_;; A string with the file content
-****
-
-==== Boolean io.write(String path, String mode, String text)
-****
-
-Write to a file
-
-_path_;; Path to a file to write to
-_mode_;; Either "a" to append to the file, or "w" to strip the file or
-create a new file.
-_text_;; The text that should be written to the file
-_returns_;; true if writing was successful
-****
-
-=== system ===
-
-The system object implements system methods.
-
-==== Boolean system.fileTest(String path, FileTest flags)
-****
-
-Checks for FileTest flags on a file.
-
-_path_;; Path to a file to check
-_flags_;; The flags to test
-_returns_;; true if any of the test on the flags is true
-****
-
-==== String system.getEnv(String name) 
-****
-
-Get a system environment variable
-
-_name_;; Name of the variable
-_returns_;; The variable or null if the variable wasn't found
-****
-
-==== Boolean system.mkdir(String path, Number mode)
-****
-
-Creates a directory and all parent directories.
-
-_path_;; Path to create
-_mode_;; The permissions the directory will get
-_returns_;; true if creation was successful or directory already existed 
-****
-
-==== Deferred system.spawn(String command, [Function stdin], [Function stderr])
-****
-
-Executes a shell command using the default search path
-
-_command_;; The command to execute
-_stdout(String)_;; Callback function for stdin, pass null if only stderr is
-needed, optional
-_stderr(String)_;; Callback function for stderr, optional
-_returns_;; A deferred, it will be resolved if the child exits
-normally, it will be rejected if the child process exits abnormally, the first
-parameter of the reject function will be the status code of the child process. 
-****
-
-==== Object system.spawnSync(String command)
-****
-
-Executes a shell command synchronously using the default search path
-
-_command_;; The command to execute
-_returns_;; An object that contains stdout, stderr and status.
-****
-
-=== tabs ===
-The tabs object implements methods and properties to get webview objects. 
-
-
-_tabs.current (webview, read)_;; The currently focused webview
-_tabs.length (Number, read)_;; Total number of tabs
-_tabs.number (Number, read)_;; Number of the currently focused tab
-
-
-==== webview tabs.nth(Number n) 
-****
-
-Gets the webview object of the nth tab
-
-_n_;; Number of the tab
-_returns_;; The corresponding webview
-****
-
-=== util ===
-
-The util object implements helper methods.
-
-==== String util.getBody(Function func) 
-****
-
-Gets the body of a function, useful for scripts that will be injected into
-sites. 
-
-_func_;; A function 
-_returns_;; The body of the function as a string
-****
-
-==== Number util.getMode()
-****
-
-Gets the the current mode.
-
-_returns_;; The mode, see Modes for possible modes.
-****
-
-==== String util.domainFromHost(String hostname)
-****
-
-Gets the base domain name from a hostname where the base domain name is the
-effective second level domain name, e.g. for www.example.com it will be
-example.com, for www.example.co.uk it will be example.co.uk.
-
-_hostname_;; a hostname
-_returns_;; the base domain 
-****
-
-==== String util.getSelection()
-****
-
-Get selected text from the focused webview.
-
-_returns_;; The selection or null if no text was selected.
-****
-
-==== String util.markupEscape(String text)
-****
-
-Escapes text for usage with pango markup.
-
-_text_;; A text to escape
-_returns_;; The escaped text or 'null';
-****
-
-dwb also adds additional methods to builtin objects 
-
-==== void Object.forEach(Function func(String key, Object value, Object this))
-****
-
-Executes a function for each enumarable property of this similar to
-Array.forEach.
-
-_func_;; The function to execute
-_key_;; The property name
-_value_;; The property value
-_this_;; The object forEach is called on
-****
-
-==== Number Array.fastIndexOf(Object object)
-****
-
-This method is basically the same as Array.indexOf but without type checking.
-
-_object_;; The object to search for
-_returns_;; The index in the array or -1 if the Object wasn't found.
-****
-
-==== Number Array.fastLastIndexOf(Object object)
-****
-
-This method is basically the same as Array.lastIndexOf but without type checking.
-
-_object_;; The object to search for
-_returns_;; The index in the array or -1 if the Object wasn't found.
-****
-
-==== void Function.debug([Object scope])
-****
-
-A wrapper method for debugging callbacks, especially useful if it is combined
-with script. 
-
-_scope_;; *script* or *this*, optional
-_returns_;; A new function that calls script.debug on errors.
-****
-
-=== clipboard ===
-
-==== void clipboard.get(Selection selection, [Function callback])
-****
-
-Gets the X11 clipboard.
-
-_selection_;; The Selection to get
-_callback_;; If a callback function is used the clipboard will be fetched
-asynchronously, the first parameter will be the content of the clipboard, else
-it will be fetched synchronously
-_returns_;; If no callback was provided it returns the text content of the
-clipboard.
-****
-
-==== void clipboard.set(Selection selection, String text)
-****
-
-Sets the X11 clipboard.
-
-_selection_;; The Selection to set
-_text_;; Text that will be stored in the clipboard.
-****
-
-=== gui === 
-
-Most gtk-widgets can be accessed from scripts, an overview of the layout can be
-found under link:https://portix.bitbucket.org/dwb/resources/layout.html[]. 
-
-_gui.window (GtkWindow, read)_;; The main window.
-_gui.mainBox (GtkBox, read)_;;   The the main container, child of *gui.window*. 
-_gui.tabBox (GtkBox, read)_;;   The box used for tab labels, child of *gui.mainBox*.
-_gui.contentBox (GtkBox, read)_;;   The box used for the main content, it contains all
-webviews, child of *gui.mainBox*.
-_gui.statusWidget (GtkEventBox, read)_;; The outmost statusbar widget, used for setting
-the statusbars colors, child of *gui.mainBox*. 
-_gui.statusAlignment (GtkAlignment, read)_;; Used for the statusbar alignment, child
-of *gui.statusWidget*. 
-_gui.statusBox (GtkBox, read)_;; The box that contains the statusbar widgets,
-grandchild of *gui.statusAlignment*.
-_gui.messageLabel (GtkLabel, read)_;; Label used for notifications, first child of
-*gui.statusBox*.
-_gui.entry (GtkEntry, read)_;; The entry, second child of *gui.statusBox*.
-_gui.uriLabel (GtkLabel, read)_;; Label used for displaying uris, third child of *gui.statusBox*.
-_gui.statusLabel (GtkLabel, read)_;; Label used for status information, fourth child of *gui.statusBox*.
-
-
-=== Deferred === 
-
-Deferred objects can be used to manage asynchronous operations. It can trigger a
-callback function when an asynchrounous operation has finished, and allows
-chaining of callbacks. 
-Deferred basically has 2 callback chains, a _done_-chain and a _fail_-chain.
-If a asynchronous operation is successful the deferred should be resolved and
-the done callback chain of the deferred is called. 
-If a asynchronous operation fails the deferred should be rejected and
-the fail callback chain of the deferred is called. 
-
-
-Deferreds implement the following methods: 
-
-==== void Deferred.always(Function callback)
-****
-
-Registers a function for then done and fail chain.
-
-_callback_;; A callback function that will be called when the Deferred is
-resolved or rejected. If the function returns a deferred the original deferred will be replaced with
-the new deferred.
-_returns_;; A new deferred that can be used to chain callbacks. 
-****
-
-==== void Deferred.done(Function callback)
-****
-
-Registers a function for the done-chain.
-
-_callback_;; A callback function that will be called when the Deferred is
-resolved. If the function returns a deferred the original deferred will be replaced with
-the new deferred.
-_returns_;; A new deferred that can be used to chain callbacks. 
-****
-
-==== Deferred Deferred.fail(Function callback)
-****
-
-Registers a function for the fail-chain.
-
-_callback_;; A callback function that will be called when the deferred is
-rejected. If the function returns a deferred the original deferred will be replaced with
-the new deferred.
-_returns_;; A new deferred that can be used to chain callbacks. 
-****
-
-==== Deferred Deferred.reject(arguments)
-****
-
-Rejects a deferred, the fail-chain is called when a deferred is rejected. 
-
-_arguments_;; Arguments passed to the _fail_ callbacks.
-****
-
-==== void Deferred.resolve(arguments)
-****
-
-Resolves a deferred, the done-chain is called when a deferred is resolved. 
-
-_arguments_;; Arguments passed to the _done_ callbacks.
-****
-
-==== Deferred Deferred.then(Function ondone, Function onfail)
-****
-
-Registers a function for the done and fail chain.
-
-_ondone_;; A callback function that will be called when the deferred is
-resolved. If the function returns a deferred the original deferred will be replaced with
-the new deferred.
-_onfail_;; A callback function that will be called when the deferred is
-rejected. If the function returns a deferred the original deferred will be replaced with
-the new deferred.
-_returns_;; A new deferred that can be used to chain callbacks. 
-****
-
-Deferred also implements a static method: 
-
-==== Value Deferred.when(Value value, Function ondone, Function onfail)
-****
-
-Static method that can be used for synchronous and asynchronous operations. If
-if *value* is a Deferred *ondone* is called when the Deferred is resolved and
-*onfail* is called if the Deferred is rejected, otherwise ondone is called 
-and value is the first parameter of the callback.
-
-_value_;; A Deferred or a value.
-_ondone_;; Callback function.
-_onfail_;; Callback function.
-_returns_;; The value.
-****
-
-Simple usage of a deferred:
-
-[source,javascript]
----------------------------------
-function loadUri(uri) {
-    var d = new Deferred();
-    tabs.current.loadUri(uri, function(wv) {
-        if (wv.loadStatus == LoadStatus.finished) 
-        {
-            d.resolve("Finished");
-            return true;
-        }
-        else if (wv.loadStatus == LoadStatus.failed) 
-        {
-            d.reject("Failed");
-            return true;
-        }
-    });
-    return d;
-}
-
-loadUri("http://www.example.com").then(
-    function(response) {
-        io.print(response); // Finished
-    }, 
-    function(response) {
-        io.print(response); // Failed
-    }
-);
----------------------------------
-
-Chaining of a deferred: 
-
-[source,javascript]
----------------------------------
-function foo() 
-{
-    var d = new Deferred();
-    timerStart(2000, function() {
-        d.reject("rejected");
-    });
-    return d;
-}
-
-function onResponse(response) 
-{
-    io.print(response);
-}
-
-// Will print "rejected" twice to stdout after 2 seconds
-foo().fail(onResponse).fail(onResponse);
----------------------------------
-
-Note that if the deferred is rejected only the fail chain is called, when it is
-resolved only the done chain is called. 
-[source,javascript]
----------------------------------
-function foo() 
-{
-    var d = new Deferred();
-    timerStart(2000, function() {
-        d.reject("rejected");
-        // Already rejected, will not execute the done chain
-        d.resolve("rejected");
-    });
-    return d;
-}
-
-function onResponse(response) 
-{
-    io.print(response);
-}
-
-// Only the fail will be executed
-
-foo().fail(onResponse).done(onResponse);
-foo().done(onResponse).fail(onResponse);
----------------------------------
-
-Changing the deferred in a callback chain:
-
-[source,javascript]
----------------------------------
-function foo(message) 
-{
-    var d = new Deferred();
-    timerStart(2000, function() {
-        d.resolve(message);
-    });
-    return d;
-}
-function callback1(response) 
-{
-    io.print(response); // Prints "foo" after 2 seconds
-
-    // Return a new Deferred, will replace the old one.
-    return foo("bar");
-}
-function callback2(response) 
-{
-    io.print(response); // Prints "bar" after 4 seconds
-}
-
-foo("foo").done(callback1).done(callback2);
----------------------------------
-
-Using Deferred.when
-
-[source,javascript]
----------------------------------
-function asyncOperation() {
-    var d = new Deferred();
-    .... 
-    return d;
-}
-function syncOperation()
-{
-    var result = {};
-    .... 
-    return result;
-}
-Deferred.when(asyncOperation(), function() {...});
-Deferred.when(syncOperation(), function() {...});
----------------------------------
-
-=== settings ===
-
-Readonly object that can be used to query dwb's current settings, all settings
-can also be used in camelcase, to modify settings *execute* can be used.
-
-====
-[source,javascript]
----------------------------------
-if (settings.enablePrivateBrowsing == true)
-    execute("set enable-private-browsing false");
----------------------------------
-====
-
-
-== WEBKIT OBJECTS ==
-
-All webkit objects correspond to gobject objects, i.e. they have the same
-properties, but the javascript properties are all camelcase. 
-For example, a WebKitWebView has the property *zoom-level*, the corresponding
-javascript property is *zoomLevel*:
-
-====
-[source,javascript]
----------------------------------
-var webview = tabs.current
-webview.zoomLevel = webview.zoomLevel * 2;
----------------------------------
-====
-
-To check if an object is derived from GObject the instanceof operator can be
-used: 
-
-====
-[source,javascript]
----------------------------------
-if (myObject instanceof GObject) 
-{
-  ...
-}
----------------------------------
-====
-
-=== General methods
-
-The following methods are implemented by all Objects derived from GObject
-
-==== void object.blockSignal(Number signalid)
-****
-
-Blocks emission of a gobect signal.
-
-_signalid_;; The signalid returned from *object.connect*
-****
-
-==== Number object.connect(String name, Function callback, [Boolean after]) 
-****
-
-Connect to a gobject-signal, note that all signals are connected using the 
-_signal::_- or with _notify::_-prefix. If connecting to a signal the 
-_signal::_-prefix must be omitted. The callback function will have the
-same parameters as the GObject signal callback, however some parameters may be
-undefined if they cannot be converted to javascript objects. 
-All signal handlers are executed after dwb's default handler.
-
-_name_;; The signal name to connect to.
-_callback_;; Callback function that will be called when the signal is emitted.
-_after_;; Whether to install the handler after the default handler, default
-false.
-_returns_;; The signal id of the signal.
-****
-
-==== Number object.connectBlocked(String name, Function callback, [Boolean after]) 
-****
-
-Connect to a gobject-signal but block the emission of the own callback during
-execution of the callback, useful if the object is connected to a notify event
-and the the property is changed in the callback function. 
-
-_name_;; The signal name to connect to.
-_callback_;; Callback function that will be called when the signal is emitted.
-_after_;; Whether to install the handler after the default handler, default
-false.
-_returns_;; The signal id of the signal.
-****
-
-==== Boolean object.disconnect(Number id) 
-****
-
-Disconnect from a gobject-signal.
-
-_id_;; The signal id obtained from connect
-_returns_;; true if the signal was disconnected
-****
-
-==== Number object.notify(String name, Function callback, [Boolean after]) 
-****
-
-Wrapper function for property-change notification, the same as 
-_object.connect("notify::" +  name, callback, after);_.
-
-_name_;; The property name to connect to, the name can also be in camelcase.
-_callback_;; Callback function that will be called when the property changes.
-_after_;; Whether to install the handler after the default handler, default
-after.
-_returns_;; The signal id of the signal.
-****
-
-==== Number object.notifyBlocked(String name, Function callback, [Boolean after]) 
-****
-
-Wrapper function for property-change notification, the same as 
-_object.connectBlocked("notify::" +  name, callback, after);_.
-
-_name_;; The property name to connect to, the name can also be in camelcase.
-_callback_;; Callback function that will be called when the property changes.
-_after_;; Whether to install the handler after the default handler, default
-after.
-_returns_;; The signal id of the signal.
-****
-
-==== Object GObject.getPrivate(String key, Object identifier)
-****
-
-Gets a value previously set with GObject.setPrivate.
-
-_key_;; The property name
-_identifier_;; The identifier passed to setPrivate
-_returns_;; The object set with setPrivate or null.
-****
-
-
-==== void GObject.setPrivate(String key, String value, Object identifier)
-****
-
-Associates a private value with an object that can only be retrieved in the
-calling script.
-
-_key_;; The property name
-_value_;; The property value
-_identifier_;; A local object to identify the calling script, the identifier
-must either be of type Object or of type Function.
-****
-
-==== void object.unblockSignal(Number signalid)
-****
-
-Unblocks a signal previously blocked with *object.blockSignal*.
-
-_signalid_;; The signalid returned from *object.connect*
-****
-
-
-=== webview ===
-The webview object represents the widget that actually displays the site
-content. 
-
-_wv.allFrames (Array of frames, read)_;; All frames of a webview including the mainframe
-_wv.focusedFrame (Frame, read)_;; The focused frame of the webview
-_wv.historyList (Historylist, read)_;; The focused frame of the webview
-_wv.mainFrame (Frame, read)_;; The main frame of the webview
-_wv.number (Number, read)_;; The number of the webview, starting at 0
-_wv.scrolledWindow (GtkScrollwindow, read)_;; The parent widget of every webview, it
-is used for scrolling the webview.
-_wv.tabWidget (GtkEventBox, read)_;; The main widget for tab labels, used for coloring
-tabs, child of *gui.tabBox*.
-_wv.tabBox (GtkBox, read)_;; Horizontal box, child of *wv.tabWidget*.
-_wv.tabIcon (GtkImage, read)_;;  Favicon widget, child of *wv.tabBox*.
-_wv.tabLabel (GtkLabel, read)_;; Text label of a tab, child of *wv.tabBox*.
-
-
-
-==== String wv.inject(String script, [Object argument], [Boolean global]) 
-****
-
-Injects a script into a webview
-
-_script_;; The script to inject
-_argument_;; If the script isn't injected into the global scope the script is
-wrapped inside a function. argument then is accesible via
-'arguments' in the injected script, optional 
-_global_;; true to inject it into the global scope, false to encapsulate it
-in a function, optional
-_returns_;; The return value of the script. If the script is injected globally
-inject always returns null. The return value is always converted to a string.
-To return objects call JSON.parse on the return value. 
-
-
-NOTE: If a script is injected from a loadStatus-callback the script must be
-injected after LoadStatus.committed has been emitted.
-On LoadStatus.committed the document 
-hasn't been created, if the script modifies the DOM it should be injected when
-LoadStatus.finished or documentLoaded is emitted.
-If only LoadStatus.committed or loadFinished.committed are used it is better
-to use the corresponding signals instead to reduce overhead. 
-****
-
-==== void wv.history(Number steps) 
-****
-
-Loads a history item steps away from the current history item
-
-_steps_;; Number of steps, pass a negative value to go back in history
-****
-
-==== Boolean wv.loadUri(String uri, [Function callback]) 
-****
-
-Loads an uri in a webview. 
-
-_uri_;; The uri to load
-_callback_;; A callback function that will be called when the load status
-changes, return true to stop the emission, optional
-_returns_;; true if the uri is loaded
-****
-
-==== void wv.reload(void) 
-****
-
-Reloads a webview 
-****
-
-
-==== void wv.stopLoading() 
-****
-
-Stops any ongoing loading. 
-****
-
-
-==== Number wv.toPng(String filename, [Number width, Number height], [Boolean keepAspect]) 
-****
-
-Renders a webview to a png file.
-
-_filename_;; The filename for the png.
-_width_;; The width of the png, if width is < 0 and height is > 0 the image will
-have the same aspect ratio as the original webview, optional.
-_height_;; The height of the png, if height is < 0 and width is > 0 the image
-will have the same aspect ratio as the original webview, optional, mandatory
-if width is set. 
-_keepAspect_;; Whether to keep the aspect ratio, if set to true the new
-image will have the same aspect ratio as the original webview, width and
-height are taken as maximum sizes and must both be > 0, optional.
-_returns_;; A cairo_status_t (0 on success) or -1 if an error occured.
-****
-
-
-=== frame ===
-
-A frame represents a frame or iframe. Due to same origin policy it
-is not possible to inject scripts from a webview into iframes with a
-different domain. For this purpose the frame object can be used. 
-
-_frame.domain (String, read)_;; The domain name of the frame which is the
-effective second level domain
-_frame.host (String, read)_;; The host name of the frame
-
-==== Boolean frame.inject(String script, [Boolean global])
-****
-
-Injects a script into a frame, see also webview.inject for details.
-****
-
-
-=== download ===
-
-Corresponds to a WebKitDownload. 
-
-
-==== new Download(String uri)
-****
-
-Constructs a new download
-
-_uri_;; The uri of the download
-****
-
-==== Boolean download.start([Function callback])
-****
-
-Starts a download
-
-_callback_;; A callback function that will be executed whenever the
-DownloadStatus changes, return true to stop the emission, optional.
-****
-
-
-==== void download.cancel()
-****
-
-Cancels a download
-****
-
-=== historylist ===
-
-Corresponds to a WebkitWebBackForwardList. 
-
-_historylist.backLength_;; Number of items that precede the current item
-_historylist.forwardLength_;; Number of items that succeed the current item
-
-==== WebKitWebHistoryItem historylist.getItem([Number position])
-****
-
-Gets a WebKitWebHistoryItem. 
-
-_position_;; The position of the item where 0 corresponds to the current item.
-_returns_;; A WebKitWebHistoryItem.
-****
-
-== Gtk Widgets ==
-
-It is possible to create new widgets but only widgets that are currently used by
-dwb can be created, the widgets used by dwb can be found under 
-link:http://portix.bitbucket.org/dwb/resources/layout.html[].
-
-=== Constructor === 
-
-==== new GtkWindow(String type)
-****
-
-Constructs a new widget
-
-_type_;; The type of the widget, e.g. "GtkLabel"
-****
-
-=== Methods ===
-
-All created widgets implement the following methods: 
-
-==== void GtkWidget.destroy()
-****
-
-Destroys a widget. Note that only newly created widgets can be destroyed.
-
-****
-
-
-Widgets that implement the GtkBox interface implement the following methods:
-
-==== void GtkWidget.packEnd(GtkWidget child, boolean expand, boolean fill, int padding)
-****
-
-Adds a widget to a GtkBox.
-
-_child_:: The child widget
-_expand_:: Whether to expand the widget
-_fill_:: Whether to fill the remaining space
-_padding_:: Padding in the box
-****
-
-==== void GtkWidget.packStart(GtkWidget child, boolean expand, boolean fill, int padding)
-****
-
-Adds a widget to a GtkBox.
-
-_child_:: The child widget
-_expand_:: Whether to expand the widget
-_fill_:: Whether to fill the remaining space
-_padding_:: Padding in the box
-****
-
-==== void GtkWidget.reorderChild(GtkWidget child, int postion)
-****
-
-Moves a widget to a new position.
-
-_child_:: The child widget
-_position_:: The new position
-****
-
-Widgets derived from GtkContainer implement the following methods:
-
-==== void GtkWidget.add(GtkWidget child)
-****
-
-Adds a widget to a GtkContainer.
-
-_child_:: The child widget
-****
-
-==== Example 
-
-------
-var label = new GtkWidget("GtkLabel");
-gui.statusBox.packStart(label, false, false, 0);
-label.label = "foobar";
-label.visible = true;
-------
-
-
-== SIGNALS ==
-With the signals object *dwb* communicates with the script on certain events. 
-To connect to a signal one can call the connect function that is implemented by
-the signals object, that takes 2 arguments, the name of the signal and a
-callback function. 
-
-The callback function has a varying number of parameters.
-The last paramter is always a json-object which might be empty or contain
-additional data relevant to the signal. 
-A callback function should either return true or false or nothing which is
-equivalent to false.
-If multiple callbacks are connected to the same signal and one callback
-function returns true the overall return value will be true.
-
-*dwb* only emits signals as long as one callback is connected to a signal. To
-reduce overhead one should disconnect from signals when no longer
-needed. 
-
-The signals object is not a readonly object, properties can be added to the
-object which are visible in all scripts but it should be avoided to add
-properties on the signals object. signals should only be used to connect to
-signals or define custom signals. 
-
-The signals object implements the following methods
-
-=== Methods ===
-
-==== Number signals.connect(String signal, Function callback) 
-****
-Connect to a signal
-
-_signal_;; The signal to connect to 
-_callback_;; The callback function which will be called when the signal is emitted
-_returns_;;  Unique id for this connection, can be passed to disconnect
-****
-
-==== Number signals.connectWebView(String signal, Function callback) 
-****
-Connect all webviews to a GObject signal
-
-_signal_;; The signal to connect to 
-_callback_;; The callback function which will be called when the signal is
-emitted, the arguments of the callback function correspond to the GObject
-callback
-****
-
-
-==== Boolean signals.emit(String signal,  ...)
-****
-
-Emits a signal with a variable number of arguments passed to the callback
-function
-
-_signal_;; The signal to emit
-_..._;; Objects passed to the callback function
-_returns_;; Overall return value from all connected callback functions
-****
-
-==== Boolean signals.disconnect(Number id|Function callback) 
-****
-
-Disconnect from a signal 
-
-_id|callback_;; The id returned from *connect* or the callback function passed
-to *connect*. Note that if the same callback is used more than once 
-the signal must be disconnected by id, otherwise the behaviour is undefined. 
-****
-
-
-==== void signals.disconnectByName(String signal) 
-****
-
-Disconnect from all signals with matching name,
-It should be avoided to call disconnectByName
-on signals implemented by dwb since it will completely stop the emission of the
-signal in all scripts. 
-
-_signal_;; The callback function passed to connect
-_returns_;; true if signals were disconnected, false if no signal
-was disconnected
-****
-
-=== Emitted signals ===
-
-Custom signals can be created by simply calling 
-
------
-signals.connect("nameOfNewSignal", callbackFunction);
------
-
-
-Signals emitted by dwb are the following:
-
-
-==== buttonPress 
-
-
-****
-----
-signals.connect("buttonPress", function(webview, hittestresult, event));
-----
-
-Emitted when a button is pressed on the webview, return true to prevent
-the default action
-
-_webview_;; The webview which received the signal
-_hittestresult_;; Hittestresult under the cursor
-_event.button_;; The button that is pressed, usually a value between 1 and 5
-_event.state_;; A bitmap of modifiers pressed, see Modifier
-_event.time_;; The time in milliseconds when the button was pressed 
-_event.type_;; A ClickType
-_event.x_;; x-position relative to the window
-_event.xRoot_;; x-position relative to the screen
-_event.y_;; y-position relative to the window
-_event.yRoot_;; y-position relative to the screen
-****
-  
-==== buttonRelease 
-
-****
-----
-signals.connect("buttonRelease", function(webview, hittestresult, event));
-----
-
-Emitted when a button is released, return true to prevent the default action
-
-_webview_;; The webview which received the signal
-_hittestresult_;; Hittestresult under the cursor
-_event_;; Same as buttonPress but without _event.type_
-****
-
-==== changeMode 
-
-****
-----
-signals.connect("changeMode", function(webview, mode));
-----
-
-Emitted when the mode changes, return true to prevent the change.
-
-_webview_;; The focused webview
-_mode_;; A mode, see also Modes for possible modes
-****
-
-==== close
-
-****
-----
-signals.connect("close", function());
-----
-
-Emitted when dwb is closed
-****
-
-==== createTab
-****
-----
-signals.connect("createTab", function(webview));
-----
-
-Emitted when a tab is created
-
-_webview_;; The webview that corresponds to the created tab
-****
-
-==== closeTab
-****
-
-----
-signals.connect("closeTab", function(webview));
-----
-
-Emitted when a tab is closed
-
-_webview_;; The webview that corresponds to the tab
-****
-
-==== documentLoaded
-****
-----
-signals.connect("documentLoaded",  function(webview, frame));
-----
-
-Emitted when a the DOM document of a frame has been loaded.
-
-_webview_;; The webview that emitted the signal
-_frame_;; The frame that contains the document
-****
-
-==== download
-****
-----
-signals.connect("download", function(webview, download, json));
-----
-
-Emitted before a download starts, before a file or action has been chosen,
-return true if the signal was handled. 
-
-_webview_;; The webview that emitted the signal
-_download_;; The Download 
-_json.referer_;; The referer
-_json.mimeType_;; The mimetype of the file
-****
-
-==== downloadStart
-****
-----
-signals.connect("downloadStart", function(download, json));
-----
-
-Emitted before a download starts after a path or application has been chosen, 
-return true if the signal was handled. Note that destinationUri has not been
-set on the download.
-
-_download_;; The Download 
-_json.referer_;; The referer
-_json.mimeType_;; The mimetype of the file
-_json.destinationUri_;; The chosen destination path or null if an application was chosen.
-_json.application_;; The chosen application or null if a path was chosen.
-****
-
-
-==== downloadStatus
-****
-----
-signals.connect("downloadStatus", function(download));
-----
-
-Emitted when the DownloadStatus changes. 
-
-_download_;; The Download 
-****
-
-==== executeCommand
-****
-----
-signals.connect("executeCommand", function(commandinfo));
-----
-
-Emitted when a command is executed, return true to prevent execution.
-
-_commandinfo.command_;; The command that is executed
-_commandinfo.argument_;; An argument, if the command isn't executed from commandline this
-will always be null.
-_commandinfo.nummod_;; The numerical modifier.
-****
-
-
-==== frameCreated
-****
-----
-signals.connect("frameCreated", function(webview, frame));
-----
-
-Emitted when a frame is created
-
-_webview_;; The webview the frame belongs to
-_frame_;; The frame 
-****
-
-==== frameStatus
-****
-----
-signals.connect("frameStatus", function(webview, frame));
-----
-
-Emitted when the LoadStatus of a frame changes
-
-_webview_;; The webview the frame belongs to
-_frame_;; The frame 
-****
-
-==== keyPress
-****
-----
-signals.connect("keyPress", function(webview, json));
-----
-
-Emitted when a key is pressed, return true to prevent the default action
-
-_webview_;; The focused webview
-_json.isModifier_;; Whether or not the key is a modifier
-_json.keyCode_;; Hardware keycode
-_json.keyVal_;; Keycode as listed in gdkkeysyms.h 
-_json.name_;; A string represantation of the key
-_json.state_;; A bitmap of modifiers pressed, see Modifier
-****
-
-==== keyRelease
-****
-----
-signals.connect("keyRelease", function(webview, json));
-----
-
-Emitted when a key is released, return true to prevent the default action
-
-_webview_;; The focused webview
-_json_;; Same as keyPress
-****
-
-
-==== loadCommitted
-****
-----
-signals.connect("loadCommitted", function(webview));
-----
-
-Emitted when the load has just commited, no data has been loaded when this
-signal is emitted. This is the preferred signal for injected scripts that do not
-manipulate the DOM.
-
-_webview_;; The webview that emitted the signal
-****
-
-==== loadFinished
-****
-----
-signals.connect("loadFinished", function(webview));
-----
-
-Emitted when the site has completely loaded. 
-
-_webview_;; The webview that emitted the signal
-****
-
-==== loadStatus
-****
-----
-signals.connect("loadStatus", function(webview));
-----
-
-Emitted when the load status changes
-
-_webview_;; The webview that emitted the signal
-****
-
-==== mimeType
-****
-----
-signals.connect("mimeType", function(webview, frame, request, json));
-----
-
-Decide whether or not to show a given mimetype. Return true to stop the request.
-
-_webview_;; The webview that emitted the signal
-_frame_;; The frames requires the decision 
-_request_;; The network request
-_json.mimeType_;; The mimetype
-****
-
-==== mouseMove
-****
-----
-signals.connect("mouseMove", function(webview, event));
-----
-
-Emitted when the pointer is moved.
-
-_webview_;; The webview that emitted the signal
-_event_;; Same as buttonRelease
-****
-
-==== navigation
-****
-----
-signals.connect("navigation", function(webview, frame, request, action));
-----
-
-Emitted before a new site is loaded, return true to stop the request.
-
-_webview_;; The webview that emitted the signal
-_frame_;; The frame that requires the navigation 
-_request_;; The network request
-_action_;; The navigation action
-****
-
-==== resource
-****
-----
-signals.connect("resource", function(webview, frame, request, response));
-----
-
-Emitted before a new resource is going to be loaded
-
-_webview_;; The webview that emitted the signal
-_frame_;;   The frame that dispatched the request
-_request_;; The network request
-_response_;; The network response
-****
-
-==== statusBarChange 
-****
-----
-signals.connect("statusBarChange", function(webview, data));
-----
-
-Emitted before the status bar is updated, if the callback returns true dwb will
-not update the statusbar so it is possible to set the statusbar from the script.
-
-_webview_;; The focused webview
-_data.canGoBack_;; Whether it is possible to navigate back in the webview
-_data.canGoForward_;; Whether it is possible to navigate forward in the webview
-_data.isBookmarked_;; Whether the site is bookmarked
-_data.isQuickmarked_;; Whether the site is quickmarked
-_data.pluginsBlocked_;; Whether plugins are blocked
-_data.scriptsBlocked_;; Whether scripts are blocked
-_data.ssl_;; SSL-State of the page, can either be 'trusted', 'untrusted' or 'none'
-_data.type_;; The type of the update, can be *status* and *uri*, status means
-that statusLabel und uriLabel need to be updated, uri means that only the
-uriLabel needs to be updated.
-****
-
-==== tabButtonPress 
-
-****
-----
-signals.connect("tabButtonPress", function(webview, tabwidget, event));
-----
-
-Emitted when a button is pressed on a tabwidget, return true to prevent the default action
-
-_webview_;; The webview which received the signal
-_tabwidget_;; The tabwidget
-_event_;; Same as buttonPress
-****
-
-==== tabFocus
-****
-----
-signals.connect("tabFocus", function(webview, json));
-----
-
-Emitted when another tab gets focus, return true to stop the event
-
-_webview_;; The new tab
-_json.last_;; The number of the previously focused tab
-****
-
-
-== ENUM OBJECTS ==
-Enum objects are objects that have only readonly properties, mapping
-gtk/webkit enums to javascript objects. 
-
-=== ButtonContext
-****
-[source,javascript]
---------
-const ButtonContext = {
-  document   : 1 << 1,
-  link       : 1 << 2,
-  image      : 1 << 3,
-  media      : 1 << 4,
-  selection  : 1 << 5,
-  editable   : 1 << 6
-};
---------
-****
-
-=== ChecksumType
-
-****
-[source,javascript]
---------
-const ChecksumType = {
-  md5     : 0, 
-  sha1    : 1, 
-  sha256  : 2 
-};
---------
-****
-
-=== ClickType
-****
-
-[source,javascript]
---------
-const ClickType = {
-  click       : 4,
-  doubleClick : 5,
-  tripleClick : 6
-};
---------
-****
-
-=== DownloadStatus
-****
-
-[source,javascript]
--------
-const DownloadStatus = {
-  error       : -1,
-  created     : 0,
-  started     : 1, 
-  cancelled   : 2,
-  finished    : 3
-};
--------
-****
-
-=== FileTest
-****
-
-[source,javascript]
--------
-const FileTest = {
-  regular    : 1 << 0,
-  symlink    : 1 << 1,
-  dir        : 1 << 2,
-  executable : 1 << 3,
-  exists     : 1 << 4
-};
--------
-****
-
-=== LoadStatus
-
-****
-[source,javascript]
----------
-const LoadStatus = { 
-  provisional       : 0, 
-  committed         : 1,
-  finished          : 2,
-  firstVisualLayout : 3,
-  failed            : 4
-};
----------
-****
-
-=== Modifier
-
-****
-[source,javascript]
---------
-const Modifier = {
-  Shift     : 1 << 0,
-  Lock	    : 1 << 1,
-  Control   : 1 << 2,
-  Mod1	    : 1 << 3,
-  Mod2	    : 1 << 4,
-  Mod3	    : 1 << 5,
-  Mod4	    : 1 << 6,
-  Mod5	    : 1 << 7,
-  Button1   : 1 << 8,
-  Button2   : 1 << 9,
-  Button3   : 1 << 10,
-  Button4   : 1 << 11,
-  Button5   : 1 << 12,
-  Super     : 1 << 26,
-  Hyper     : 1 << 27,
-  Meta      : 1 << 28,
-  Release   : 1 << 30,
-  Modifier  : 0x5c001fff
-};
---------
-****
-
-=== NavigationReason
-
-****
-[source,javascript]
---------
-const NavigationReason = {
-  linkClicked     : 0,
-  formSubmitted   : 1,
-  backForward     : 2,
-  reload          : 3,
-  formResubmitted : 4,
-  other           : 5
-};
---------
-****
-
-=== Modes
-
-****
-[source,javascript]
---------
-const Modes = {
-  NormalMode  : 1<<0,
-  InsertMode  : 1<<1,
-  CommandMode : 1<<2
-};
---------
-****
-
-=== Selection
-
-****
-[source,javascript]
---------
-const Selection = {
-  primary   : 1,
-  clipboard : 2
-};
---------
-****
-
-
-== GLOBAL DATA == 
-Since all scripts share the same execution context, they are encapsulated in a
-function. To avoid conflicts with other scripts it is not allowed to set properties
-on the global object, i.e. 
-
-[source,javascript]
--------
-#!javascript
-
-// not allowed, the global object is readonly
-number = 0;
-io.print(number);     // undefined
-
-var number2 = 0;
-io.print(number2);    // 0
-
-// not allowed
-foo = function() 
-{
-  io.print("foo");
-}
-foo();  // fails
--------
-
-For sharing data between scripts either signals or modules can be created.
-
-=== script and this
-In every script the variable *script* refers to *this*, the encapsulating
-function, it has the following properties and methods:
-
-
-_script.path (Object, read)_;; The path of the script.
-
-==== void script.debug(Object params)
-****
-
-Same as io.debug but also prints additional information, e.g. if the object is
-an Error, this method will also print the corresponding source of the error.
-****
-
-== Modules == 
-
-With modules it is possible to share objects between scripts. Modules are
-defined with +provide+ and loaded with +require+.
-
-
-.Defining modules
-[source,javascript]
--------
-#!javascript 
-
-provide("myModule", {
-  foo : 37, 
-  doBar : function() {
-    io.print("bar");
-  }
-});
-provide("myOtherModule", {
-  act : function (arg) {
-    io.print(arg);
-  }
-});
--------
-
-.Getting some modules
-[source,javascript]
--------
-#!javascript 
-
-require(["myModule", "myOtherModule"], function(myModule, myOtherModule) {
-  if (myModule.foo == 37) 
-    myModule.doBar();
-
-  myOtherModule.act("foo");
-});
--------
-
-.Getting all modules
-[source,javascript]
--------
-#!javascript 
-
-require(null, function(modules) {
-  if (modules.myModule.foo == 37) 
-    modules.myModule.doBar();
-
-  modules.myOtherModule.act("foo");
-});
--------
-
-It is also possible to specify a path in the name array. The name then follows
-the format *name!path*:
-
-[source,javascript]
--------
-#!javascript 
-
-require(["foo!/path/to/foo"], function(foo) {
-  io.print(foo.bar); // 37
-});
--------
-
-./path/to/foo
-[source,javascript]
--------
-provide("foo", { bar : 37 });
--------
-
-The resolution chain is as follows, first all modules defined with *provide* and
-module names requested by *require* are stored. If all scripts have been loaded
-the requirements are resolved. If a requirement contains a path and the module
-isn't defined yet the module will be loaded, if it is already defined the path
-is ignored and the stored module will be resolved:  
-
-[source,javascript]
--------
-#!javascript 
-
-require(["foo!/path/to/foo"], function(foo) {
-  io.print(foo.bar); // 42
-});
-provide("foo", { bar : 42 });
--------
-
-[source,javascript]
--------
-#!javascript 
-
-require(["foo"], function(foo) {
-  io.print(foo); // undefined
-});
-require(["foo!/path/to/foo"]);
-
-require(["foo"], function(foo) {
-  io.print(foo); // { bar : 37 }
-});
--------
-
-
-== EXTENSIONS ==
-*dwb* provides the possibility to load extensions.
-It is recommended to implement javascript-userscripts as an extension to have 
-consistent configuration locations for scripts. One advantage of extension also
-is that they can be loaded/unloaded on the fly.
-
-=== Prepackaged extensions
-
-==== formfiller
-
-An extension that gets form data and fills forms with previously saved data.
-
-*Configuration options*::
- 
-_formData_;; A path to a file where formdata will be saved, the default
-                 path is *$XDG_CONFIG_HOME/dwb/forms*
-_scGetForm_;; Shortcut that gets and saves form data, the default value is *efg*
-_scFillForm_;; Shortcut that fills a form, the default value is *eff*
-_useGPG_;; Whether to use gpg2 to encrypt the formData file with a password.
-_GPGOptEncrypt_;; Additional options that will be passed to gpg2 for
-                encryption, the default gpg2 options are:
-                --passphrase <password> --batch --no-tty --yes -c --output <formData>
-                default value: *""*
-_GPGOptDecrypt_;; Additional options that will be passed to gpg2 for
-                decryption, the default gpg2 options are 
-                --passphrase <password> --batch --no-tty --yes -d <formData>
-                default value: *""*
-
-_keepPassword_;;  Whether to save the gpg password in memory, if set to false the
-                user will be prompted for the password every time a form
-                is filled or new data is saved, default value: *true*
-
-_keepFormdata_;;  If useGPG is enabled and this value is set to true the
-                  complete formdata will be kept in memory, if set to false
-                  gpg2 will be called every time a form is filled, default
-                  value: *false*
-
-==== perdomainsettings
-
-An extension that can be used for per-domain-settings. Valid settings are
-the properties of WebKitWebSettings but in camelcase, see 
-http://webkitgtk.org/reference/webkitgtk/unstable/WebKitWebSettings.html
-for details. 
-
-*Configuration options*::
-
-_domains_;;   Settings applied based on the effective second level domain
-
-_hosts_;;   Settings applied based on host name, this option is
-        an object of the format
-
-_uris_;;   Settings applied based on the uri, this option is
-        an object of the format
-
-_defaults_;;  Default settings, for each setting in domains, hosts and uris a
-             default-value should be specified
-
-*Example configuration*::
-
-Example using extensions.load:
-
-[source,javascript]
-----
-extensions.load("perdomainsettings", { 
-  domains : {                                                            
-     "example.com" : {                                                   
-          "enablePlugins"  : true                                        
-     },                                                                  
-     "example.uk.com" :  {                                               
-          "enablePlugins"  : true,                                       
-          "enableScripts"  : false                                       
-     }                                                                   
-  },                                                                     
-  hosts : {                                                              
-     "www.example1.com" :  {                                             
-          "autoLoadImages" : true                                        
-     }                                                                   
-  },                                                                     
-  uris : {                                                               
-     "http://www.example2.com/login.php" :  {                            
-          "autoLoadImages" : false                                       
-     }                                                                   
-  },                                                                     
-  defaults : {                                                           
-     "enablePlugins"   : false,                                          
-     "autoLoadImages"  : false,                                          
-     "enableScripts"   :  true                                           
-  }                                                                      
-});
-----
-
-
-==== requestpolicy
-
-Extension that blocks requests from thirdparty domains with whitelisting
-support, either permanently or just for the session.
-It is also possible to block requests from certain domains on all sites, they
-have highest precedence and will also be blocked on sites where 
-thirdparty requests are allowed in general. 
-
-*Configuration options*::
-
-_shortcut_;; Shortcut to block / allow requests, default *"erp"*
-
-_unblockCurrent_;; Shortcut to unblock always blocked requests, shows only
-                 domains from the current site, default *"erC"*
-
-_unblockAll_;;  Shortcut to unblock always blocked requests, shows all
-                 blocked domains, default *"erA"*
-
-_whiteList_;; A path to the whitelisting file, default is
-                 *$XDG_CONFIG_HOME/dwb/<profile>/requestpolicy.json*
-
-_autoreload_;; Whether to automatically reload the website after the
-                 persistentList has changed, default *false*
-
-_notify_;; Whether to notify about blocked request, default *false*
-
-==== unique_tabs
-
-Extension that allows to remove duplicate tabs or avoids duplicate tabs
-automatically.
-
-*Configuration options*::
-
-_shortcutRemoveDuplicates_;; Shortcut that removes duplicate tabs, default *null*
-
-_commandRemoveDuplicates_;; Command that remove s duplicate tabs, default
-*ut_remove_duplicates*
-
-_autoFocus_;; Autofocus a tab if an url is already opened, if the url would be loaded in a
-new tab the new tab is closed.  Setting this to true makes commandRemoveDuplicates and
-shortcutRemoveDuplicates obsolete because there will be no duplicate tabs.
-Default value: *true*
-
-_shortcutToggleAutoFocus_;; Shortcut that enables/disables autofocus, default
-*null*
-
-_commandToggleAutoFocus_;;  Command that enables/disables autofocus, default
-*ut_toggle_autofocus*
-
-
-==== userscripts
-
-Extension that loads userscripts and injects them into websites, this
-extension is mostly greasemonkey compatible. Scripts can be loaded by either
-passing an array of paths to extensions.load or by putting scripts into
-$XDG_CONFIG_HOME/dwb/scripts/. 
-
-*Configuration options*::
-
-The only configuration option is an array of paths to scripts
-
-*Example configuration*::
-
-Example using extensions.load:
-
-----
-extensions.load("userscripts", [ "/path/to/script1", "/path/to/script2" ]);
-----
-
-
-=== Using extensions
-
-Extensions can be loaded by an userscript 
-
-[source,javascript]
-------
-#!javascript 
-
-extensions.load("extension_1");
-extensions.load("extension_2", { 
-  configProp_1 : 22, 
-  configProp_2 : "val2" 
-});
-------
-
-To load/unload extensions on the fly *extensions.bind* can be used:
-
-[source,javascript]
-------
-#!javascript 
-
-var myConfig = { 
-  prop_1 : 37, 
-  prop_2 : true, 
-  prop_3 : "foo"
-};
-
-
-extensions.bind("myExtension", "Control m", {
-  command : "toggleMyExtension", 
-  config : myConfig, 
-  load : false
-});
-
-extensions.bind("mySecondExtension", "Control M");
-------
-
-The default searchpaths for extensions are $XDG_DATA_HOME/dwb/extensions/ and
-/usr/share/dwb/extensions/.
-
-=== Methods
-
-==== void extensions.bind(String name, String shortcut, [Object options]) 
-****
-Bind an extension to a shortcut, the shortcut enables/disables the extension.
-
-_name_;; Name of the extension
-_shortcut_;; Name of the extension
-_options_;; An optional object with options where possible options are 
-options.load::: Whether to load the extension on startup, default true
-options.config::: Config passed to extensions.load
-options.command::: Command that can be used on command line
-****
-
-==== void extensions.disableAll() 
-****
-Disables all extensions.
-****
-
-==== Boolean extensions.load(String name, [Object config]) 
-****
-Loads an extension
-
-_name_;; Name of the extension
-_config_;; The config for the script, if omitted the config is read from
-$XDG_CONFIG_HOME/dwb/extensionrc, optional
-_returns_;;  True if the extension was loaded
-****
-
-==== Boolean extensions.toggle(String name, [Object config]) 
-****
-Toggles an extension
-
-_name_;; Name of the extension
-_config_;; The config for the extension.
-optional
-_returns_;;  True if the extension was loaded, false if it was unloaded.
-****
-
-==== Boolean extensions.unload(String name) 
-****
-Unloads an extension
-
-_name_;; Name of the extension
-_returns_;;  True if the extension was unloaded
-****
-
-==== void extensions.error(String name, String message|Error e, [String message]) 
-****
-
-Print an error message and call stack to stderr.
-
-_name_;; Name of the extension
-_message|e_;; The error message or an Error
-_message_;; If the second parameter is an Error, an optional message can be
-specified.
-****
-
-==== Object extensions.getConfig(Object config, Object defaultConfig)
-**** 
-Parses config with given default config. Checks for each property of
-defaultConfig if the corresponding property of config is valid.
-
-_config_;; The configuration object
-_defaultConfig_;; The default configuration for the extension
-_returns_;; The parsed config
-****
-
-==== void extensions.message(String name, String message) 
-****
-
-Print a consistent message to stderr
-
-_name_;; Name of the extension
-_message_;; The message
-****
-
-
-==== void extensions.warning(String name, String message) 
-****
-
-Print a consistent warning to stderr
-
-_name_;; Name of the extension
-_message_;; The warning message
-****
-
-
-=== Writing extensions
-
-The default searchpath for extensions is *$XDG_DATA_HOME/dwb/extensions* and
-*SHARE_DIR/dwb/extensions* where  
-SHARE_DIR being the share directory of the installation, most likely /usr/share.
-
-The configuration for extensions is in *$XDG_CONFIG_HOME/dwb/extensionrc* and should
-return a javascript object. 
-
-Every extension must implement one function named init that takes one
-argument, the config for the extension. The function should return true if the
-extension was successfully loaded, false otherwise.
-Every extension also may implement a function end that will be called when an
-extension is unloaded. If an extension registers to signals and binds shortcuts
-the extension should unregister all signals and unbind all shortcuts in this
-function.
-init and end should be returned from the extension.
-
-Additionally the returned object can also have an +defaultConfig+-property, the
-value will be passed to extensions.getConfig before calling the init function.
-
-==== Example
-
-A extension called *foobar* in *$HOME/.local/share/dwb/extensions/foobar*:
-
-[source,javascript]
---------
-function foo(val) {
-  ....
-}
-function bar(val) {
-  ....
-}
-function loadStatusCallback(w) {
-  ...
-}
-return {
-  defaultConfig : { foo : 37 },
-
-  init : function (config) {
-    if (config.foo > 36) {
-      bar(config.foo);
-      foo(config.bar);
-      bind("XX", bar, "dobar");
-      signals.connect("loadStatus", loadStatusCallback);
-      return true;
-    }
-
-    return false;
-  },
-
-  end : function () {
-    unbind("dobar");
-    signals.disconnectByFunction(loadStatusCallback);
-    return true;
-  }
-};
---------
-
-==== Example extensionrc
-
-[source,javascript]
---------
-return {
-  foobar : { bar : "X", foo : 37 }, // config for extension foobar
-  barfoo : {  }                     // config for extension barfoo
-  
-};
---------
-
-==== Public api
-
-Extensions that provide a public api can use provide or replace using the name of the extension. 
-
-====
-[source,javascript]
---------
-var myPublicFunction = function() 
-{
-  ...
-};
-
-return {
-  init : function(config) 
-  {
-    provide("myExtensionName", 
-    {
-      config : config, 
-      method : myPublicFunction
-    });
-  },
-  end : function() 
-  {
-    replace("myExtensionName");
-  }
-};
---------
-====
-
-
-== SEE ALSO
-*dwb*(1) *dwbem*(1)
diff --git a/api/jsapi.txt b/api/jsapi.txt
deleted file mode 100644
index 82b60c2c..00000000
--- a/api/jsapi.txt
+++ /dev/null
@@ -1,3808 +0,0 @@
-= dwb's JavaScript API documentation =
-
-== Abstract == 
-
-*dwb* can be extended with different types of userscripts. 
-This api documentation describes the javascript interface. 
-
-== Getting Started == 
-Scripts that use the javascript api must be located in
-+$XDG_CONFIG_HOME/dwb/userscripts+ like any other script. 
-Scripts that use the javascript api must either start with 
-
--------
-#!javascript
--------
-
-or with 
-
--------
-//!javascript
--------
-
-All native javascript methods can be used in scripts, however there are
-limitations:  
-
-* The execution context of userscripts is completely seperated from the web
-execution context. Due to security concerns it is not possible to communicate
-with the web execution context, it is only possible to inject scripts into the
-web context.
-* In contrast to the global +window+ object in the web execution context, 
-the global object is a readonly object, i.e. it is not possible to set
-properties on the global object, see also <<Globaldata,global data>> for details.
-
-:numbered!:
-:caption:
-
-
-== Global ==
-
-=== Properties ===
-
-****
-[float]
-==== *global* ====
-
-[source,javascript]
-----
-global        object     read
-----
-
-Refers to the global object.
-****
-
-****
-[float]
-==== *session* ====
-
-[source,javascript]
-----
-session        SoupSession     read
-----
-
-The webkit session.
-****
-
-=== Methods ===
-
-
-****
-[[bind]]
-[float]
-==== *bind()* ==== 
-
-[source,javascript]
-----
-boolean bind(String shortcut, Function callback, [String name])
-----
-
-Bind a javascript function to a shortcut. This is the preferred method of
-binding keys to shortcuts since the shortcut is evaluated using the native
-method, but also the keyPress-signal can be used to bind shortcuts. 
-
- ::
-
-_shortcut_;; A shortcut shortcut, will be parsed the same way as if set in
-dwb:keys
-_callback_;; Callback function that will be called when the shortcut is pressed
-_name_;; A name that identifies the function on command line, optional
-_returns_;; +true+ if the function was bound successfully
-****
-
-
-****
-[[execute]]
-[float]
-==== *execute()* ==== 
-
-[source,javascript]
-----
-Boolean execute(String command)
-----
-
-Executes a dwb command
-
- ::
-
-_command_;; a dwb command to execute, will be parsed the same way as if executed
-from commandline
-_returns_;; +true+ if execution was successful
-****
-
-****
-[[exit]]
-[float]
-==== *exit()* ==== 
-
-[source,javascript]
-----
-Boolean exit()
-----
-
-Exit dwb, must be called if the script is running from commandline. 
-****
-
-
-****
-[[include]]
-[float]
-==== *include()* ==== 
-
-[source,javascript]
-----
-Value include(String path, [Boolean global])
-----
-
-Includes a file. Note that there is only one context, all scripts are
-executed in this context. Included files are not visible in other scripts unless
-+true+ is passed as second parameter. 
-
- ::
-
-_path_;; Path to a file to include
-_global_;; Whether to include the script into the global scope, optional
-_returns_;; The return value of the included file
-****
-
-****
-[[provide]]
-[float]
-==== *provide()* ==== 
-
-[source,javascript]
-----
-void provide(String name, Object module)
-----
-
-Defines a module that can be used in other scripts, see <<Modules>> for details.
-
- ::
-
-_name_;; Name of the module
-_module_;; The module
-****
-
-****
-[[replace]]
-[float]
-==== *replace()* ==== 
-
-[source,javascript]
-----
-void replace(String name, Object module)
-----
-
-Same as <<provide>> but replaces the module if it was already defined. 
-Same as <<provide>> but replaces the module if it was already defined.
-
- ::
-
-_name_;; Name of the module
-_module_;; The module, if omitted the module will be deleted, all references to
-that module will reference an empty object afterwards, optional.
-****
-
-****
-[[require]]
-[float]
-==== *require()* ==== 
-
-[source,javascript]
-----
-void require(Array names, Function callback)
-----
-
-Load modules defined with <<provide>>.
-
- ::
-
-_names_;; An array of module names or null to get all modules, a module name can
-also contain a path, the path must be seperated with a +!+ from the module name,
-see also <<Modules>> for details.
-_callback_;; A callback function that is called after initialization of all
-scripts and modules. The parameters of the callback function correspond to the
-names array. If +names+ is null the function is called with one parameter that
-contains all modules, see also <<Modules>> for examples.
-****
-
-****
-[[sendRequest]]
-[float]
-==== *sendRequest()* ==== 
-
-[source,javascript]
-----
-void sendRequest(String uri, Function callback, [String method])
-----
-
-Sends a http-request. 
-
- ::
-
-_uri_;; The uri the request will be sent to.
-_callback_;; A callback that will be called when the request is finished, the
-callback has 2 parameters, the first will be an object that contains +body+ and
-+headers+, the second the associated +SoupMessage+.
-_method_;; The http request method, default +GET+, optional.
-****
-
-****
-[[sendRequestSync]]
-[float]
-==== *sendRequestSync()* ==== 
-
-[source,javascript]
-----
-Object sendRequestSync(String uri, [String method])
-----
-
-Sends a http-request synchronously. 
-
- ::
-
-_uri_;; The uri the request will be sent to.
-_method_;; The http request method, default +GET+, optional.
-_returns_;; Object that contains the response +body+, the response +headers+ and
-the http +status+ code of
-the request. 
-****
-
-****
-[[tabComplete]]
-[float]
-==== *tabComplete()* ==== 
-
-[source,javascript]
-----
-void tabComplete(String label, Array items, Function callback, [Boolean readonly])
-----
-
-Initiates tab completion.
-
- ::
-
-_label_;; The command line label
-_items_;; An array of objects, each object can have 2 properties, +left+ which
-will be the left completion label and +right+ which will be the right completion
-label.
-_callback_;; Callback function, the first argument will be the returned string
-from the url bar.
-_readonly_;; Whether the items are readonly, default +false+, optional.
-****
-
-****
-[[timerStart]]
-[float]
-==== *timerStart()* ==== 
-
-[source,javascript]
-----
-Number timerStart(Number interval, Function func)
-----
-
-Executes a function repeatedly until the function returns +false+ or
-<<timerStop>> is called on the +id+ returned from this function
-
- ::
-
-_interval_;; Interval in milliseconds
-_func_;; Function to execute
-_returns_;; An id that can be passed to timerStop
-****
-
-****
-[[timerStop]]
-[float]
-==== *timerStop()* ==== 
-
-[source,javascript]
-----
-Number timerStop(Number id)
-----
-
-Stops a timer started by <<timerStart>>
-
- ::
-
-_id_;; The id returned from <<timerStart>>
-_returns_;; +true+ if the timer was stopped
-****
-
-****
-[[unbind]]
-[float]
-==== *unbind()* ==== 
-
-[source,javascript]
-----
-Number unbind(Function func|String name)
-----
-
-Unbind a shortcut that was previously bound with <<bind>>
-
- ::
-
-_func_ or _name_;; Either the function or the optional name passed to <<bind>>.
-_returns_;; +true+ if the function was unbound
-****
-
-======
-.Example
-[source,javascript]
----------------------------------
-execute("tabopen ixquick.com");
-
-// Execute a function once, similar to window.setTimeout()
-timerStart(2000, function() { 
-  tabs.current.inject("alert('Hello world')");
-  return false;
-});
----------------------------------
-======
-
-NOTE: Scripts included with +include+ are either visible in the global scope or
-invisible, even in the including script. To use an included script it can return
-an object with its public objects: 
-
-======
-[source,javascript]
----------------------------------
-// included script 
-
-var private = 37;
-return {
-  getPrivate : function () {
-    return private;
-  }
-};
-
-// Scripts that includes the above
-var i = include("/path/to/script");
-var p = i.getPrivate();               // 37
----------------------------------
-======
-
-or define a module: 
-
-======
-[source,javascript]
----------------------------------
-// included script 
-
-var private = 37;
-provide("foo", {
-    getPrivate : function() {
-        return private;
-    }
-});
-
-// Scripts that includes the above
-var i = include("/path/to/script");
-require(["foo"], function(foo) {
-    var bar = foo.getPrivate();               // 37
-})
----------------------------------
-======
-
-
-
-[[Globalobjects]]
-== Global Objects ==
-
-[[data]] 
-=== data ===
-The +data+ object can be used to determine internally used data securely. All
-properties are readonly Strings.
-
-****
- ::
-
-_data.bookmarks_;; Bookmark file 
-_data.cacheDir_;; Cache directory 
-_data.configDir_;; Config directory 
-_data.cookies_;; Cookie file 
-_data.cookiesWhitelist_;; Whitelist for persistent cookies 
-_data.customKeys_;; Custom keyboard shortcuts 
-_data.history_;; History file 
-_data.keys_;; Shortcuts configuration file 
-_data.pluginsWhitelist_;; Whitelist for the plugin blocker
-_data.profile_;; Profile which will be +default+ unless another profile is specified on command line
-_data.quickmarks_;; Quickmark file 
-_data.scriptWhitelist_;; Whitelist for scripts
-_data.session_;; File with stored sessions for this profile
-_data.sessionCookiesWhitelist_;; Whitelist for session cookies
-_data.settings_;; Settings configuration file
-_data.searchEngines_;; Searchengines 
-****
-
-====
-.Example
-[source,javascript]
----------------------------------
-// Get contents of the currently used bookmark file
-var bookmarks = io.read(data.bookmarks);
---------------------------------
-====
-
-[[io]]
-=== io ===
-The +io+ object implements methods for input and output. 
-
-****
-[[debug]]
-[float]
-==== *debug()* ==== 
-
-[source,javascript]
-----
-void io.debug([Object detail])
-----
-
-Prints a debug message and the call stack to stderr. 
-
- :: 
-
-_detail_;; Message details, optional
-_detail.message_;; The message to show, optional
-_detail.error_;; An Error object, optional 
-_detail.arguments_;; Arguments, optional
-****
-
-****
-[[dirNames]]
-[float]
-==== *dirNames()* ==== 
-
-[source,javascript]
-----
-Array io.dirNames(String path)
-----
-
-Get directory entries.
-
- :: 
-
-_path_;; A path to a directory
-_returns_;; An array with the directory names
-****
-
-****
-[[error]]
-[float]
-==== *error()* ==== 
-
-[source,javascript]
-----
-void io.error(String text)
-----
-
-Shows an error message in the browser window.
-
- :: 
-
-_text_;; The message to show
-****
-
-****
-[[notify]]
-[float]
-==== *notify()* ==== 
-
-[source,javascript]
-----
-void io.notify(String text)
-----
-
-Shows a message in the browser window.
-
- :: 
-
-_text_;; The message to show
-****
-
-****
-[[print]]
-[float]
-==== *print()* ==== 
-
-[source,javascript]
-----
-void io.print(String text, [String stream])
-----
-
-Print text to +stdout+ or +stderr+ 
-
- :: 
-
-_text_;; the text to print
-_stream_;; pass +"stderr"+ to print to stderr, optional
-****
-
-****
-[[prompt]]
-[float]
-==== *prompt()* ==== 
-
-[source,javascript]
-----
-String io.prompt(String text, [Boolean visible])
-----
-
-Gets user input synchronously.
-
- :: 
-
-_text_;; The message for the prompt
-_visible_;; Whether the chars should be visible, pass +false+ for a password
-prompt, default +true+, optional
-_returns_;; The text that was entered or +null+
-****
-
-****
-[[read]]
-[float]
-==== *read()* ==== 
-
-[source,javascript]
-----
-String io.read(String path)
-----
-
-Read from a file.
-
- ::
-
-_path_;; Path to a file that should be read
-_returns_;; A string with the file content
-****
-
-****
-[[write]]
-[float]
-==== *write()* ==== 
-
-[source,javascript]
-----
-Boolean io.write(String path, String mode, String text)
-----
-
-Write to a file
-
- ::
-
-_path_;; Path to a file to write to
-_mode_;; Either +"a"+ to append to the file, or +"w"+ to strip the file or
-create a new file.
-_text_;; The text that should be written to the file
-_returns_;; +true+ if writing was successful
-****
-
-
-====
-.Example
-[source,javascript]
----------------------------------
-var text = io.read("/home/foo/textfile.txt");
-io.print(text);
---------------------------------
-====
-
-[[system]]
-=== system ===
-
-The +system+ object implements system methods.
-
-****
-[[fileTest]]
-[float]
-==== *fileTest()* ==== 
-
-[source,javascript]
-----
-Boolean system.fileTest(String path, FileTest flags)
-----
-
-Checks for <<FileTest>> flags on a file.
-
- ::
-
-_path_;; Path to a file to check
-_flags_;; The flags to test
-_returns_;; +true+ if any of the test on the flags is true
-****
-
-****
-[[getEnv]]
-[float]
-==== *getEnv()* ==== 
-
-[source,javascript]
-----
-String system.getEnv(String name) 
-----
-
-Get a system environment variable
-
- :: 
-
-_name_;; Name of the variable
-_returns_;; The variable or +null+ if the variable wasn't found
-****
-
-****
-[[mkdir]]
-[float]
-==== *mkdir()* ==== 
-
-[source,javascript]
-----
-Boolean system.mkdir(String path, Number mode)
-----
-
-Creates a directory and all parent directories.
-
- ::
-
-_path_;; Path to create
-_mode_;; The permissions the directory will get
-_returns_;; +true+ if creation was successful or directory already existed 
-****
-
-****
-[[spawn]]
-[float]
-==== *spawn()* ==== 
-
-[source,javascript]
-----
-Deferred system.spawn(String command, [Function stdin], [Function stderr])
-----
-
-Executes a shell command using the default search path
-
- ::
-
-_command_;; The command to execute
-_stdout(String)_;; Callback function for stdin, pass +null+ if only stderr is
-needed, optional
-_stderr(String)_;; Callback function for stderr, optional
-_returns_;; A deferred, it will be resolved if the child exits
-normally, it will be rejected if the child process exits abnormally, the first
-parameter of the reject function will be the status code of the child process. 
-****
-
-****
-[[spawnSync]]
-[float]
-==== *spawnSync()* ==== 
-
-[source,javascript]
-----
-Object system.spawnSync(String command)
-----
-
-Executes a shell command synchronously using the default search path
-
- ::
-
-_command_;; The command to execute
-_returns_;; An object that contains +stdout+, +stderr+ and +status+.
-****
-
-====
-.Example
-[source,javascript]
-------------
-var home = system.getEnv("HOME");
-// asynchronous wrapped read
-function asyncread(filename) {
-  system.spawn("cat " + filename, function (response) {
-      ...
-  });
-}
-asyncread(home + "/.bashrc");
-------------
-====
-
-
-[[tabs]]
-=== tabs ===
-The +tabs+ object implements methods and properties to get +webview+ objects. 
-
-==== Properties ====
-
-****
-[float]
-==== *current* ====
-
-[source,javascript]
-----
-tabs.current        webview     read
-----
-
-The currently focused webview
-****
-
-****
-[float]
-==== *length* ====
-
-[source,javascript]
-----
-tabs.length         Number      read
-----
-
-Total number of tabs
-****
-
-****
-[float]
-==== *number* ==== 
-
-[source,javascript]
-----
-tabs.number         Number      read
-----
-
-Number of the currently focused tab
-****
-
-
-
-
-==== Methods ====
-
-****
-[float]
-==== *nth()* ====
-
-[source,javascript]
-----
-webview tabs.nth(Number n) 
-----
-
-Gets the webview object of the nth tab
-
- ::
-
-_n_;; Number of the tab
-_returns_;; The corresponding <<webview>>
-****
-
-====
-.Example
-[source,javascript]
-----
-var c = tabs.current;
-tabs.nth(2).loadUri(c.uri);
-----
-====
-
-
-[[util]]
-=== util ===
-
-The +util+ object implements helper methods.
-
-****
-[float]
-==== *getBody()* ====
-
-[source,javascript]
-----
-String util.getBody(Function func) 
-----
-
-Gets the body of a function, useful for scripts that will be injected into
-sites. 
-
- ::
-
-_func_;; A function 
-_returns_;; The body of the function as a string
-****
-
-****
-[float]
-==== *getMode()* ====
-
-[source,javascript]
-----
-Number util.getMode() 
-----
-
-Gets the the current mode.
-
-_returns_;; The mode, see <<Modes>> for possible modes.
-****
-
-
-
-****
-[[domainFromHost]]
-[float]
-==== *domainFromHost()* ==== 
-
-[source,javascript]
-----
-String util.domainFromHost(String hostname)
-----
-
-Gets the base domain name from a hostname where the base domain name is the
-effective second level domain name, e.g. for www.example.com it will be
-example.com, for www.example.co.uk it will be example.co.uk.
-
- :: 
-
-_hostname_;; a hostname
-_returns_;; the base domain 
-****
-
-****
-[[getSelection]]
-[float]
-==== *getSelection()* ====
-
-[source,javascript]
-----
-String util.getSelection()
-----
-
-Get selected text from the focused webview.
-
- :: 
-
-_returns_;; The selection or null if no text was selected.
-****
-
-
-****
-[[markupEscape]]
-[float]
-==== *markupEscape()* ==== 
-
-[source,javascript]
-----
-String util.markupEscape(String text)
-----
-
-Escapes text for usage with pango markup.
-
-_text_;; A text to escape
-_returns_;; The escaped text or 'null';
-****
-
-dwb also adds additional methods to builtin objects 
-
-****
-[[forEach]]
-[float]
-==== *Object.forEach()* ==== 
-[source,javascript]
-----
-void Object.forEach(Function func(String key, Object value, Object this))
-----
-
-Executes a function for each enumarable property of +this+ similar to
-Array.forEach.
-
- :: 
-
-_func_;; The function to execute
-_key_;; The property name
-_value_;; The property value
-_this_;; The object forEach is called on
-****
-
-****
-[[fastIndexOf]]
-[float]
-==== *Array.fastIndexOf()* ==== 
-[source,javascript]
-----
-Number Array.fastIndexOf(Object object)
-----
-
-This method is basically the same as +Array.indexOf+ but without type checking.
-
- :: 
-
-_object_;; The object to search for
-_returns_;; The index in the array or +-1+ if the Object wasn't found.
-****
-
-****
-[[fastLastIndexOf]]
-[float]
-==== *Array.fastLastIndexOf()* ==== 
-[source,javascript]
-----
-Number Array.fastLastIndexOf(Object object)
-----
-
-This method is basically the same as +Array.lastIndexOf+ but without type checking.
-
- :: 
-
-_object_;; The object to search for
-_returns_;; The index in the array or +-1+ if the Object wasn't found.
-****
-
-****
-[[fastLastIndexOf]]
-[float]
-==== *Function.debug()* ==== 
-[source,javascript]
-----
-void Function.debug([Object scope])
-----
-
-A wrapper method for debugging callbacks, especially useful if it is combined
-with <<scriptandthis,script>>. 
-
- :: 
-
-_scope_;; *script* or *this*, optional
-_returns_;; A new function that calls script.debug on errors.
-****
-
-****
-.Example
-[source,javascript]
-----
-bind("x", function() { ... }.debug(script));
-// or equivalently 
-bind("x", script.debug(function() { ... }));
-
-// is a shorthand for
-
-bind("x", function () { 
-    try { 
-        ... 
-    }
-    catch (e) { 
-        script.debug(e); 
-    }
-});
-----
-****
-
-[[clipboard]]
-=== clipboard ===
-
-****
-[[clipboardget]]
-[float]
-==== *get()* ==== 
-[source,javascript]
-----
-[void|String] clipboard.get(Selection selection, [Function callback])
-----
-
-Gets the X11 clipboard.
-
- :: 
-
-_selection_;; The <<Selection>> to get
-_callback_;; If a callback function is used the clipboard will be fetched
-asynchronously, the first parameter will be the content of the clipboard, else
-it will be fetched synchronously
-_returns_;; If no callback was provided it returns the text content of the
-clipboard.
-****
-
-****
-[[clipboardset]]
-[float]
-==== *set()* ==== 
-[source,javascript]
-----
-void clipboard.set(Selection selection, String text)
-----
-
-Sets the X11 clipboard.
-
- :: 
-
-_selection_;; The <<Selection>> to set
-_text_;; Text that will be stored in the clipboard.
-****
-
-[[gui]]
-=== gui ===
-Most gtk-widgets used by dwb can be accessed from scripts, an overview of the
-layout can be found under
-link:http://portix.bitbucket.org/dwb/resources/layout.html[].
-
-****
-[float]
-==== *window* ====
-
-[source,javascript]
-----
-gui.window        GtkWindow     read
-----
-
-The main window.
-****
-
-****
-[float]
-==== *mainBox* ====
-
-[source,javascript]
-----
-gui.mainBox        GtkBox     read
-----
-
-The the main container, child of *gui.window*. 
-****
-
-****
-[float]
-==== *tabBox* ====
-
-[source,javascript]
-----
-gui.tabBox        GtkBox     read
-----
-
-The box used for tab labels, child of *gui.mainBox*.
-****
-
-****
-[float]
-==== *contentBox* ====
-
-[source,javascript]
-----
-gui.contentBox        GtkBox     read
-----
-
-The box used for the main content, it contains all
-webviews, child of *gui.mainBox*.
-****
-
-****
-[float]
-==== *statusWidget* ====
-
-[source,javascript]
-----
-gui.statusWidget      GtkEventBox     read
-----
-
-The outmost statusbar widget, used for setting
-the statusbars colors, child of *gui.mainBox*. 
-****
-
-****
-[float]
-==== *statusAlignment* ====
-
-[source,javascript]
-----
-gui.statusAlignment      GtkAlignment     read
-----
-
-Used for the statusbar alignment, child
-of *gui.statusWidget*. 
-****
-
-****
-[float]
-==== *statusBox* ====
-
-[source,javascript]
-----
-gui.statusBox      GtkBox     read
-----
-
-The box that contains the statusbar widgets,
-grandchild of *gui.statusAlignment*.
-****
-
-****
-[float]
-==== *messageLabel* ====
-
-[source,javascript]
-----
-gui.messageLabel      GtkBox     read
-----
-
-Label used for notifications, first child of
-*gui.statusBox*.
-****
-
-****
-[float]
-==== *entry* ====
-
-[source,javascript]
-----
-gui.entry      GtkEntry     read
-----
-
-The entry, second child of *gui.statusBox*.
-****
-
-****
-[float]
-==== *uriLabel* ====
-
-[source,javascript]
-----
-gui.uriLabel      GtkLabel     read
-----
-
-The entry, second child of *gui.statusBox*.
-****
-
-****
-[float]
-==== *statusLabel* ====
-
-[source,javascript]
-----
-gui.statusLabel      GtkLabel     read
-----
-
-Label used for status information, fourth child of *gui.statusBox*.
-****
-
-[[Deferred]]
-=== Deferred ===
-
-Deferred objects can be used to manage asynchronous operations. It can trigger a
-callback function when an asynchrounous operation has finished, and allows
-chaining of callbacks. 
-Deferred basically has 2 callback chains, a _done_-chain and a _fail_-chain.
-If a asynchronous operation is successful the deferred should be resolved and
-the done callback chain of the deferred is called. 
-If a asynchronous operation fails the deferred should be rejected and
-the fail callback chain of the deferred is called. 
-
-Deferreds implement the following methods: 
-
-**** 
-[float]
-==== *always()* ==== 
-
-[source,javascript]
-----
-Deferred Deferred.always(Function callback) 
-----
-
-Registers a function for then done and fail chain.
-
- ::
-
-_callback_;; A callback function that will be called when the Deferred is
-resolved or rejected. If the function returns a deferred the original deferred will be replaced with
-the new deferred.
-_returns_;; A new deferred that can be used to chain callbacks. 
-****
-
-**** 
-[float]
-==== *done()* ==== 
-
-[source,javascript]
-----
-Deferred Deferred.done(Function callback) 
-----
-
-Registers a function for the done-chain.
-
- ::
-
-_callback_;; A callback function that will be called when the Deferred is
-resolved. If the function returns a deferred the original deferred will be replaced with
-the new deferred.
-_returns_;; A new deferred that can be used to chain callbacks. 
-****
-
-**** 
-[float]
-==== *fail()* ==== 
-
-[source,javascript]
-----
-void Deferred.fail(Function callback) 
-----
-
-Registers a function for the fail-chain.
-
- ::
-
-_callback_;; A callback function that will be called when the deferred is
-rejected. If the function returns a deferred the original deferred will be replaced with
-the new deferred.
-_returns_;; A new deferred that can be used to chain callbacks. 
-****
-
-**** 
-[float]
-==== *reject()* ==== 
-
-[source,javascript]
-----
-void Deferred.reject(arguments) 
-----
-
-Rejects a deferred, the fail-chain is called when a deferred is rejected. 
-
- ::
-
-_arguments_;; Arguments passed to the _fail_ callbacks.
-****
-
-****
-[float]
-==== *resolve()* ==== 
-
-[source,javascript]
-----
-Deferred Deferred.resolve(arguments) 
-----
-
-Resolves a deferred, the done-chain is called when a deferred is resolved. 
-
- ::
-
-_arguments_;; Arguments passed to the _done_ callbacks.
-****
-
-****
-[float]
-==== *then()* ==== 
-
-[source,javascript]
-----
-Deferred Deferred.then(Function ondone, Function onfail) 
-----
-
-Registers a function for the done and fail chain.
-
- ::
-
-_ondone_;; A callback function that will be called when the deferred is
-resolved. If the function returns a deferred the original deferred will be replaced with
-the new deferred.
-_onfail_;; A callback function that will be called when the deferred is
-rejected. If the function returns a deferred the original deferred will be replaced with
-the new deferred.
-_returns_;; A new deferred that can be used to chain callbacks. 
-****
-
-Deferred also implements a static method: 
-
-****
-[float]
-==== *when()* ==== 
-
-[source,javascript]
-----
-Value Deferred.when(Value value, Function ondone, Function onfail) 
-----
-
-Static method that can be used for synchronous and asynchronous operations. If
-if *value* is a Deferred *ondone* is called when the Deferred is resolved and
-*onfail* is called if the Deferred is rejected, otherwise ondone is called 
-and value is the first parameter of the callback.
-
- ::
-
-_value_;; A Deferred or a value.
-_ondone_;; Callback function.
-_onfail_;; Callback function.
-_returns_;; The value.
-****
-
-
-==== *Examples* ====
-
-The builtin function system.spawn returns a deferred: 
-[source,javascript]
----------------------------------
-system.spawn("command").then(
-    function() 
-    {
-        /* called when execution was  successful */
-    }, 
-    function(errorcode) 
-    {
-        /* called when execution wasn't successful */
-    }
-);
----------------------------------
-
-Simple usage of a deferred:
-[source,javascript]
----------------------------------
-function loadUri(uri) {
-    var d = new Deferred();
-    tabs.current.loadUri(uri, function(wv) {
-        if (wv.loadStatus == LoadStatus.finished) 
-        {
-            d.resolve("Finished");
-            return true;
-        }
-        else if (wv.loadStatus == LoadStatus.failed) 
-        {
-            d.reject("Failed");
-            return true;
-        }
-    });
-    return d;
-}
-
-loadUri("http://www.example.com").then(
-    function(response) {
-        io.print(response); // Finished
-    }, 
-    function(response) {
-        io.print(response); // Failed
-    }
-);
----------------------------------
-
-Chaining of a deferred: 
-
-[source,javascript]
----------------------------------
-function foo() 
-{
-    var d = new Deferred();
-    timerStart(2000, function() {
-        d.reject("rejected");
-    });
-    return d;
-}
-
-function onResponse(response) 
-{
-    io.print(response);
-}
-
-// Will print "rejected" twice to stdout after 2 seconds
-foo().fail(onResponse).fail(onResponse);
----------------------------------
-
-Note that if the deferred is rejected only the fail chain is called, when it is
-resolved only the done chain is called. 
-[source,javascript]
----------------------------------
-function foo() 
-{
-    var d = new Deferred();
-    timerStart(2000, function() {
-        d.reject("rejected");
-        // Already rejected, will not execute the done chain
-        d.resolve("rejected");
-    });
-    return d;
-}
-
-function onResponse(response) 
-{
-    io.print(response);
-}
-
-// Only the fail will be executed
-
-foo().done(onResponse).fail(onResponse);
-foo().fail(onResponse).done(onResponse);
----------------------------------
-
-Changing the deferred in a callback chain:
-
-[source,javascript]
----------------------------------
-function foo(message) 
-{
-    var d = new Deferred();
-    timerStart(2000, function() {
-        d.resolve(message);
-    });
-    return d;
-}
-function callback1(response) 
-{
-    io.print(response); // Prints "foo" after 2 seconds
-
-    // Return a new Deferred, will replace the old one.
-    return foo("bar");
-}
-function callback2(response) 
-{
-    io.print(response); // Prints "bar" after 4 seconds
-}
-
-foo("foo").done(callback1).done(callback2);
----------------------------------
-
-Using Deferred.when
-
-[source,javascript]
----------------------------------
-function asyncOperation() {
-    var d = new Deferred();
-    .... 
-    return d;
-}
-function syncOperation()
-{
-    var result = {};
-    .... 
-    return result;
-}
-Deferred.when(asyncOperation(), function() {...});
-Deferred.when(syncOperation(), function() {...});
----------------------------------
-
-[[settings]] 
-=== settings ===
-
-Readonly object that can be used to query dwb's current settings, all settings
-can also be used in camelcase, to modify settings *execute* can be used.
-
-.Example
-
-====
-[source,javascript]
----------------------------------
-if (settings.enablePrivateBrowsing == true)
-    execute("set enable-private-browsing false");
----------------------------------
-====
-
-
-[[Webkitobjects]]
-== Webkit objects ==
-
-All webkit objects correspond to GObject objects, i.e. they have the same
-properties, but the javascript properties are all camelcase. 
-For example, a +WebKitWebView+ has the property +zoom-level+, the corresponding
-javascript property is +zoomLevel+:
-
-====
-[source,javascript]
----------------------------------
-var webview = tabs.current
-webview.zoomLevel = webview.zoomLevel * 2;
----------------------------------
-====
-
-To check if an object is derived from GObject the instanceof operator can be
-used: 
-
-====
-[source,javascript]
----------------------------------
-if (myObject instanceof GObject) 
-{
-  ...
-}
----------------------------------
-====
-
-All Objects derived from GObjets implement the following methods. 
-
-//Webkit objects should not be compared using +==+, since it may happen that the
-//same gobject is represented by different javascript objects, instead every
-//webkit object implements an equals method, all Objects derived from GObjets
-//implement the following functions. 
-//
-//****
-//[float]
-//==== *equals()* ==== 
-//
-//[source,javascript]
-//----
-//Boolean object.equals(Object compareObject) 
-//----
-//
-//Compare two webkit objects
-//
-// ::
-//
-//_compareObject_;; The object to compare
-//_returns_;; +true+ if the the corresponding gobjects are equal
-//****
-
-****
-[float]
-==== *blockSignal()* ==== 
-
-[source,javascript]
-----
-Number object.blockSignal(Number signalid)
-----
-
-Blocks emission of a gobect signal.
-
- ::
-
-_signalid_;; The signalid returned from *object.connect*
-****
-
-
-****
-[float]
-==== *connect()* ==== 
-
-[source,javascript]
-----
-Number object.connect(String name, Function callback, [Boolean after]) 
-----
-
-Connect to a gobject-signal, note that all signals are connected using the 
-_signal::_- or with _notify::_-prefix. If connecting to a signal the 
-_signal::_-prefix must be omitted. The callback function will have the
-same parameters as the GObject signal callback, however some parameters may be
-undefined if they cannot be converted to javascript objects. 
-All signal handlers are executed after dwb's default handler.
-
- ::
-
-_name_;; The signal name to connect to.
-_callback_;; Callback function that will be called when the signal is emitted.
-_after_;; Whether to install the handler after the default handler, default
-false.
-_returns_;; The signal id of the signal.
-****
-
-****
-[float]
-==== *connectBlocked()* ==== 
-
-[source,javascript]
-----
-Number object.connectBlocked(String name, Function callback, [Boolean after]) 
-----
-
-Connect to a gobject-signal but block the emission of the own callback during
-execution of the callback, useful if the object is connected to a notify event
-and the the property is changed in the callback function. 
-
- ::
-
-_name_;; The signal name to connect to.
-_callback_;; Callback function that will be called when the signal is emitted.
-_after_;; Whether to install the handler after the default handler, default
-false.
-_returns_;; The signal id of the signal.
-****
-
-****
-[float]
-==== *disconnect()* ==== 
-
-[source,javascript]
-----
-Boolean object.disconnect(Number id) 
-----
-
-Disconnect from a gobject-signal.
-
- ::
-
-_id_;; The signal id obtained from <<connect>>
-_returns_;; +true+ if the signal was disconnected
-****
-
-****
-[float]
-==== *notify()* ==== 
-
-[source,javascript]
-----
-Number object.notify(String name, Function callback, [Boolean after]) 
-----
-
-Wrapper function for property-change notification but with signal blocking, same as 
-_object.connect("notify::" +  name, callback, after);_.
-
- ::
-
-_name_;; The property name to connect to, can also be in camelcase.
-_callback_;; Callback function that will be called when the property changes.
-_after_;; Whether to install the handler after the default handler.
-_returns_;; The signal id of the signal.
-****
-
-****
-[float]
-==== *notifyBlocked()* ==== 
-
-[source,javascript]
-----
-Number object.notifyBlocked(String name, Function callback, [Boolean after]) 
-----
-
-Wrapper function for property-change notification but with signal blocking, same as 
-_object.connectBlocked("notify::" +  name, callback, after);_.
-
- ::
-
-_name_;; The property name to connect to, can also be in camelcase.
-_callback_;; Callback function that will be called when the property changes.
-_after_;; Whether to install the handler after the default handler.
-_returns_;; The signal id of the signal.
-****
-
-
-****
-[[getPrivate]]
-[float]
-==== *getPrivate()* ==== 
-[source,javascript]
-----
-Object GObject.getPrivate(key, identifier)
-----
-
-Gets a value previously set with GObject.setPrivate.
-
- :: 
-
-_key_;; The property name
-_identifier_;; The identifier passed to <<setPrivate>>
-_returns_;; The object set with <<setPrivate>> or +null+.
-****
-
-****
-[[setPrivate]]
-[float]
-==== *setPrivate()* ==== 
-[source,javascript]
-----
-void GObject.setPrivate(key, value, identifier)
-----
-
-Associates a private value with an object only in the calling script.
- :: 
-
-_key_;; The property name
-_value_;; The property value
-_identifier_;; A local object to identify the calling script, the identifier
-must either be of type object or of type function.
-****
-
-****
-[float]
-==== *unblockSignal()* ==== 
-
-[source,javascript]
-----
-Number object.unblockSignal(Number signalid)
-----
-
-Unblocks a signal previously blocked with *object.blockSignal*.
-
- ::
-
-_signalid_;; The signalid returned from *object.connect*
-****
-
-
-====
-[float]
-==== *Examples* ====
-
-Connect to signals:
-
-[source,javascript]
-------------
-tabs.current.connect("notify::load-status", function() {
-  io.print("Status changed");
-});
-tabs.current.notify("loadStatus", function() {
-  io.print("Status changed");
-});
-tabs.current.notify("load-status", function() {
-  io.print("Status changed");
-});
-
-// Similar to signals.connect("navigation", ...)
-signals.connect("createTab", function(wv) { 
-    wv.connect("navigation-policy-decision-requested", function(wv, frame, request, action, policy) {
-        // block google.com
-        if (/google\.com/.test(request.uri))
-            return true;
-    });
-});
-------------
-
-Setting/getting private values:
-
-[source,javascript]
-------------
-var self = this;
-signals.connect("loadCommitted", function(wv) {
-  wv.setPrivate("foo", "bar", self);
-});
-signals.connect("loadFinished", function(wv) {
-  io.print(wv.getPrivate("foo", self));
-});
-------------
-====
-
-
-
-
-//An exception is the webview object, for webview objects +==+ always gives the
-//same result as +equals+.
-
-
-[[webview]]
-=== webview ===
-The +webview+ object represents the widget that actually displays the site
-content. 
-
-==== Properties ====
-
-The properties correspond to the gobject properties in camelcase. Additional
-properties are
-
-****
-[float]
-==== *allFrames* ====
-
-[source,javascript]
-----
-wv.allFrames        array of frames     read
-----
-
-All frames of a webview including the mainframe
-****
-
-****
-[float]
-==== *focusedFrame* ====
-
-[source,javascript]
-----
-wv.focusedFrame        frame     read
-----
-
-The focused frame of the webview
-****
-
-****
-[float]
-==== *historyList* ====
-
-[source,javascript]
-----
-wv.historyList        historylist     read
-----
-
-The history of the webview
-****
-
-
-****
-[float]
-==== *mainFrame* ====
-
-[source,javascript]
-----
-wv.mainFrame        frame     read
-----
-
-The main frame of the webview
-****
-
-****
-[float]
-==== *number* ====
-
-[source,javascript]
-----
-wv.number        Number     read
-----
-
-The number of the webview, starting at 0
-****
-
-****
-[float]
-==== *scrolledWindow* ====
-
-[source,javascript]
-----
-wv.scrolledWindow        GtkScrolledWindow     read
-----
-
-The parent widget of every webview, it
-is used for scrolling the webview.
-****
-
-****
-[float]
-==== *tabWidget* ====
-
-[source,javascript]
-----
-wv.tabWidget        GtkEventBox     read
-----
-
-The main widget for tab labels, used for coloring
-tabs, child of *gui.tabBox*.
-****
-
-****
-[float]
-==== *tabBox* ====
-
-[source,javascript]
-----
-wv.tabBox        GtkBox     read
-----
-
-Horizontal box, child of *wv.tabWidget*.
-****
-
-****
-[float]
-==== *tabIcon* ====
-
-[source,javascript]
-----
-wv.tabIcon        GtkImage     read
-----
-
-Favicon widget, child of *wv.tabBox*.
-****
-
-****
-[float]
-==== *tabLabel* ====
-
-[source,javascript]
-----
-wv.tabLabel        GtkLabel     read
-----
-
-Text label of a tab, child of *wv.tabBox*.
-****
-
-==== Methods ====
-
-****
-[float]
-[[inject]]
-==== *inject()* ==== 
-
-[source,javascript]
-----
-String wv.inject(String script, [Object  argument], [Boolean global]) 
-----
-
-Injects a script into a webview
-
- ::
-
-_script_;; The script to inject
-_argument_;; If the script isn't injected into the global scope the script is
-wrapped inside a function. +argument+ then is accesible via
-+arguments+ in the injected script, optional 
-_global_;; +true+ to inject it into the global scope, +false+ to encapsulate it
-in a function, optional
-_returns_;; The return value of the script. If the script is injected globally
-inject always returns +null+. The return value is always converted to a string.
-To return objects call JSON.parse on the return value. 
-****
-
-****
-[float]
-==== *history()* ====
-
-[source,javascript]
-----
-void wv.history(Number steps) 
-----
-
-Loads a history item +steps+ away from the current history item
-
- ::
-
-_steps_;; Number of steps, pass a negative value to go back in history
-****
-
-****
-[float]
-==== *loadUri()* ==== 
-
-[source,javascript]
-----
-Boolean wv.loadUri(String uri, [Function callback]) 
-----
-
-Loads an uri in a webview. 
-
- ::
-
-_uri_;; The uri to load
-_callback_;; A callback function that will be called when the load status
-changes, return +true+ to stop the emission, optional
-_returns_;; +true+ if the uri is loaded
-****
-
-
-****
-[float]
-==== *reload()* ====
-
-[source,javascript]
-----
-void wv.reload(void) 
-----
-
-Reload a webview 
-****
-
-****
-[float]
-==== *stopLoading()* ====
-
-[source,javascript]
-----
-void wv.stopLoading(void) 
-----
-
-Stops any ongoing loading.
-****
-
-****
-[float]
-==== *toPng()* ====
-
-[source,javascript]
-----
-Number wv.toPng(String filename, [Number width, Number height], [Boolean keepAspect]) 
-----
-
-Renders a webview to a png file.
-
-_filename_;; The filename for the png.
-_width_;; The width of the png, if width is < 0 and height is > 0 the image will
-have the same aspect ratio as the original webview, optional.
-_height_;; The height of the png, if height is < 0 and width is > 0 the image
-will have the same aspect ratio as the original webview, optional, mandatory
-if width is set. 
-_keepAspect_;; Whether to keep the ascpect ratio, if set to true the new
-image will have the same aspect ratio as the original webview, width and
-height are taken as maximum sizes and must both be > 0, optional.
-_returns_;; A cairo_status_t (0 on success) or -1 if an error occured.
-****
-
-
-
-
-====
-[float]
-==== *Example* ====
-[source,javascript]
-------------
-var wv = tabs.current;
-
-wv.loadUri("http://www.example.com", function() {
-  if (wv.loadStatus == LoadStatus.finished) {
-    wv.inject("alert('Hello ' + wv.uri + '!!!');");
-    return true;
-  }
-});
-------------
-====
-
-
-NOTE: If a script is injected from a <<loadStatus>>-callback the script must be
-injected after +LoadStatus.committed+ has been emitted.
-On +LoadStatus.committed+ the document 
-hasn't been created, if the script modifies the DOM it should be injected when
-+LoadStatus.finished+ or +documentLoaded+ is emitted. 
-If only +LoadStatus.committed+ or +loadFinished.committed+ are used it is better
-to use the corresponding signals instead to reduce overhead. 
-
-
-[[frame]]
-=== frame ===
-
-A frame represents a +frame+ or +iframe+. Due to same origin policy it
-is not possible to inject scripts from a <<webview>> into iframes with a
-different domain. For this purpose the +frame+ object can be used. 
-
-==== Properties ====
-
-The properties correspond to the gobject properties in camelcase.
-Additional properties are 
-
-****
-[float]
-==== *domain* ====
-
-[source,javascript]
-----
-frame.domain        String     read
-----
-
-The domain name of the frame which is the effective second level domain
-****
-
-****
-[float]
-==== *host* ====
-
-[source,javascript]
-----
-frame.host          String     read
-----
-
-The host name of the frame
-****
-
-====
-To get the domain or hostname of a webview 
-[source,javascript]
-----
-webview.mainFrame.domain
-webview.mainFrame.host
-----
-can be used.
-====
-
-
-
-==== Methods ====
-
-****
-[float]
-==== *inject()* ==== 
-
-[source,javascript]
-----
-Boolean frame.inject(String script, [Object argument], [Boolean global])
-----
-
-Injects a script into a frame, see also <<inject,webview.inject>> for details.
-****
-
-
-[[Download]]
-=== download ===
-
-Corresponds to a +WebKitDownload+. 
-
-==== Constructor ====
-
-****
-[float]
-==== *Download()* ==== 
-[source,javascript]
-----
-new Download(String uri)
-----
-
-Constructs a new download
-
- ::
-_uri_;; The uri of the download
-****
-
-==== Methods ====
-
-****
-[float]
-==== *start()* ==== 
-
-[source,javascript]
-----
-Boolean download.start([Function callback])
-----
-
-Starts a download
-
- ::
-
-_callback_;; A callback function that will be executed whenever the
-<<DownloadStatus>> changes, return +true+ to stop the emission, optional.
-****
-
-
-****
-[float]
-==== *cancel()* ==== 
-
-[source,javascript]
-----
-void download.cancel()
-----
-
-Cancels a download
-****
-
-====
-.Example 
-[source,javascript]
-------
-var download = new Download("http://www.example.org/foo.pdf");
-var filename = "/tmp/" + download.suggestedFilename;
-download.destinationUri = "file://" + filename;
-download.start(function () {
-  if (download.status == DownloadStatus.finished) {
-    system.spawn("xpdf " + filename);
-  }
-});
-------
-====
-
-[[HistoryList]]
-=== historylist ===
-Corresponds to a +WebkitWebBackForwardList+. 
-
-==== Properties ====
-
-****
-[float]
-==== *backLength* ====
-
-[source,javascript]
-----
-historylist.backLength          Number     read
-----
-Number of items that precede the current item
-****
-
-****
-[float]
-==== *forwardLength* ====
-
-[source,javascript]
-----
-historylist.forwardLength          Number     read
-----
-Number of items that succeed the current item
-****
-
-==== Methods ====
-
-****
-[float]
-==== *getItem()* ==== 
-
-[source,javascript]
-----
-WebKitWebHistoryItem historylist.getItem(Number position)
-----
-
-Gets a WebKitWebHistoryItem. 
-
- ::
-
-_position_;; The position of the item where 0 corresponds to the current item.
-_returns_;; A WebKitWebHistoryItem.
-****
-
-[[GtkWidgets]]
-== Gtk Widgets ==
-
-It is possible to create new widgets but only widgets that are currently used by
-dwb can be created, the widgets used by dwb can be found under 
-link:http://portix.bitbucket.org/dwb/resources/layout.html[].
-
-New widgets can be created with
-****
-[float]
-==== *GtkWidget()* ==== 
-[source,javascript]
-----
-new GtkWidget(String type)
-----
-
-Constructs a new widget
-
- ::
-_name_;; The type of the widget, e.g. "GtkLabel"
-****
-
-
-All created widgets implement the following methods: 
-
-****
-[float]
-==== *destroy()* ==== 
-
-[source,javascript]
-----
-void GtkWidget.destroy()
-----
-
-Destroys a widget. Note that only newly created widgets can be destroyed.
-****
-
-Widgets that implement the GtkBox interface implement the following methods:
-
-****
-[float]
-==== *packEnd()* ==== 
-
-[source,javascript]
-----
-void GtkWidget.packEnd(GtkWidget child, boolean expand, boolean fill, int padding)
-----
-
-Adds a widget to a GtkBox.
-
- ;;
-
-_child_:: The child widget
-_expand_:: Whether to expand the widget
-_fill_:: Whether to fill the remaining space
-_padding_:: Padding in the box
-****
-
-****
-[float]
-==== *packStart()* ==== 
-
-[source,javascript]
-----
-void GtkWidget.packStart(GtkWidget child, boolean expand, boolean fill, int padding)
-----
-
-Adds a widget to a GtkBox.
-
- ;;
-
-_child_:: The child widget
-_expand_:: Whether to expand the widget
-_fill_:: Whether to fill the remaining space
-_padding_:: Padding in the box
-****
-
-****
-[float]
-==== *reorderChild()* ==== 
-
-[source,javascript]
-----
-void GtkWidget.reorderChild(GtkWidget child, Number position)
-----
-
-Moves a widget to a new position.
-
- ;;
-
-_child_:: The child widget
-_position_:: The new position
-****
-
-Widgets derived from GtkContainer implement the following methods:
-
-****
-[float]
-==== *add()* ==== 
-
-[source,javascript]
-----
-void GtkWidget.add(GtkWidget child)
-----
-
-Adds a widget to a GtkContainer.
-
-    ;;
-
-_child_:: The child widget
-****
-
-====
-.Example 
-[source,javascript]
-------
-var label = new GtkWidget("GtkLabel");
-gui.statusBox.packStart(label, false, false, 0);
-label.label = "foobar";
-label.visible = true;
-------
-====
-
-
-== Signals ==
-With the +signals+ object *dwb* communicates with the script on certain events. 
-To connect to a signal one can call the connect method that is implemented by
-the signals object, that takes 2 arguments, the name of the signal and a
-callback function. 
-
-The callback function has a varying number of parameters.
-The last paramter is always a json-object which might be empty or contain
-additional data relevant to the signal. 
-A callback function should either return +true+ or +false+ or nothing which is
-equivalent to +false+.
-If multiple callbacks are connected to the same signal and one callback
-function returns +true+ the overall return value will be +true+.
-
-*dwb* only emits signals as long as one callback is connected to a signal. To
-reduce overhead one should disconnect from signals when no longer
-needed. 
-
-The +signals+ object is not a readonly object, properties can be added to the
-object which are visible in all scripts but it should be avoided to add
-properties on the +signals+ object. +signals+ should only be used to connect to
-signals or define custom signals. 
-
-The +signals+ object implements the following methods
-
-=== Methods ===
-
-[[connect]]
-[float]
-==== *connect()* ====
-
-****
-[source,javascript]
-----
-Number signals.connect(String signal, Function callback) 
-----
-Connect to a signal
-
- ::
-
-_signal_;; The signal to connect to 
-_callback_;; The callback function which will be called when the signal is emitted
-_returns_;;  Unique id for this connection, can be passed to <<disconnect>>
-****
-
-[[connect]]
-[float]
-==== *connectWebView()* ====
-
-****
-[source,javascript]
-----
-void signals.connectWebView(String signal, Function callback) 
-----
-Connect all webviews to a GObject signal
-
- ::
-
-_signal_;; The signal to connect to 
-_callback_;; The callback function which will be called when the signal is
-emitted, the arguments of the callback function correspond to the GObject
-callback
-****
-
-
-****
-[[emit]]
-[float]
-==== *emit()* ==== 
-
-[source,javascript]
-----
-Boolean signals.emit(String signal,  ...)
-----
-
-Emits a signal with a variable number of arguments passed to the callback
-function
-
- :: 
-
-_signal_;; The signal to emit
-_..._;; Objects passed to the callback function
-_returns_;; Overall return value from all connected callback functions
-****
-
-****
-[[disconnect]]
-[float]
-==== *disconnect()* ==== 
-
-[source,javascript]
-----
-void signals.disconnect(Number id|Function callback) 
-----
-
-Disconnect from a signal 
-
- ::
-
-_id|callback_;; The id returned from <<connect>> or the callback function passed
-to <<connect>>. Note that if the same callback is used more than once
-the signal must be disconnected by id, otherwise the behaviour is undefined. 
-****
-
-****
-[[disconnectByName]]
-[float]
-==== *disconnectByName()* ==== 
-
-[source,javascript]
-----
-Boolean signals.disconnectByName(String signal) 
-----
-
-disconnect from all signals with matching name,
-It should be avoided to call +disconnectByName+
-on signals implemented by dwb since it will completely stop the emission of the
-signal in all scripts. 
-
- ::
-
-_signal_;; The callback function passed to <<connect>>
-_returns_;; +true+ if signals were disconnected, +false+ if no signal
-was disconnected
-****
-
-=== Emitted signals ===
-
-Custom signals can be created by simply calling 
-
-[source,javascript]
------
-signals.connect("nameOfNewSignal", callbackFunction);
------
-
-
-
-Signals emitted by dwb are the following:
-
-
-****
-[[buttonPress]]
-[float]
-==== *buttonPress* ==== 
-
-[source,javascript]
-----
-Boolean callback(webview, hittestresult, event) 
-----
-
-Emitted when a button is pressed on the <<webview>>, return +true+ to prevent
-the default action
-
- ::
-
-_webview_;; The <<webview>> which received the signal
-_hittestresult_;; Hittestresult under the cursor
-_event.button_;; The button that is pressed, usually a value between 1 and 5
-_event.state_;; A bitmap of modifiers pressed, see <<Modifier>>
-_event.time_;; The time in milliseconds when the button was pressed 
-_event.type_;; A <<ClickType>>
-_event.x_;; x-position relative to the window
-_event.xRoot_;; x-position relative to the screen
-_event.y_;; y-position relative to the window
-_event.yRoot_;; y-position relative to the screen
-****
-  
-****
-[[buttonRelease]]
-[float]
-==== *buttonRelease* ==== 
-
-[source,javascript]
-----
-Boolean callback(webview, hittestresult, event) 
-----
-
-Emitted when a button is released, return +true+ to prevent the default action
-
- ::
-
-_webview_;; The <<webview>> which received the signal
-_hittestresult_;; Hittestresult under the cursor
-_event_;; Same as <<buttonPress>> but without _event.type_
-****
-
-****
-[[changeMode]]
-[float]
-==== *changeMode* ==== 
-
-[source,javascript]
-----
-Boolean callback(webview, mode) 
-----
-
-Emitted when the mode changes, return true to prevent the change.
-
-  ::
-
-_webview_;; The focused webview
-_mode_;; A mode, see also <<Modes>> for possible modes
-****
-
-****
-[[close]]
-[float]
-==== *close* ==== 
-
-[source,javascript]
-----
-Boolean callback() 
-----
-
-Emitted when dwb is closed
-****
-
-****
-[[createTab]]
-[float]
-==== *createTab* ==== 
-
-[source,javascript]
-----
-Boolean callback(webview) 
-----
-
-Emitted when a tab is created
-
- ::
-
-_webview_;; The <<webview>> that corresponds to the created tab
-****
-
-****
-[[closeTab]]
-[float]
-==== *closeTab* ==== 
-
-[source,javascript]
-----
-Boolean callback(webview) 
-----
-
-Emitted when a tab is closed
-
- ::
-
-_webview_;; The <<webview>> that corresponds to the tab
-****
-
-****
-[[documentLoaded]]
-[float]
-==== *documentLoaded* ==== 
-
-[source,javascript]
-----
-void callback(webview, frame) 
-----
-
-Emitted when a the dom document of an frame has loaded.
-
- ::
-
-_webview_;; The <<webview>> that emitted the signal
-_frame_;; The frame that contains the document
-****
-
-****
-[[download]]
-[float]
-==== *download* ==== 
-
-[source,javascript]
-----
-Boolean callback(webview, download, json) 
-----
-
-Emitted before a download starts, before a file or action has been chosen,
-return +true+ if the signal was handled. 
-
- ::
-
-_webview_;; The <<webview>> that emitted the signal
-_download_;; The <<Download>> 
-_json.referer_;; The referer
-_json.mimeType_;; The mimetype of the file
-****
-
-****
-[[downloadStart]]
-[float]
-==== *downloadStart* ==== 
-
-[source,javascript]
-----
-Boolean callback(download, json) 
-----
-
-Emitted before a download starts after a path or application has been chosen, 
-return +true+ if the signal was handled. Note that destinationUri has not been
-set on the download.
-
- ::
-
-_download_;; The <<Download>> 
-_json.referer_;; The referer
-_json.mimeType_;; The mimetype of the file
-_json.destinationUri_;; The chosen destination path or +null+ if an application was chosen.
-_json.application_;; The chosen application or +null+ if a path was chosen.
-****
-
-
-****
-[[downloadStatus]]
-[float]
-==== *downloadStatus* ==== 
-
-[source,javascript]
-----
-Boolean callback(download) 
-----
-
-Emitted when the <<DownloadStatus>> changes. 
-
- ::
-
-_download_;; The <<Download>> 
-****
-
-****
-[[executeCommand]]
-[float]
-==== *executeCommand* ==== 
-
-[source,javascript]
-----
-Boolean callback(commandinfo) 
-----
-
-Emitted when a command is executed, return true to prevent execution.
-
- ::
-
-_commandinfo.command_;; The command that is executed
-_commandinfo.argument_;; An argument, if the command isn't executed from commandline this
-will always be null.
-_commandinfo.nummod_;; The numerical modifier.
-****
-
-
-****
-[[frameCreated]]
-[float]
-==== *frameCreated* ==== 
-
-[source,javascript]
-----
-void callback(webview, frame) 
-----
-
-Emitted when the frame is created
-
- ::
-
-_webview_;; The webview the frame belongs to
-_frame_;; The frame 
-****
-
-****
-[[frameStatus]]
-[float]
-==== *frameStatus* ==== 
-
-[source,javascript]
-----
-void callback(webview, frame) 
-----
-
-Emitted when the <<LoadStatus>> of a frame changes
-
- ::
-
-_webview_;; The webview the frame belongs to
-_frame_;; The frame 
-****
-
-****
-[[keyPress]]
-[float]
-==== *keyPress* ==== 
-
-[source,javascript]
-----
-Boolean callback(webview, json) 
-----
-
-Emitted when a key is pressed, return +true+ to prevent the default action
-
- ::
-
-_webview_;; The focused webview
-_json.isModifier_;; Whether or not the key is a modifier
-_json.keyCode_;; Hardware keycode
-_json.keyVal_;; Keycode as listed in gdkkeysyms.h 
-_json.name_;; A string represantation of the key
-_json.state_;; A bitmap of modifiers pressed, see <<Modifier>>
-****
-
-****
-[[keyRelease]]
-[float]
-==== *keyRelease* ==== 
-
-[source,javascript]
-----
-Boolean callback(webview, json) 
-----
-
-Emitted when a key is released, return +true+ to prevent the default action
-
- ::
-
-_webview_;; The focused webview
-_json_;; Same as <<keyPress>>
-****
-
-
-****
-[[loadCommitted]]
-[float]
-==== *loadCommitted* ==== 
-
-[source,javascript]
-----
-void callback(webview) 
-----
-
-Emitted when the load has just commited, no data has been loaded when this
-signal is emitted. This is the preferred signal for injected scripts that do not
-manipulate the DOM.
-
- ::
-
-_webview_;; The webview that emitted the signal
-****
-
-****
-[[loadFinished]]
-[float]
-==== *loadFinished* ==== 
-
-[source,javascript]
-----
-Boolean callback(webview) 
-----
-
-Emitted when the site has completely loaded. 
-
- ::
-
-_webview_;; The webview that emitted the signal
-****
-
-****
-[[loadStatus]]
-[float]
-==== *loadStatus* ==== 
-
-[source,javascript]
-----
-void callback(webview) 
-----
-
-Emitted when the load status changes
-
-  ::
-
-_webview_;; The webview that emitted the signal
-****
-
-****
-[[mimeType]]
-[float]
-==== *mimeType* ==== 
-
-[source,javascript]
-----
-Boolean callback(webview, frame, request, json) 
-----
-
-Decide whether or not to show a given mimetype. Return +true+ to stop the request.
-
- ::
-
-_webview_;; The webview that emitted the signal
-_frame_;; The frames requires the decision 
-_request_;; The network request
-_json.mimeType_;; The mimetype
-****
-
-****
-[[mouseMove]]
-[float]
-==== *mouseMove* ==== 
-
-[source,javascript]
-----
-Boolean callback(webview, event) 
-----
-
-Emitted when the pointer is moved.
-
- ::
-
-_webview_;; The webview that emitted the signal
-_event_;; Same as <<buttonRelease>>
-****
-
-****
-[[navigation]]
-[float]
-==== *navigation* ==== 
-
-[source,javascript]
-----
-Boolean callback(webview, frame, request, action) 
-----
-
-Emitted before a new site is loaded, return +true+ to stop the request.
-
- ::
-
-_webview_;; The webview that emitted the signal
-_frame_;; The frame that requires the navigation 
-_request_;; The network request
-_action_;; The navigation action
-****
-
-****
-[[resource]]
-[float]
-==== *resource* ==== 
-
-[source,javascript]
-----
-Boolean callback(webview, frame, request, response) 
-----
-
-Emitted before a new resource is going to be loaded
-
- ::
-
-_webview_;; The webview that emitted the signal
-_frame_;;   The frame that dispatched the request
-_request_;; The network request
-_response_;; The network response
-****
-
-****
-[[statusBarChange]]
-[float]
-==== *statusBarChange* ==== 
-
-[source,javascript]
-----
-Boolean callback(webview, json) 
-----
-
-Emitted before the status bar is updated, if the callback returns +true+ dwb will
-not update the statusbar so it is possible to set the statusbar from the script.
-
-_webview_;; The focused webview
-_data.canGoBack_;; Whether it is possible to navigate back in the webview
-_data.canGoForward_;; Whether it is possible to navigate forward in the webview
-_data.isBookmarked_;; Whether the site is bookmarked
-_data.isQuickmarked_;; Whether the site is quickmarked
-_data.pluginsBlocked_;; Whether plugins are blocked
-_data.scriptsBlocked_;; Whether scripts are blocked
-_data.ssl_;; SSL-State of the page, can either be 'trusted', 'untrusted' or 'none'
-_data.type_;; The type of the update, can be *status* and *uri*, status means
-that statusLabel und uriLabel need to be updated, uri means that only the
-uriLabel needs to be updated.
-****
-
-****
-[[tabButtonPress]]
-[float]
-==== *tabButtonPress* ==== 
-
-[source,javascript]
-----
-Boolean callback(webview, tabwidget, event) 
-----
-
-Emitted when a button is pressed on a tabwidget, return true to prevent the default action
-
- ::
-
-_webview_;; The <<webview>> which received the signal
-_tabwidget_;; The tabwidget
-_event_;; Same as buttonPress
-****
-  
-
-****
-[[tabFocus]]
-[float]
-==== *tabFocus* ==== 
-
-[source,javascript]
-----
-Boolean callback(webview, json) 
-----
-
-Emitted when another tab gets focus, return +true+ to stop the event
-
- ::
-
-_webview_;; The new tab
-_json.last_;; The number of the previously focused tab
-****
-
-
-
-====
-.Example 
-[source,javascript]
-------
-// Prevent example.com from being loaded
-function navigationCallback(wv, frame, request, action) {
-  if (/.*\.example\.com.*/.test(request.uri)) {
-    return true;
-  }
-}
-signals.connect("navigation", navigationCallback);
-------
-====
-
-== Enum objects ==
-Enum objects are objects that have only readonly properties, mapping
-gtk/webkit enums to javascript objects. 
-
-****
-[[ButtonContext]]
-[float]
-==== *ButtonContext* ====
-
-[source,javascript]
---------
-const ButtonContext = {
-  document   : 1 << 1,
-  link       : 1 << 2,
-  image      : 1 << 3,
-  media      : 1 << 4,
-  selection  : 1 << 5,
-  editable   : 1 << 6
-};
---------
-****
-
-****
-[[ChecksumType]]
-[float]
-==== *ChecksumType* ====
-
-[source,javascript]
---------
-const ChecksumType = {
-  md5     : 0, 
-  sha1    : 1, 
-  sha256  : 2 
-};
---------
-****
-
-****
-[[ClickType]]
-[float]
-==== *ClickType* ====
-
-[source,javascript]
---------
-const ClickType = {
-  click       : 4,
-  doubleClick : 5,
-  tripleClick : 6
-};
---------
-****
-
-****
-[[DownloadStatus]]
-[float]
-==== *DownloadStatus* ====
-
-[source,javascript]
--------
-const DownloadStatus = {
-  error       : -1,
-  created     : 0,
-  started     : 1, 
-  cancelled   : 2,
-  finished    : 3
-};
--------
-****
-
-****
-[[FileTest]]
-[float]
-==== *FileTest* ====
-
-[source,javascript]
--------
-const FileTest = {
-  regular    : 1 << 0,
-  symlink    : 1 << 1,
-  dir        : 1 << 2,
-  executable : 1 << 3,
-  exists     : 1 << 4
-};
--------
-****
-
-****
-[[LoadStatus]]
-[float]
-==== *LoadStatus* ====
-
-[source,javascript]
----------
-const LoadStatus = { 
-  provisional       : 0, 
-  committed         : 1,
-  finished          : 2,
-  firstVisualLayout : 3,
-  failed            : 4
-};
----------
-****
-
-****
-[[Modifier]]
-[float]
-==== *Modifier* ====
-
-[source,javascript]
---------
-const Modifier = {
-  Shift     : 1 << 0,
-  Lock	    : 1 << 1,
-  Control   : 1 << 2,
-  Mod1	    : 1 << 3,
-  Mod2	    : 1 << 4,
-  Mod3	    : 1 << 5,
-  Mod4	    : 1 << 6,
-  Mod5	    : 1 << 7,
-  Button1   : 1 << 8,
-  Button2   : 1 << 9,
-  Button3   : 1 << 10,
-  Button4   : 1 << 11,
-  Button5   : 1 << 12,
-  Super     : 1 << 26,
-  Hyper     : 1 << 27,
-  Meta      : 1 << 28,
-  Release   : 1 << 30,
-  Modifier  : 0x5c001fff
-};
---------
-****
-
-****
-[[NavigationReason]]
-[float]
-==== *NavigationReason* ====
-
-[source,javascript]
---------
-const NavigationReason = {
-  linkClicked     : 0,
-  formSubmitted   : 1,
-  backForward     : 2,
-  reload          : 3,
-  formResubmitted : 4,
-  other           : 5
-};
---------
-****
-
-****
-[[Modes]]
-[float]
-==== *Modes* ====
-[source,javascript]
---------
-const Modes = {
-  NormalMode  : 1<<0,
-  InsertMode  : 1<<1,
-  CommandMode : 1<<2
-};
---------
-****
-
-****
-[[Selection]]
-[float]
-==== *Selection* ====
-[source,javascript]
---------
-const Selection = {
-  primary   : 1,
-  clipboard : 2
-};
---------
-****
-
-
-[[Globaldata]]
-== Global data == 
-Since all scripts share the same execution context, every script is encapsulated
-in a function. To avoid conflicts between scripts, e.g. with duplicate
-variables, it is not allowed to set properties on the global object:
-
-[source,javascript]
--------
-#!javascript
-
-// not allowed, the global object is readonly
-number = 0;
-io.print(number);     // undefined
-
-var number2 = 0;
-io.print(number2);    // 0
-
-// not allowed
-foo = function() 
-{
-  io.print("foo");
-}
-foo();  // fails
--------
-
-For sharing data between scripts either signals or modules can be created.
-
-[[scriptandthis]]
-=== script and this ===
-In every script the variable *script* refers to *this*, the encapsulating
-function, it has the following properties and methods:
-
-
-****
-[float]
-==== *path* ====
-
-[source,javascript]
-----
-script.path        string     read
-----
-
-The path of the script.
-****
-
-****
-[[thisdebug]]
-[float]
-==== *debug()* ==== 
-
-[source,javascript]
-----
-void script.debug(Object params)
-----
-
-Same as io.debug but also prints additional information, e.g. if the object is
-an Error, this method will also print the corresponding source of the error.
-****
-
-.Example 
-****
-[source,javascript]
--------
-#!javascript
-
-try 
-{
-    var x = {};
-    var y = x.foo.bar;
-    var z = 33;
-}
-catch(e) 
-{
-    script.debug(e);
-}
--------
-
-Will produce the following output: 
-
-------
-==> DEBUG [IN FILE]    : /path/to/userscript
-==> DEBUG [ERROR]      : Exception in line 6: 'undefined' is not an object
-                         (evaluating 'x.foo.bar') 
-==> DEBUG [STACK]      : [anonymous] [[native code]]
-==> DEBUG [SOURCE]     : 
-    ...
-    5 >      var x = {};
---> 6 >      var y = x.foo.bar;   
-    7 >      var z = 33;
-    ...
-------
-
-
-****
-
-
-[[Modules]]
-== Modules == 
-
-With modules it is possible to share objects between scripts. Modules are
-defined with +provide+ and loaded with +require+.
-
-.Defining modules
-[source,javascript]
--------
-#!javascript 
-
-provide("myModule", {
-  foo : 37, 
-  doBar : function() {
-    io.print("bar");
-  }
-});
-provide("myOtherModule", {
-  act : function (arg) {
-    io.print(arg);
-  }
-});
--------
-
-.Getting some modules
-[source,javascript]
--------
-#!javascript 
-
-require(["myModule", "myOtherModule"], function(myModule, myOtherModule) {
-  if (myModule.foo == 37) 
-    myModule.doBar();
-
-  myOtherModule.act("foo");
-});
--------
-
-.Getting all modules
-[source,javascript]
--------
-#!javascript 
-
-require(null, function(modules) {
-  if (modules.myModule.foo == 37) 
-    modules.myModule.doBar();
-
-  modules.myOtherModule.act("foo");
-});
--------
-
-It is also possible to specify a path in the name array. The name then follows
-the format +name!path+:
-
-[source,javascript]
--------
-#!javascript 
-
-require(["foo!/path/to/foo"], function(foo) {
-  io.print(foo.bar); // 37
-});
--------
-
-./path/to/foo
-[source,javascript]
--------
-provide("foo", { bar : 37 });
--------
-
-The resolution chain is as follows, first all modules defined with +provide+ and
-module names requested by +require+ are stored. If all scripts have been loaded
-the requirements are resolved. If a requirement contains a path and the module
-isn't defined yet the module will be loaded, if it is already defined the path
-is ignored and the stored module will be resolved:  
-
-[source,javascript]
--------
-#!javascript 
-
-require(["foo!/path/to/foo"], function(foo) {
-  io.print(foo.bar); // 42
-});
-provide("foo", { bar : 42 });
--------
-
-[source,javascript]
--------
-#!javascript 
-
-require(["foo"], function(foo) {
-  io.print(foo); // undefined
-});
-require(["foo!/path/to/foo"]);
-
-require(["foo"], function(foo) {
-  io.print(foo); // { bar : 37 }
-});
--------
-
-
-[[Extensions]] 
-== Extensions ==
-*dwb* provides the possibility to load extensions.
-It is recommended to implement javascript-userscripts as an extension to have 
-consistent configuration locations for scripts. 
-
-=== Prepackaged extensions
-
-==== formfiller
-
-An extension that gets form data and fills forms with previously saved data.
-
-_Configuration options_::
- 
-_formData_;; A path to a file where formdata will be saved, the default
-                 path is *$XDG_CONFIG_HOME/dwb/forms*
-_scGetForm_;; Shortcut that gets and saves form data, the default value is *efg*
-_scFillForm_;; Shortcut that fills a form, the default value is *eff*
-_useGPG_;; Whether to use gpg2 to encrypt the formData file with a password.
-_GPGOptEncrypt_;; Additional options that will be passed to gpg2 for
-                encryption, the default gpg2 options are:
-                --passphrase <password> --batch --no-tty --yes -c --output <formData>
-                default value: *""*
-_GPGOptDecrypt_;; Additional options that will be passed to gpg2 for
-                decryption, the default gpg2 options are 
-                --passphrase <password> --batch --no-tty --yes -d <formData>
-                default value: *""*
-
-_keepPassword_;;  Whether to save the gpg password in memory, if set to false the
-                user will be prompted for the password every time a form
-                is filled or new data is saved, default value: *true*
-
-_keepFormdata_;;  If useGPG is enabled and this value is set to true the
-                  complete formdata will be kept in memory, if set to false
-                  gpg2 will be called every time a form is filled, default
-                  value: *false*
-
-==== perdomainsettings
-
-An extension that can be used for per-domain-settings. Valid settings are
-the properties of WebKitWebSettings but in camelcase, see 
-http://webkitgtk.org/reference/webkitgtk/unstable/WebKitWebSettings.html
-for details. 
-
-_Configuration options_::
-
-_domains_;;   Settings applied based on the effective second level domain
-
-_hosts_;;   Settings applied based on host name, this option is
-an object of the format
-
-_uris_;;   Settings applied based on the uri, this option is
-an object of the format
-
-_defaults_;;  Default settings, for each setting in domains, hosts and uris a
-             default-value should be specified
-
-_Example configuration_::
-
-Example using extensions.load
-
-[source,javascript]
-----
-extensions.load("perdomainsettings", { 
-  domains : {                                                            
-     "example.com" : {                                                   
-          "enablePlugins"  : true                                        
-     },                                                                  
-     "example.uk.com" :  {                                               
-          "enablePlugins"  : true,                                       
-          "enableScripts"  : false                                       
-     }                                                                   
-  },                                                                     
-  hosts : {                                                              
-     "www.example1.com" :  {                                             
-          "autoLoadImages" : true                                        
-     }                                                                   
-  },                                                                     
-  uris : {                                                               
-     "http://www.example2.com/login.php" :  {                            
-          "autoLoadImages" : false                                       
-     }                                                                   
-  },                                                                     
-  defaults : {                                                           
-     "enablePlugins"   : false,                                          
-     "autoLoadImages"  : false,                                          
-     "enableScripts"   :  true                                           
-  }                                                                      
-});
-----
-
-
-==== requestpolicy
-
-Extension that blocks requests from thirdparty domains with whitelisting
-support, either permanently or just for the session.
-It is also possible to block requests from certain domains on all sites, they
-have highest precedence and will also be blocked on sites where 
-thirdparty requests are allowed in general. 
-
-_Configuration options_::
-
-_shortcut_;; Shortcut to block / allow requests, default *"erp"*
-
-_unblockCurrent_;; Shortcut to unblock always blocked requests, shows only
-                 domains from the current site, default *"erC"*
-
-_unblockAll_;;  Shortcut to unblock always blocked requests, shows all
-                 blocked domains, default *"erA"*
-
-_whiteList_;; A path to the whitelisting file, default is
-                 *$XDG_CONFIG_HOME/dwb/<profile>/requestpolicy.json*
-
-_autoreload_;; Whether to automatically reload the website after the
-                 persistentList has changed, default *false*
-
-_notify_;; Whether to notify about blocked request, default *false*
-
-
-==== unique_tabs
-
-Extension that allows to remove duplicate tabs or avoids duplicate tabs
-automatically.
-
-_Configuration options_::
-
-_shortcutRemoveDuplicates_;; Shortcut that removes duplicate tabs, default *null*
-
-_commandRemoveDuplicates_;; Command that remove s duplicate tabs, default
-*ut_remove_duplicates*
-
-_autoFocus_;; Autofocus a tab if an url is already opened, if the url would be loaded in a
-new tab the new tab is closed.  Setting this to true makes commandRemoveDuplicates and
-shortcutRemoveDuplicates obsolete because there will be no duplicate tabs.
-Default value: *true*
-
-_shortcutToggleAutoFocus_;; Shortcut that enables/disables autofocus, default
-*null*
-
-_commandToggleAutoFocus_;;  Command that enables/disables autofocus, default
-*ut_toggle_autofocus*
-
-==== userscripts
-
-Extension that loads userscripts and injects them into websites, this
-extension is mostly greasemonkey compatible. Scripts can be loaded by either
-passing an array of paths to extensions.load or by putting scripts into
-$XDG_CONFIG_HOME/dwb/scripts/. 
-
-_Configuration options_::
-
-The only configuration option is an array of paths to scripts
-
-_Example configuration_::
-
-Example using extensions.load 
-
-[source,javascript]
-----
-extensions.load("userscripts", [ "/path/to/script1", "/path/to/script2" ]);
-----
-
-
-=== Using extensions
-
-Extensions can be loaded by an userscript 
-
-[source,javascript]
-------
-#!javascript 
-
-extensions.load("extension_1");
-extensions.load("extension_2", { 
-  configProp_1 : 37, 
-  configProp_2 : "val2" 
-});
-------
-
-To load/unload extensions on the fly *extensions.bind* can be used:
-
-[source,javascript]
-------
-#!javascript 
-
-var myConfig = { 
-  prop_1 : 37, 
-  prop_2 : true, 
-  prop_3 : "foo"
-};
-
-extensions.bind("myExtension", "Control m", {
-  command : "toggleMyExtension", 
-  config : myConfig, 
-  load : false
-});
-extensions.bind("mySecondExtension", "Control M");
-------
-
-The default searchpaths for extensions are +$XDG_DATA_HOME/dwb/extensions/+ and
-+/usr/share/dwb/extensions/+.
-
-The +extensions+ object has the following functions
-
-=== Methods ===
-
-****
-[[extensionsbind,bind]]
-[float]
-==== *bind()* ==== 
-
-[source,javascript]
-----
-void extensions.bind(String name, String shortcut, [Object options]) 
-----
-
-Bind an extension to a shortcut, the shortcut enables/disables the extension.
-
-_name_;; Name of the extension
-_shortcut_;; Name of the extension
-_options_;; An optional object with options where possible options are 
-options.load::: Whether to load the extension on startup, default true
-options.config::: Config passed to extensions.load
-options.command::: Command that can be used on commandline
-****
-
-****
-[[extensiondisableAll,disableAll]]
-[float]
-==== *disableAll()* ====
-
-[source,javascript]
-----
-void extensions.disableAll() 
-----
-
-Disables all extensions.
-****
-
-**** 
-[[extensionsGetConfig,getConfig]]
-[float]
-==== *getConfig* ====
-
-[source,javascript]
-----
-Object extensions.getConfig(Object config, Object defaultConfig) 
-----
-Parses config with given default config. Checks for each property of
-defaultConfig if the corresponding property of config is valid.
-
-_config_;; The configuration object
-_defaultConfig_;; The default configuration for the extension
-_returns_;; The parsed config
-****
-
-****
-[[extensionload,load]]
-[float]
-==== *load()* ====
-
-[source,javascript]
-----
-Boolean extensions.load(String name, [Object config]) 
-----
-Loads an extension
-
- ::
-
-_name_;; Name of the extension
-_config_;; The config for the script, if omitted the config is read from
-$XDG_CONFIG_HOME/dwb/extensionrc, optional
-_returns_;;  True if the extension was loaded
-****
-
-****
-[[extensiontoggle,toggle]]
-[float]
-==== *toggle()* ====
-
-[source,javascript]
-----
-Boolean extensions.toggle(String name, [Object config]) 
-----
-Toggles an extension
-
- ::
-
-_name_;; Name of the extension
-_config_;; The config for the extension.
-optional
-_returns_;;  True if the extension was loaded, false if it was unloaded.
-****
-
-****
-[[extensionload,unload]]
-[float]
-==== *unload()* ====
-
-[source,javascript]
-----
-Boolean extensions.unload(String name) 
-----
-Unloads an extension
-
- ::
-
-_name_;; Name of the extension
-_returns_;;  True if the extension was unloaded
-****
-
-****
-[[error]]
-[float]
-==== *error()* ====
-
-[source,javascript]
-----
-void extensions.error(String name, String message|Error e, [String message]) 
-----
-
-Print an error message and call stack to stderr.
-
- ::
-
-_name_;; Name of the extension
-_message|e_;; The error message or an Error
-_message_;; If the second parameter is an Error, an optional message can be
-specified.
-****
-
-****
-[[message]]
-[float]
-==== *message()* ====
-
-[source,javascript]
-----
-void extensions.message(String name, String message) 
-----
-
-Print a consistent message to stderr
-
- ::
-
-_name_;; Name of the extension
-_message_;; The message
-****
-
-
-****
-[[warning]]
-[float]
-==== *warning()* ====
-
-[source,javascript]
-----
-void extensions.warning(String name, String message) 
-----
-
-Print a consistent warning to stderr
-
- ::
-
-_name_;; Name of the extension
-_message_;; The warning message
-****
-
-
-.Example
-
-[source,javascript]
---------
-#!javascript 
-
-extensions.load("foobar");
---------
-
-=== Writing extensions
-
-The default searchpath for extensions isn +$XDG_DATA_HOME/dwb/extensions+ and
-+SHARE_DIR/dwb/extensions+ where the 
-+SHARE_DIR+ with sharedirectory being the share directory of the installation,
-most likely /usr/share.
-
-The configuration for extensions is in +$XDG_CONFIG_HOME/dwb/extensionrc+ and should
-return a javascript object. 
-
-Every extension must implement one function named +init+ that takes one
-argument, the config for the extension. The function should return +true+ if the
-extension was successfully loaded, +false+ otherwise.
-Every extension also may implement a function +end+ that will be called when an
-extension is unloaded. If an extension registers to signals and binds shortcuts
-the extension should unregister all signals and unbind all shortcuts in this
-function.
-+init+ and +end+ should be returned from the extension.
-
-Additionally the returned object can also have an +defaultConfig+-property, the
-value will be passed to extensions.getConfig before calling the init function.
-
-.Example
-
-A extension called *foobar* in +$HOME/.local/share/dwb/extensions/foobar+.
-
-[source,javascript]
---------
-function foo(val) {
-  ....
-}
-function bar(val) {
-  ....
-}
-function loadStatusCallback(w) {
-  ...
-}
-return {
-  defaultConfig : { foo : 37 },
-
-  init : function (config) {
-    if (config.foo > 36) {
-      bar(config.foo);
-      foo(config.bar);
-      bind("XX", bar, "dobar");
-      signals.connect("loadStatus", loadStatusCallback);
-      return true;
-    }
-
-    return false;
-  },
-
-  end : function () {
-    unbind(bar);
-    signals.disconnect(loadStatusCallback);
-    return true;
-  }
-};
---------
-
-====
-.Example extensionrc
-[source,javascript]
---------
-return {
-  foobar : { bar : "X", foo : 37 }, // config for extension foobar
-  barfoo : {  }                     // config for extension barfoo
-  
-};
---------
-====
-
-Extensions that provide a public api can use provide or replace using the name of the extension. 
-
-====
-[source,javascript]
---------
-var myPublicFunction = function() 
-{
-  ...
-};
-
-return {
-  init : function(config) 
-  {
-    provide("myExtensionName", 
-    {
-      config : config, 
-      method : myPublicFunction
-    });
-  },
-  end : function() 
-  {
-    replace("myExtensionName");
-  }
-};
---------
-====
-
-== Snippets == 
-
-Some example snippets can be found link:../snippets/snippets.html[here].
-
-
-// vim: set ft=asciidoc: