diff --git a/doc/help/commands.asciidoc b/doc/help/commands.asciidoc index eb76fa84f..d13f20ead 100644 --- a/doc/help/commands.asciidoc +++ b/doc/help/commands.asciidoc @@ -9,13 +9,15 @@ In qutebrowser, all keybindings are mapped to commands. Some commands are hidden, which means they don't show up in the command completion when pressing `:`, as they're typically not useful to run by hand. -In the commandline, there are also some variables you can use: +For command arguments, there are also some variables you can use: - `{url}` expands to the URL of the current page - `{url:pretty}` expands to the URL in decoded format - `{clipboard}` expands to the clipboard contents - `{primary}` expands to the primary selection contents +It is possible to run or bind multiple commands by separating them with `;;`. + == Normal commands .Quick reference [options="header",width="75%",cols="25%,75%"] @@ -92,7 +94,7 @@ In the commandline, there are also some variables you can use: === adblock-update Update the adblock block lists. -This updates ~/.local/share/qutebrowser/blocked-hosts with downloaded host lists and re-reads ~/.config/qutebrowser/blocked-hosts. +This updates `~/.local/share/qutebrowser/blocked-hosts` with downloaded host lists and re-reads `~/.config/qutebrowser/blocked-hosts`. [[back]] === back @@ -724,8 +726,6 @@ Syntax: +:set-cmd-text [*--space*] [*--append*] 'text'+ Preset the statusbar to some text. -You can use the `{url}` and `{url:pretty}` variables here which will get replaced by the encoded/decoded URL. - ==== positional arguments * +'text'+: The commandline to set. @@ -742,8 +742,6 @@ Syntax: +:spawn [*--userscript*] [*--verbose*] [*--detach*] 'cmdline'+ Spawn a command in a shell. -Note the `{url}` and `{url:pretty}` variables might be useful here. `{url}` gets replaced by the URL in fully encoded format and `{url:pretty}` uses a "pretty form" with most percent-encoded characters decoded. - ==== positional arguments * +'cmdline'+: The commandline to execute. diff --git a/qutebrowser/browser/adblock.py b/qutebrowser/browser/adblock.py index afdc9922e..81fc2f7e1 100644 --- a/qutebrowser/browser/adblock.py +++ b/qutebrowser/browser/adblock.py @@ -182,8 +182,8 @@ class HostBlocker: def adblock_update(self, win_id): """Update the adblock block lists. - This updates ~/.local/share/qutebrowser/blocked-hosts with downloaded - host lists and re-reads ~/.config/qutebrowser/blocked-hosts. + This updates `~/.local/share/qutebrowser/blocked-hosts` with downloaded + host lists and re-reads `~/.config/qutebrowser/blocked-hosts`. """ self._read_hosts_file(self._config_hosts_file, self._config_blocked_hosts) diff --git a/qutebrowser/browser/commands.py b/qutebrowser/browser/commands.py index 7f6c6d4af..5dfd86242 100644 --- a/qutebrowser/browser/commands.py +++ b/qutebrowser/browser/commands.py @@ -1027,11 +1027,6 @@ class CommandDispatcher: def spawn(self, cmdline, userscript=False, verbose=False, detach=False): """Spawn a command in a shell. - Note the `{url}` and `{url:pretty}` variables might be useful here. - `{url}` gets replaced by the URL in fully encoded format and - `{url:pretty}` uses a "pretty form" with most percent-encoded - characters decoded. - Args: userscript: Run the command as a userscript. You can use an absolute path, or store the userscript in one of those diff --git a/qutebrowser/commands/__init__.py b/qutebrowser/commands/__init__.py index bf44e449a..70f058d82 100644 --- a/qutebrowser/commands/__init__.py +++ b/qutebrowser/commands/__init__.py @@ -22,10 +22,12 @@ Some commands are hidden, which means they don't show up in the command completion when pressing `:`, as they're typically not useful to run by hand. -In the commandline, there are also some variables you can use: +For command arguments, there are also some variables you can use: - `{url}` expands to the URL of the current page - `{url:pretty}` expands to the URL in decoded format - `{clipboard}` expands to the clipboard contents - `{primary}` expands to the primary selection contents + +It is possible to run or bind multiple commands by separating them with `;;`. """ diff --git a/qutebrowser/config/configdata.py b/qutebrowser/config/configdata.py index 1c01c8470..89aee870f 100644 --- a/qutebrowser/config/configdata.py +++ b/qutebrowser/config/configdata.py @@ -1401,8 +1401,7 @@ KEY_FIRST_COMMENT = """ # # For simple keys (no `<>`-signs), a capital letter means the key is pressed # with Shift. For special keys (with `<>`-signs), you need to explicitly add -# `Shift-` to match a key pressed with shift. You can bind multiple commands -# by separating them with `;;`. +# `Shift-` to match a key pressed with shift. # # Note that default keybindings are always bound, and need to be explicitly # unbound if you wish to remove them: diff --git a/qutebrowser/mainwindow/statusbar/command.py b/qutebrowser/mainwindow/statusbar/command.py index df419c0dd..79a5f0305 100644 --- a/qutebrowser/mainwindow/statusbar/command.py +++ b/qutebrowser/mainwindow/statusbar/command.py @@ -95,9 +95,6 @@ class Command(misc.MinimalLineEditMixin, misc.CommandLineEdit): def set_cmd_text_command(self, text, space=False, append=False): """Preset the statusbar to some text. - You can use the `{url}` and `{url:pretty}` variables here which will - get replaced by the encoded/decoded URL. - // Wrapper for set_cmd_text to check the arguments and allow multiple