summaryrefslogtreecommitdiff
path: root/man/feh.pre
diff options
context:
space:
mode:
Diffstat (limited to 'man/feh.pre')
-rw-r--r--man/feh.pre63
1 files changed, 46 insertions, 17 deletions
diff --git a/man/feh.pre b/man/feh.pre
index 1899800..cd65b83 100644
--- a/man/feh.pre
+++ b/man/feh.pre
@@ -154,24 +154,31 @@ pnm, tiff, and bmp.
The gif format is also supported, but only for static images.
In case of animations, only the first frame will be shown.
.
-If the convert binary
-.Pq supplied by ImageMagick
-is available, it also has limited support for many other file types, such as
-svg, xcf and otf.
-If dcraw is available,
-.Nm
-also supports RAW files provided by cameras and will display the embedded
-thumbnails.
-Use
+.Pp
+.
+When invoked with
.Cm --conversion-timeout Ar timeout
-with a non-negative value to enable support for these formats.
+.Po
+and a non-negative
+.Ar timeout
+value
+.Pc ,
+.Nm
+also has limited support for various other file types by means of external
+conversion programs.
+If the dcraw binary is available,
+.Nm
+will use it to display the thumbnails embedded into RAW files provided by
+digital cameras and similar.
+If the ImageMagick convert binary is available,
+.Nm
+will use it to load file types such as svg, xcf, and otf.
.
.Pp
.
.Pq optional feature, $MAN_MAGIC$ in this build
.Nm
can use libmagic to only pass image files to Imlib2.
-This feature is $MAN_MAGIC$ in this build.
When using
.Nm
with lots of non-image files
@@ -568,6 +575,9 @@ Useful in scripts to hunt out images of a certain size/resolution/type etc.
Don't display images.
Just print out their names if imlib2 can successfully load them.
Returns false if at least one image failed to load.
+When combined with
+.Cm --action ,
+the specified action will be run for each loadable image.
.
.It Cm --max-dimension Ar width No x Ar height
.
@@ -664,7 +674,10 @@ and next image.
.Cm quit
will cause
.Nm
-to quit when trying to advance past the last image in the slide show.
+to quit when trying to advance past the last image in the slide show. This is
+the behavior of the obsolete
+.Cm --cycle-once
+option.
.
.Pp
.
@@ -792,9 +805,9 @@ in paused mode.
.
Sort file list according to image parameters.
Allowed sort types are:
-.Cm name , filename , dirname , mtime , width , height , pixels , size , format .
+.Cm name , none , filename , dirname , mtime , width , height , pixels , size , format .
For sort modes other than
-.Cm name , filename , dirname ,
+.Cm name , none , filename , dirname ,
or
.Cm mtime ,
a preload run is
@@ -822,6 +835,11 @@ you can use
.Cm --version-sort
to sort numbers naturally, so that e.g. 10.jpg comes after 2.jpg.
.
+.Pp
+.
+.Cm none
+is the default; you can specify it explicitly to discard a sort mode that has
+been specified at an earlier point in the command line arguments.
.It Cm -| , --start-at Ar filename
.
Start the filelist at
@@ -908,6 +926,9 @@ See
Don't display images.
Just print out their names if imlib2 can NOT successfully load them.
Returns false if at least one image was loadable.
+When combined with
+.Cm --action ,
+the specified action will be run for each unloadable file.
.
.It Cm -V , --verbose
.
@@ -973,7 +994,7 @@ when setting the wallpaper.
.Pp
.
Use
-.Cm xrandr --listmonitor
+.Cm xrandr --listmonitors
to determine how Xinerama monitor IDs map to screens/monitors in your setup.
.
.
@@ -1345,6 +1366,14 @@ Number of current file
.
Image width
.
+.\" .It %W
+.\" .
+.\" Window dimensions and offset as WxH+x+y
+.\" .Pq X11 geometry format .
+.\" Note that this is currently only properly updated when changing images;
+.\" offsets for the first image after starting feh and after changing window
+.\" geometry may be bogus.
+.
.It %v
.
.Nm
@@ -2210,7 +2239,7 @@ is a hobby project, so bug reports may be addressed with significant delays.
.
Copyright (C) 1999, 2000 by Paul Duncan.
Copyright (C) 1999, 2000 by Tom Gilbert and contributors.
-Copyright (C) 2010-2020 by Daniel Friesel and contributors.
+Copyright (C) 2010-2023 by Birte Kristina Friesel and contributors.
.
.Pp
.
@@ -2240,7 +2269,7 @@ SOFTWARE.
.
.Pp
.
-Current developer: Daniel Friesel
+Current developer: Birte Friesel
.Aq derf@finalrewind.org
.
.Pp