From eed4b7c824592d127b5993da7ce0d8020576241a Mon Sep 17 00:00:00 2001 From: Daniel Friesel Date: Sat, 10 Feb 2018 16:57:24 +0100 Subject: feh(1): Document current theme quoting and parser behaviour --- man/feh.pre | 25 ++++++++++++++++++------- 1 file changed, 18 insertions(+), 7 deletions(-) (limited to 'man') 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 -- cgit v1.2.3