summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorFlorian Bruhin <me@the-compiler.org>2021-03-23 20:30:42 +0100
committerFlorian Bruhin <me@the-compiler.org>2021-03-23 20:30:42 +0100
commit5e4b1ffc0b897df36595db51c3b1920703c6e1b6 (patch)
tree29fb3dd122f6bf8348304badf9a685565ae8f393 /doc
parent2d191f31501b4fa8e120c49eef1b9ee1bf50d257 (diff)
downloadqutebrowser-5e4b1ffc0b897df36595db51c3b1920703c6e1b6.tar.gz
qutebrowser-5e4b1ffc0b897df36595db51c3b1920703c6e1b6.zip
Update docs
Diffstat (limited to 'doc')
-rw-r--r--doc/changelog.asciidoc7
-rw-r--r--doc/help/settings.asciidoc17
2 files changed, 24 insertions, 0 deletions
diff --git a/doc/changelog.asciidoc b/doc/changelog.asciidoc
index dc739ba3a..fe9e34d96 100644
--- a/doc/changelog.asciidoc
+++ b/doc/changelog.asciidoc
@@ -40,6 +40,10 @@ Added
- New `--pinned` argument for `:tab-only`, which replaces `--force` (with
`--pinned close`), but also can take `--pinned keep` to keep pinned tabs
without prompting.
+- New `fileselect.folder.command` which can be used with
+ `fileselect.handler = external` to customize the command to use to upload
+ directories (`<input type="file" webkitdirectory />` elements, which are
+ non-standard but in wide use).
Changed
~~~~~~~
@@ -75,6 +79,9 @@ Changed
issue.
- The `readability-js` userscript now displays a small header with page
information.
+- When an external file selector is used, some additional validation is done on
+ the picked files now, so that errors are shown if e.g. a directory is selected
+ when a file was expected.
Fixed
~~~~~
diff --git a/doc/help/settings.asciidoc b/doc/help/settings.asciidoc
index 9f3b7bce6..ad6ec6ff1 100644
--- a/doc/help/settings.asciidoc
+++ b/doc/help/settings.asciidoc
@@ -207,6 +207,7 @@
|<<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 `edit-*` commands.
|<<editor.encoding,editor.encoding>>|Encoding to use for the editor.
+|<<fileselect.folder.command,fileselect.folder.command>>|Command (and arguments) to use for selecting a single folder in forms. The command should write the selected folder path to the specified file or stdout.
|<<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 or to stdout, separated by newlines.
|<<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 or stdout.
@@ -2835,6 +2836,22 @@ Type: <<types,Encoding>>
Default: +pass:[utf-8]+
+[[fileselect.folder.command]]
+=== fileselect.folder.command
+Command (and arguments) to use for selecting a single folder in forms. The command should write the selected folder path to the specified file or stdout.
+The following placeholders are defined:
+* `{}`: Filename of the file to be written to. If not contained in any argument, the
+ standard output of the command is read instead.
+
+Type: <<types,ShellCommand>>
+
+Default:
+
+- +pass:[xterm]+
+- +pass:[-e]+
+- +pass:[ranger]+
+- +pass:[--choosedir={}]+
+
[[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.