diff options
Diffstat (limited to 'man')
-rw-r--r-- | man/Makefile | 1 | ||||
-rw-r--r-- | man/feh.pre | 82 |
2 files changed, 58 insertions, 25 deletions
diff --git a/man/Makefile b/man/Makefile index 3be07e3..8fe2cbd 100644 --- a/man/Makefile +++ b/man/Makefile @@ -13,6 +13,7 @@ all: ${TARGETS} -e 's/\$$MAN_DEBUG\$$/${MAN_DEBUG}/' \ -e 's/\$$MAN_EXIF\$$/${MAN_EXIF}/' \ -e 's/\$$MAN_INOTIFY\$$/${MAN_INOTIFY}/' \ + -e 's/\$$MAN_MAGIC\$$/${MAN_MAGIC}/' \ -e 's/\$$MAN_XINERAMA\$$/${MAN_XINERAMA}/' \ < ${@:.1=.pre} > $@ diff --git a/man/feh.pre b/man/feh.pre index 340d6cd..cd65b83 100644 --- a/man/feh.pre +++ b/man/feh.pre @@ -41,6 +41,9 @@ libexif builtin EXIF reader $MAN_EXIF$ .It inotify-based auto-reload of changed files $MAN_INOTIFY$ . +.It +libmagic $MAN_MAGIC$ +. .El . $MAN_DEBUG$ @@ -151,34 +154,41 @@ 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 . -As Imlib2 may take several seconds to determine whether it can load a file or -not -.Pq e.g. when attempting to open a large video , +.Pq optional feature, $MAN_MAGIC$ in this build +.Nm +can use libmagic to only pass image files to Imlib2. +When using .Nm -checks each file's header before loading it. -If it looks like an image, it is passed on to Imlib2, otherwise, it is -assumed to be unloadable. -This greatly improves performance when working in directories with mixed files -.Pq i.e., directories which do not exclusively contain image files . +with lots of non-image files +.Pq especially with Imlib2 version 1.6.x or 1.7.0 , +this can speed up the detection of non-image files significantly. If you think that Imlib2 can load a file which .Nm has determined to be likely not an image, set the environment variable .Qq FEH_SKIP_MAGIC -to pass all files directly to Imlib2, bypassing the header check. +to pass all files directly to Imlib2, bypassing this check. The environment variable's value does not matter, it just needs to be set. . .Sh OPTIONS @@ -565,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 . @@ -661,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 . @@ -789,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 @@ -819,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 @@ -905,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 . @@ -970,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. . . @@ -1342,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 @@ -2207,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 . @@ -2237,7 +2269,7 @@ SOFTWARE. . .Pp . -Current developer: Daniel Friesel +Current developer: Birte Friesel .Aq derf@finalrewind.org . .Pp |