Merge remote-tracking branch 'origin/pr/5987'

1 files changed, 44 insertions, 0 deletions

diff --git a/doc/help/settings.asciidoc b/doc/help/settings.asciidoc
index 5d48cf420..4a91c76ce 100644
--- a/doc/help/settings.asciidoc
+++ b/doc/help/settings.asciidoc
@@ -204,6 +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.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.
 |<<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.
@@ -2769,6 +2772,47 @@ Type: <<types,Encoding>>
 
 Default: +pass:[utf-8]+
 
+[[fileselect.handler]]
+=== fileselect.handler
+Handler for selecting file(s) in forms.
+
+Type: <<types,String>>
+
+Valid values:
+
+ * +default+: Use the default file selector.
+ * +external+: Use an external command.
+
+Default: +pass:[default]+
+
+[[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.
+The following placeholders are defined:
+* `{}`: Filename of the file to be written to.
+
+Type: <<types,ShellCommand>>
+
+Default: 
+
+- +pass:[xterm]+
+- +pass:[-e]+
+- +pass:[export COLUMNS= LINES=;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.
+The following placeholders are defined:
+* `{}`: Filename of the file to be written to.
+
+Type: <<types,ShellCommand>>
+
+Default: 
+
+- +pass:[xterm]+
+- +pass:[-e]+
+- +pass:[export COLUMNS= LINES=;ranger --choosefile={}]+
+
 [[fonts.completion.category]]
 === fonts.completion.category
 Font used in the completion categories.