path: root/man/feh.pre
diff options
Diffstat (limited to 'man/feh.pre')
1 files changed, 18 insertions, 7 deletions
diff --git a/man/feh.pre b/man/feh.pre
index 76f64b3..f5d9b9c 100644
--- a/man/feh.pre
+++ b/man/feh.pre
@@ -1111,16 +1111,27 @@ is the name of the entry and
.Ar options
are the options which will be applied when the theme is used.
-Note that the options are not parsed by any shell. Therefore, filename expansion
-.Qq *.jpg
-and similar
-is not supported. Quoting with both single and double quotes works, though.
+Note that the option parser does not behave like a normal shell: filename
+expansion and backslash escape sequences are not supported and passed to
+feh's option parser as-is. However, quoting of arguments is respected
+and can be used for arguments with whitespace.
+So, the sequence
+.Qq --info Qq foo bar
+works as intended
+.Pq that is, it display the string Qq foo bar ,
+whereas the option string
+.Qq --info foo\e bar
+will only display
+.Qq foo\e
+and complain about the file bar not existing.
+Please keep this in mind when writing theme files.
-An example entry would be
+An example entry is
.Qq imagemap -rVq --thumb-width 40 --thumb-height 30 --index-info \&'%n\en\&%wx\&%h\&' .