HEADER

section:Various{nbsp}Commands[various]

|<C-l>| |CTRL-L| |:redr| |:redraw| +
||:redr[aw]||
____
Redraws the screen. Useful to update the screen halfway executing a script or function.
____

|:norm| |:normal|
||:norm[al][!] {commands}|| +
________________________________________________________________________________
Execute Normal mode commands {commands}. This makes
it possible to execute Normal mode commands typed on
the command-line. {commands} is executed like it is
typed. If the [!] is given, mappings will not be used.
{commands} should be a complete command.
{commands} cannot start with a space.  Put a 1 (one)
before it, 1 space is one space.
________________________________________________________________________________


section:Online{nbsp}Help[online-help]

|<F1>| |:help| |:h| |help|
||:h[elp] {subject}|| +
||<F1>||
________________________________________________________________________________
Open help window.
The default section is shown unless {subject} is specified.
If you need help for a specific topic, try [c]:help overview[c].
____________________________________________________________________________

|:exu| |:exusage|
||:exu[sage]||
________________________________________________________________________________
Show help on Ex commands.  Added to simulate the Nvi command.
________________________________________________________________________________


|:viu| |:viusage|
||:viu[sage]||
________________________________________________________________________________
Show help on Normal mode commands.  Added to simulate the Nvi command.
________________________________________________________________________________

|42| +

What is the meaning of life, the universe and everything?
Douglas Adams, the only person who knew what this question really was about is
now dead, unfortunately.  So now you might wonder what the meaning of death
is...


section:Uncategorized{nbsp}Help[uncategorized]


|<C-[>| |<Esc>| +
||<Esc>||
________________________________________________________________________________
Focus content. Exits any command line or hint mode and returns to browser
mode. Also focuses the web page, in case a form field has focus and eats
our key presses.
________________________________________________________________________________


|:|
||:||
________________________________________________________________________________
Start command line mode. In command line mode, you can perform extended
commands, which may require arguments.
________________________________________________________________________________


|<Tab>|
||<Tab>||
________________________________________________________________________________
Advance keyboard focus to the next element.
________________________________________________________________________________


|<S-Tab>|
||<S-Tab>||
________________________________________________________________________________
Rewind keyboard focus to the previous element.
________________________________________________________________________________


|<Insert>| |i| +
||i||
________________________________________________________________________________
Start caret mode. This mode resembles the Vim normal mode where you see a text
cursor and can move around. If you want to select text in this mode, press
[m]v[m] to start its Visual mode.
________________________________________________________________________________


|<C-c>|
||<C-c>||
________________________________________________________________________________
Stop loading the current web page.
________________________________________________________________________________


|\~| +
||\~||
________________________________________________________________________________
Open home directory. You can also use the hints and have the probably fastest
file browser on earth. :)
________________________________________________________________________________


|gf| +
||gf||
________________________________________________________________________________
View source. Opens the source code of the current website with the internal
editor in the current tab.
________________________________________________________________________________


|gF| +
||gF||
________________________________________________________________________________
View source with an external editor. Opens the source code of the current
website with the external editor specified by the 'editor' option. For now the
external editor must be able to download and open files from a remote URL.
________________________________________________________________________________


|gh|
||gh||
________________________________________________________________________________
Go home. Opens the homepage in the current tab.
________________________________________________________________________________


|gH| +
||gH||
________________________________________________________________________________
Go home in a new tab. Opens the homepage in a new tab. Whether the new tab is
activated or not depends on the 'activate' option.
________________________________________________________________________________


|gP| +
||gP||
________________________________________________________________________________
Open (put) a URL based on the current clipboard contents in a new buffer.
Works like [m]P[m], but inverts the 'activate' option.
________________________________________________________________________________


|O| +
||O||
________________________________________________________________________________
Open one or more URLs in the current tab, based on current location. Works
like [m]o[m], but preselects current URL in the [c]:open[c] query.
________________________________________________________________________________


|T| +
||T||
________________________________________________________________________________
Open one or more URLs in a new tab, based on current location. Works like [m]t[m], but preselects current URL in the [c]:tabopen[c] query.
________________________________________________________________________________


|<MiddleMouse>| |p| +
||p||
________________________________________________________________________________
Open (put) a URL based on the current clipboard contents in the current buffer. You can also just select (for non-X11 users: copy) some non-URL text, and search for it with the default search engine or keyword (specified by the 'defsearch' option) with [m]p[m].
________________________________________________________________________________


