From 1dd8d253d8af33a0cb824370df965b100fa16630 Mon Sep 17 00:00:00 2001
From: Florian Bruhin <me@the-compiler.org>
Date: Thu, 28 Mar 2019 07:27:32 +0100
Subject: [PATCH] Update docs

---
 doc/changelog.asciidoc                  | 4 ++++
 doc/help/commands.asciidoc              | 5 +++++
 doc/help/settings.asciidoc              | 1 +
 qutebrowser/components/caretcommands.py | 3 +--
 4 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/doc/changelog.asciidoc b/doc/changelog.asciidoc
index fad87462c..770c7892a 100644
--- a/doc/changelog.asciidoc
+++ b/doc/changelog.asciidoc
@@ -23,6 +23,9 @@ Added
 
 - New settings:
   * `colors.tabs.pinned.*` to control colors of pinned tabs.
+- New commands:
+  * `:reverse-selection` (`o` in caret mode) to swap the stationary/moving ends
+    of a selection.
 
 Changed
 ~~~~~~~
@@ -31,6 +34,7 @@ Changed
   `org.qutebrowser.qutebrowser.desktop`.
 - Pinned tabs now always show a favicon (even if the site doesn't provide one)
   when shrinking.
+- Slight performance improvements for the `:open` completion.
 
 Fixed
 ~~~~~
diff --git a/doc/help/commands.asciidoc b/doc/help/commands.asciidoc
index f0328f2c6..f7f928a48 100644
--- a/doc/help/commands.asciidoc
+++ b/doc/help/commands.asciidoc
@@ -1556,6 +1556,7 @@ How many steps to zoom out.
 |<<prompt-item-focus,prompt-item-focus>>|Shift the focus of the prompt file completion menu to another item.
 |<<prompt-open-download,prompt-open-download>>|Immediately open a download.
 |<<prompt-yank,prompt-yank>>|Yank URL to clipboard or primary selection.
+|<<reverse-selection,reverse-selection>>|Swap the stationary and moving end of the current selection.
 |<<rl-backward-char,rl-backward-char>>|Move back a character.
 |<<rl-backward-delete-char,rl-backward-delete-char>>|Delete the character before the cursor.
 |<<rl-backward-kill-word,rl-backward-kill-word>>|Remove chars from the cursor to the beginning of the word.
@@ -1776,6 +1777,10 @@ Yank URL to clipboard or primary selection.
 ==== optional arguments
 * +*-s*+, +*--sel*+: Use the primary selection instead of the clipboard.
 
+[[reverse-selection]]
+=== reverse-selection
+Swap the stationary and moving end of the current selection.
+
 [[rl-backward-char]]
 === rl-backward-char
 Move back a character.
diff --git a/doc/help/settings.asciidoc b/doc/help/settings.asciidoc
index e500bd5ad..e1e6793be 100644
--- a/doc/help/settings.asciidoc
+++ b/doc/help/settings.asciidoc
@@ -436,6 +436,7 @@ Default:
 * +pass:[j]+: +pass:[move-to-next-line]+
 * +pass:[k]+: +pass:[move-to-prev-line]+
 * +pass:[l]+: +pass:[move-to-next-char]+
+* +pass:[o]+: +pass:[reverse-selection]+
 * +pass:[v]+: +pass:[toggle-selection]+
 * +pass:[w]+: +pass:[move-to-next-word]+
 * +pass:[y]+: +pass:[yank selection]+
diff --git a/qutebrowser/components/caretcommands.py b/qutebrowser/components/caretcommands.py
index 5f1ffe044..e9d861d02 100644
--- a/qutebrowser/components/caretcommands.py
+++ b/qutebrowser/components/caretcommands.py
@@ -214,6 +214,5 @@ def follow_selected(tab_obj: apitypes.Tab, *, tab: bool = False) -> None:
 @cmdutils.register(modes=[cmdutils.KeyMode.caret])
 @cmdutils.argument('tab', value=cmdutils.Value.cur_tab)
 def reverse_selection(tab: apitypes.Tab) -> None:
-    """Switch the stationary end of the current selection with the
-    moving end."""
+    """Swap the stationary and moving end of the current selection."""
     tab.caret.reverse_selection()