diff options
Diffstat (limited to 'man/feh.pre')
| -rw-r--r-- | man/feh.pre | 64 |
1 files changed, 52 insertions, 12 deletions
diff --git a/man/feh.pre b/man/feh.pre index a9f9894..d3d3d1f 100644 --- a/man/feh.pre +++ b/man/feh.pre @@ -420,8 +420,8 @@ Only show images with width <= .Ar width and height <= .Ar height . -If you only care about one parameter, set the other to either something large -or -1. +If you only care about one parameter, set the other to 0 +.Pq or a negative value . . .It Cm -M , --menu-font Ar font . @@ -571,7 +571,18 @@ first, reverse the filelist with --reverse. . Start the filelist at .Ar filename . -See +. +Note that at the moment, +.Ar filename +must match an +.Pq expanded +path in the filelist. So, if the file to be matched is passed via an absolute +path in the filelist, +.Ar filename +must be an absolute path. If the file is passed via a relative path, +.Ar filename +must be an identical relative path. This is a known issue. +See also .Sx USAGE EXAMPLES . . .It Cm -T , --theme Ar theme @@ -809,7 +820,12 @@ on screen 0, the second on screen 1, and so on. . Use .Cm --no-xinerama -to treat the whole X display as one screen when setting wallpapers. +to treat the whole X display as one screen when setting wallpapers. You +may also use +.Cm --xinerama-index +to use +.Nm +as a background setter for a specific screen. . .Bl -tag -width indent . @@ -848,6 +864,21 @@ Do not write a .Pa ~/.fehbg file . +.It Cm --xinerama-index Ar screen +. +When used with any option other than +.Cm --bg-tile : +Only set wallpaper on +.Ar screen . +All other screens will be filled black/white. +. +This is most useful in a Xinerama configuration with overlapping screens. +For instance, assume you have two overlapping displays (index 0 and 1), where +index 0 is smaller. To center a background on the display with index 0 and +fill the extra space on index 1 black/white, use +.Qq --xinerama-index 0 +when setting the wallpaper. +. .El . . @@ -986,10 +1017,17 @@ 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 . An example entry would be -.Qq imagemap -rVq --thumb-width 40 --thumb-height 30 . +.Qq imagemap -rVq --thumb-width 40 --thumb-height 30 --index-info \&'%n\en\&%wx\&%h\&' . . .Pp . @@ -997,10 +1035,11 @@ You can use this theme in two ways. Either call .Qo .Nm -Timagemap *.jpg -.Qc +.Qc , or create a symbolic link to .Nm -with the name of the theme you want it to use. So from the example above: +with the name of the theme you want it to use. For the example above, +this would be .Qo ln -s `which .Nm @@ -1013,11 +1052,11 @@ to use these options. .Pp . Note that you can split a theme over several lines by placing a backslash at -the end of a line, like in the shell. +the end of an unfinished line. . .Pp . -You can combine these themes with commandline options. +Command line options always override theme options. . . .Sh KEYS CONFIG SYNTAX @@ -1150,7 +1189,7 @@ to close the menu. . .It n , Ao Space Ac , Ao Right Ac Bq next_img . -Show next image +Show next image. Selects the next image in thumbnail mode. . .It o Bq toggle_pointer . @@ -1158,7 +1197,7 @@ Toggle pointer visibility . .It p , Ao Backspace Ac , Ao Left Ac Bq prev_img . -Show previous image +Show previous image. Selects the previous image in thumbnail mode. . .It q , Ao Escape Ac Bq quit . @@ -1298,7 +1337,8 @@ Scroll down by one page . .It R, Ao keypad begin Ac Bq render . -Antialias the image +Antialias the image. +Opens the currently selected image in thumbnail mode. . .It Ao keypad + Ac , Ao Up Ac Bq zoom_in . |