|P| +
||P||
________________________________________________________________________________
Open (put) a URL based on the current clipboard contents in a new buffer. Works like [m]p[m], but opens a new tab. +
Whether the new buffer is activated, depends on the 'activate' option.
________________________________________________________________________________


|r|
||r||
________________________________________________________________________________
Force reloading of the current page.
________________________________________________________________________________


|R|
||R||
________________________________________________________________________________
Force reloading of the current page skipping the cache.
________________________________________________________________________________


|y| +
||y||
________________________________________________________________________________
Yank current location to the clipboard. When running in X11 the location is
also put into the selection, which can be pasted with the middle mouse button.
________________________________________________________________________________


|Y|
||Y||
________________________________________________________________________________
Copy currently selected text to the system clipboard.
________________________________________________________________________________


|ZQ|
||ZQ||
________________________________________________________________________________
Quit and don't save the session. Works like [c]:qall[c].
________________________________________________________________________________


|ZZ|
||ZZ||
________________________________________________________________________________
Quit and save the session. Quit Vimperator, no matter how many tabs/windows
are open. The session is stored. Works like [c]:xall[c].
________________________________________________________________________________


|<C-x>|
||[count]<C-x>||
________________________________________________________________________________
Decrements the last number in URL by 1, or by count if given.
________________________________________________________________________________


|<C-a>|
||[count]<C-a>||
________________________________________________________________________________
Increments the last number in URL by 1, or by count if given.
________________________________________________________________________________


|<C-g>| +
||[count]<C-g>||
________________________________________________________________________________
Print the current file name. Also shows some additional file information like
file size or the last modified date. If {count} is given print the current
file name with full path.
________________________________________________________________________________


|g<C-g>| +
||g<C-g>||
________________________________________________________________________________
Print file information. Same as [c]:pa[geinfo][c].
________________________________________________________________________________


|gu| +
||[count]gu||
________________________________________________________________________________
Go to parent directory. Count is supported: [m]2gu[m] on
_http://www.example.com/dir1/dir2/file.htm_ would open
_http://www.example.com/dir1/_.
________________________________________________________________________________


|gU| +
||gU||
________________________________________________________________________________
Go to the root of the website. [m]gU[m] on
_http://www.example.com/dir1/dir2/file.htm_ opens
_http://www.example.com/_. +
When browsing a local directory, it goes to the root directory.
________________________________________________________________________________


|/| +
||/\\{pattern\\}[/]<CR>|| +
________________________________________________________________________________
Search forward for the first occurrence of {pattern}.

If "\c" appears anywhere in the pattern the whole pattern is handled as though
'ignorecase' is on. "\C" forces case-sensitive matching for the whole pattern.  +
If "\l" appears in the pattern only the text of links is searched for a
match as though 'linksearch' is on. "\L" forces the entire page to be searched
for a match.
________________________________________________________________________________


|?| +
||?{pattern}[?]<CR>|| +
________________________________________________________________________________
Search backwards for {pattern}.

{pattern} can use the same modifiers as for [m]/[m]. +
NOTE: incremental searching currently only works in the forward direction.
________________________________________________________________________________


|n|
||n||
________________________________________________________________________________
Find next. Repeat the last search 1 time (until count is supported).
________________________________________________________________________________


|N|
||N||
________________________________________________________________________________
Find previous. Repeat the last search 1 time (until count is supported) in the
opposite direction.
________________________________________________________________________________


|\*|
||\*||
________________________________________________________________________________
Search forward for the next word under the cursor.
________________________________________________________________________________


|\#|
||\#||
________________________________________________________________________________
Search backward for the previous word under the cursor.
________________________________________________________________________________


|:addo| |:addons| +
||:addo[ns]||
________________________________________________________________________________
Show available Browser Extensions and Themes.
You can add/remove/disable browser extensions from this dialog.
Be aware that not all Firefox extensions work, because Vimperator overrides
some key bindings and changes Firefox's GUI.
________________________________________________________________________________


|:beep|
||:beep||
________________________________________________________________________________
Play a system beep.
________________________________________________________________________________


|:b| |:buffer|
||:b[uffer][!] {url|index}|| +
________________________________________________________________________________
Go to buffer from buffer list. Argument can be either the buffer index or the
full URL.

