summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorDaniel Friesel <derf@finalrewind.org>2018-02-10 16:57:24 +0100
committerDaniel Friesel <derf@finalrewind.org>2018-02-10 16:57:24 +0100
commiteed4b7c824592d127b5993da7ce0d8020576241a (patch)
treeffc71756cc2bbb282709ea3b62a5eac4bf672329 /man
parent078beeeaae30503620d0c9266bb8fd9ce3e08f1f (diff)
feh(1): Document current theme quoting and parser behaviour
Diffstat (limited to 'man')
-rw-r--r--man/feh.pre25
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
-.Po
-.Qq *.jpg
-and similar
-.Pc
-is not supported. Quoting with both single and double quotes works, though.
+.Pp
+.
+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.
.
.Pp
.
-An example entry would be
+An example entry is
.Qq imagemap -rVq --thumb-width 40 --thumb-height 30 --index-info \&'%n\en\&%wx\&%h\&' .
.
.Pp