Update docs/changelog

2 files changed, 10 insertions, 6 deletions

diff --git a/doc/changelog.asciidoc b/doc/changelog.asciidoc
index e9f71ecf0..7f0fcec87 100644
--- a/doc/changelog.asciidoc
+++ b/doc/changelog.asciidoc
@@ -101,6 +101,10 @@ Added
    * `content.blocking.adblock.lists` to configure ABP-like lists to use.
 - New `qt.environ` setting which makes it easier to set/unset environment
   variables for qutebrowser.
+- New settings to use an external file picker (such as ranger or vifm):
+  * `fileselect.handler` (`default` or `external`)
+  * `fileselect.multiple_files.command`
+  * `fileselect.single_file.command`
 - When QtWebEngine has been updated but PyQtWebEngine hasn't yet, the dark mode
   settings might stop working. As a (currently undocumented) escape hatch, this
   version adds a `QUTE_DARKMODE_VARIANT=qt_515_2` environment variable which can
diff --git a/doc/help/settings.asciidoc b/doc/help/settings.asciidoc
index 4a91c76ce..5b3554068 100644
--- a/doc/help/settings.asciidoc
+++ b/doc/help/settings.asciidoc
@@ -204,9 +204,9 @@
 |<<downloads.remove_finished,downloads.remove_finished>>|Duration (in milliseconds) to wait before removing finished downloads.
 |<<editor.command,editor.command>>|Editor (and arguments) to use for the `open-editor` command.
 |<<editor.encoding,editor.encoding>>|Encoding to use for the editor.
-|<<fileselect.handler,fileselect.handler>>|Handler for selecting file(s) in forms.
+|<<fileselect.handler,fileselect.handler>>|Handler for selecting file(s) in forms. If `external`, then the commands specified by `fileselect.single_file.command` and `fileselect.multiple_files.command` are used to select one or multiple files respectively.
 |<<fileselect.multiple_files.command,fileselect.multiple_files.command>>|Command (and arguments) to use for selecting multiple files in forms. The command should write the selected file paths to the specified file, separated by newlines.
-|<<fileselect.single_file.command,fileselect.single_file.command>>|Command (and arguments) to use for selecting a file in forms. The command should write the selected file path to the specified file.
+|<<fileselect.single_file.command,fileselect.single_file.command>>|Command (and arguments) to use for selecting a single file in forms. The command should write the selected file path to the specified file.
 |<<fonts.completion.category,fonts.completion.category>>|Font used in the completion categories.
 |<<fonts.completion.entry,fonts.completion.entry>>|Font used in the completion widget.
 |<<fonts.contextmenu,fonts.contextmenu>>|Font used for the context menu.
@@ -2774,7 +2774,7 @@ Default: +pass:[utf-8]+
 
 [[fileselect.handler]]
 === fileselect.handler
-Handler for selecting file(s) in forms.
+Handler for selecting file(s) in forms. If `external`, then the commands specified by `fileselect.single_file.command` and `fileselect.multiple_files.command` are used to select one or multiple files respectively.
 
 Type: <<types,String>>
 
@@ -2797,11 +2797,11 @@ Default:
 
 - +pass:[xterm]+
 - +pass:[-e]+
-- +pass:[export COLUMNS= LINES=;ranger --choosefiles={}]+
+- +pass:[ranger --choosefiles={}]+
 
 [[fileselect.single_file.command]]
 === fileselect.single_file.command
-Command (and arguments) to use for selecting a file in forms. The command should write the selected file path to the specified file.
+Command (and arguments) to use for selecting a single file in forms. The command should write the selected file path to the specified file.
 The following placeholders are defined:
 * `{}`: Filename of the file to be written to.
 
@@ -2811,7 +2811,7 @@ Default:
 
 - +pass:[xterm]+
 - +pass:[-e]+
-- +pass:[export COLUMNS= LINES=;ranger --choosefile={}]+
+- +pass:[ranger --choosefile={}]+
 
 [[fonts.completion.category]]
 === fonts.completion.category