If argument is neither a full URL nor an index but uniquely identifies a
buffer, it is selected. With [!] the next buffer matching the argument is
selected, even if it cannot be identified uniquely. Use [m]b[m] as a
shortcut to open this prompt.

If argument is #, the alternate buffer will be selected (see [m]<C-6>[m]).
________________________________________________________________________________


|:dia| |:dialog|
||:dia[log] [firefox-dialog]|| +
________________________________________________________________________________
Open a firefox-dialog. Available dialogs: use completion on [c]:dialog[c] <tab>
________________________________________________________________________________


|:chd| |:chdir| |:cd|
||:cd [-|path]||
________________________________________________________________________________
Change the current directory. [c]:cd -[c] changes to the last directory.
________________________________________________________________________________


|:pw| |:pwd|
||:pw[d]||
________________________________________________________________________________
Print the current directory name.
________________________________________________________________________________


|:dl| |:downl| |:downloads| +
||:downl[oads]||
________________________________________________________________________________
Show progress of current downloads. Open the original Firefox download dialog
in a new tab. Here, downloads can be paused, canceled and resumed.
________________________________________________________________________________


|:ha| |:hardcopy| +
||:ha[rdcopy]||
________________________________________________________________________________
Print current document. Open a GUI dialog where you can select the printer,
number of copies, orientation, etc.
________________________________________________________________________________


|:h| |:help|
||:h[elp] {subject}|| +
________________________________________________________________________________
Open the help window. You can jump to the specified {subject} with [c]:help
{subject}[c]. You can use the full Vim notation when jumping to {subject}. This means:

