summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
Diffstat (limited to 'man')
-rw-r--r--man/feh.pre64
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
.