summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorDaniel Friesel <derf@finalrewind.org>2022-06-12 13:36:41 +0200
committerDaniel Friesel <derf@finalrewind.org>2022-06-12 13:38:57 +0200
commit8b928d357fbe89dfb33abe5d922843ac0b897ca4 (patch)
tree426b668a67148f6e9aa013e4a51f2a5151a236cf /man
parent05a07126569fe2d2168ab3077a0891c4c872e389 (diff)
feh(1), --version: Document libmagic compile flag
Diffstat (limited to 'man')
-rw-r--r--man/Makefile1
-rw-r--r--man/feh.pre21
2 files changed, 13 insertions, 9 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..1899800 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$
@@ -165,20 +168,20 @@ with a non-negative value to enable support for these formats.
.
.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.
+This feature is $MAN_MAGIC$ in this build.
+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