* [c]:help :help[c] for commands (: prefix)
* [c]:help 'complete'[c] for options (surrounded by \' and \')
* [c]:help o[c] for mappings (no pre- or postfix)

You can also use partial strings in the tab completion, so [c]:help he<Tab>[c]
completes [c]:help :help[c].
________________________________________________________________________________


|:au| |:autocmd| +
||:au[tocmd]||
________________________________________________________________________________
Execute commands automatically on events. [c]:au[tocmd][c] {event} {pat}
{cmd}.
Add {cmd} to the list of commands Vimperator will execute on {event}:

* [c]:autocmd[!][c] {events} {pat}: list/remove autocommands filtered be {events} and {pat}
* [c]:autocmd[!][c] {events}: list/remove autocommands matching {events}
* [c]:autocmd[!][c] * {pat}: list/remove autocommands matching {pat}
* [c]:autocmd[!][c]: list/remove all autocommands

________________________________________________________________________________


|:mkv| |:mkvimperatorrc|
||:mkv[imperatorrc][!] [file]|| +
________________________________________________________________________________
Write current key mappings and changed options to [file]. If no [file] is
specified then _~/.vimperatorrc_ is written unless this file already exists. The
special version [c]:mkvimperatorrc![c] will overwrite [file] if it exists.

Warning: this differs from Vim's behavior which defaults to writing the file
in the current directory.
________________________________________________________________________________


|:noh| |:nohlsearch| +
||:noh[lsearch]||
________________________________________________________________________________
Remove the search highlighting. The document highlighting is turned back on
when another search command is used or the 'hlsearch' option is set.
________________________________________________________________________________


|:norm| |:normal| +
||:norm[al][!] {commands}|| +
________________________________________________________________________________
Execute Normal mode commands. Example: [c]:normal 20j[c] scrolls 20 lines
down. If the [!] is specified mappings will not be used.
________________________________________________________________________________


|:pa| |:pageinfo|
||:pa[geinfo]||
________________________________________________________________________________
Show various page information. See :help 'pageinfo' for available options.
________________________________________________________________________________


|:pc| |:pclose|
||:pc[lose]||
________________________________________________________________________________
Close preview window on bottom of screen.
________________________________________________________________________________


|:q| |:quit| +
||:q[uit]||
________________________________________________________________________________
Quit current tab. If this is the last tab in the window, close the window. If
this was the last window, close Vimperator. When quitting Vimperator, the
session is not stored.
________________________________________________________________________________


|:qa| |:qall| |:quita| |:quitall| +
||:quita[ll]||
________________________________________________________________________________
Quit Vimperator. Quit Vimperator, no matter how many tabs/windows are open.
The session is not stored.
________________________________________________________________________________


|:redr| |:redraw| +
||:redr[aw]||
________________________________________________________________________________
Redraw the screen. Useful to update the screen halfway executing a script or
function.
________________________________________________________________________________


|:re| |:reload| +
||:re[load][!]||
________________________________________________________________________________
Reload current page. Forces reloading of the current page. If [c]![c] is
given, skip the cache.
________________________________________________________________________________


|:reloada| |:reloadall| +
||:reloada[ll][!]||
________________________________________________________________________________
Reload all pages. Forces reloading of all pages. If [c]![c] is given, skip the cache.
________________________________________________________________________________


|:res| |:restart| +
||:res[tart]||
________________________________________________________________________________
Force the browser to restart. Useful when installing extensions.
________________________________________________________________________________


|:w| |:write| |:sav| |:saveas| +
||:sav[eas]||
________________________________________________________________________________
Save current web page to disk. Opens the original Firefox "Save page as..."
dialog.  There, you can save the current web page to disk with various
options. Use [!] to save the file with a default filename to the current working
directory, skipping the Save as... prompt
________________________________________________________________________________


|:sbcl| |:sbclose|
||:sbcl[ose]||
________________________________________________________________________________
Close the sidebar window.
________________________________________________________________________________


|:sbope| |:sbopen| |:sb| |:sbar| |:sideb| |:sidebar|
||:sidebar {name}||
________________________________________________________________________________
Open the sidebar window. +
{name} is any of the menu items listed under the standard Firefox
View->Sidebar menu. Add-ons, Preferences and Downloads are also available in
the sidebar.
________________________________________________________________________________


|:so| |:source|
||:so[urce][!] {file}|| +
________________________________________________________________________________
Read Ex commands from {file}. You can either source files which mostly contain
Ex commands like [c]map < gt[c] and put JavaScript code within a:

--------------------------------------------------------------------------------
js <<EOF
hello = function () {
  alert("Hello world");
}
EOF
--------------------------------------------------------------------------------
Or you can alternatively source a file which ends in _.js_, these files are
automatically sourced as pure JavaScript files.

Note: In both cases you must add functions to the global window object like
shown above, functions written as:
--------------------------------------------------------------------------------
function hello2() {
  alert("Hello world");
}
--------------------------------------------------------------------------------
are only available within the scope of the script.

The _.vimperatorrc_ file in your home directory and any files in
_\~/.vimperator/plugin/_ are always sourced at startup.
\~ is supported as a shortcut for the _$HOME_ directory.  If [!] is
specified, errors are not printed.
________________________________________________________________________________


|:st| |:stop|
||:st[op]||
________________________________________________________________________________
Stop loading. Stop loading current web page.
________________________________________________________________________________


|:tab| +
||:tab {cmd}||
________________________________________________________________________________
Execute {cmd} and tell it to output in a new tab. Works only for commands that
support it, currently:

* :tab help
* :tab prefs[!]

________________________________________________________________________________


|:unl| |:unlet|
||:unl[et][!] {name} ...|| +
________________________________________________________________________________
Deletes the variable {name}. Several variable names can be given.
________________________________________________________________________________


|:ve| |:version| +
||:ve[rsion][!]||
________________________________________________________________________________
Show version information. You can show the Firefox version page with
[c]:version![c].
________________________________________________________________________________


|:vie| |:viewsource|
||:vie[wsource][!] [url]|| +
________________________________________________________________________________
View source code of current document. When ! is given, it is opened with the
external editor.
________________________________________________________________________________


|:wc| |:wclose| |:winc| |:winclose|
||:winc[ose] [url] [, url]|| +
________________________________________________________________________________
Close window.
________________________________________________________________________________


|:xa| |:xall| |:wq| |:wqa| |:wqall|
||:wqa[ll]|| +
||:xa[ll]||
________________________________________________________________________________
Save the session and quit. Quit Vimperator, no matter how many tabs/windows
are open. The session is stored. [c]:wq[c] is different as in Vim, as it
closes the window instead of just one tab by popular demand. Complain on the
mailing list, if you want to change that.
________________________________________________________________________________


|:run| |:!| +
||:!{cmd}||
________________________________________________________________________________
Run a command. Runs {cmd} through system() and displays its output. Any '!' in
{cmd} is replaced with the previous external command. But not when there is a
backslash before the '!', then that backslash is removed.

Warning: Input redirection (< foo) not done, also do not run commands which
require stdin or it will hang Firefox!
________________________________________________________________________________

// vim: set syntax=asciidoc: