diff --git a/doc/help/commands.asciidoc b/doc/help/commands.asciidoc index 7ef9178d5..b1408fd6b 100644 --- a/doc/help/commands.asciidoc +++ b/doc/help/commands.asciidoc @@ -6,6 +6,7 @@ |============== |Command|Description |<>|Go back in the history of the current tab. +|<>|Bind a key to a command. |<>|Cancel the first/[count]th download. |<>|Download the current page. |<>|Go forward in the history of the current tab. @@ -40,6 +41,7 @@ |<>|Switch to the next tab, or switch [count] tabs forward. |<>|Close all tabs except for the current one. |<>|Switch to the previous tab, or switch [count] tabs back. +|<>|Unbind a keychain. |<>|Re-open a closed tab (optionally skipping [count] closed tabs). |<>|Yank the current URL/title to the clipboard or primary selection. |<>|Set the zoom level for the current tab. @@ -50,6 +52,18 @@ === back Go back in the history of the current tab. +[[bind]] +=== bind +Syntax: +:bind 'key' 'command' ['mode']+ + +Bind a key to a command. + +==== positional arguments +* +'key'+: The keychain or special key (inside <...>) to bind. +* +'command'+: The command to execute. +* +'mode'+: A comma-separated list of modes to bind the key in (default: normal mode). + + [[cancel-download]] === cancel-download Cancel the first/[count]th download. @@ -340,6 +354,17 @@ Close all tabs except for the current one. === tab-prev Switch to the previous tab, or switch [count] tabs back. +[[unbind]] +=== unbind +Syntax: +:unbind 'key' ['mode']+ + +Unbind a keychain. + +==== positional arguments +* +'key'+: The keychain or special key (inside <...>) to bind. +* +'mode'+: A comma-separated list of modes to unbind the key in (default: normal mode). + + [[undo]] === undo Re-open a closed tab (optionally skipping [count] closed tabs). diff --git a/doc/help/settings.asciidoc b/doc/help/settings.asciidoc index e0acf4553..8401a16bc 100644 --- a/doc/help/settings.asciidoc +++ b/doc/help/settings.asciidoc @@ -812,62 +812,6 @@ Default: +pass:[\bprev(ious)?\b,\bback\b,\bolder\b,\b[<←≪]\b,\b(<<| Definitions of search engines which can be used via the address bar. The searchengine named `DEFAULT` is used when `general -> auto-search` is true and something else than a URL was entered to be opened. Other search engines can be used via the bang-syntax, e.g. `:open qutebrowser !google`. The string `{}` will be replaced by the search term, use `{{` and `}}` for literal `{`/`}` signs. -== keybind -Bindings from a key(chain) to a command. -For special keys (can't be part of a keychain), enclose them in `<`...`>`. For modifiers, you can use either `-` or `+` as delimiters, and these names: - - * Control: `Control`, `Ctrl` - * Meta: `Meta`, `Windows`, `Mod4` - * Alt: `Alt`, `Mod1` - * Shift: `Shift` - -For simple keys (no `<>`-signs), a capital letter means the key is pressed with Shift. For special keys (with `<>`-signs), you need to explicitely add `Shift-` to match a key pressed with shift. You can bind multiple commands by separating them with `;;`. - -== keybind.insert -Keybindings for insert mode. -Since normal keypresses are passed through, only special keys are supported in this mode. -Useful hidden commands to map in this section: - - * `open-editor`: Open a texteditor with the focused field. - * `leave-mode`: Leave the command mode. - -== keybind.hint -Keybindings for hint mode. -Since normal keypresses are passed through, only special keys are supported in this mode. -Useful hidden commands to map in this section: - - * `follow-hint`: Follow the currently selected hint. - * `leave-mode`: Leave the command mode. - -== keybind.passthrough -Keybindings for passthrough mode. -Since normal keypresses are passed through, only special keys are supported in this mode. -Useful hidden commands to map in this section: - - * `leave-mode`: Leave the passthrough mode. - -== keybind.command -Keybindings for command mode. -Since normal keypresses are passed through, only special keys are supported in this mode. -Useful hidden commands to map in this section: - - * `command-history-prev`: Switch to previous command in history. - * `command-history-next`: Switch to next command in history. - * `completion-item-prev`: Select previous item in completion. - * `completion-item-next`: Select next item in completion. - * `command-accept`: Execute the command currently in the commandline. - * `leave-mode`: Leave the command mode. - -== keybind.prompt -Keybindings for prompts in the status line. -You can bind normal keys in this mode, but they will be only active when a yes/no-prompt is asked. For other prompt modes, you can only bind special keys. -Useful hidden commands to map in this section: - - * `prompt-accept`: Confirm the entered value. - * `prompt-yes`: Answer yes to a yes/no question. - * `prompt-no`: Answer no to a yes/no question. - * `leave-mode`: Leave the prompt mode. - == aliases Aliases for commands. By default, no aliases are defined. Example which adds a new command `:qtb` to open qutebrowsers website: