diff options
| author | Daniel Friesel <derf@finalrewind.org> | 2022-06-12 13:36:41 +0200 | 
|---|---|---|
| committer | Daniel Friesel <derf@finalrewind.org> | 2022-06-12 13:38:57 +0200 | 
| commit | 8b928d357fbe89dfb33abe5d922843ac0b897ca4 (patch) | |
| tree | 426b668a67148f6e9aa013e4a51f2a5151a236cf | |
| parent | 05a07126569fe2d2168ab3077a0891c4c872e389 (diff) | |
feh(1), --version: Document libmagic compile flag
| -rw-r--r-- | config.mk | 3 | ||||
| -rw-r--r-- | man/Makefile | 1 | ||||
| -rw-r--r-- | man/feh.pre | 21 | ||||
| -rw-r--r-- | src/options.c | 4 | 
4 files changed, 20 insertions, 9 deletions
| @@ -72,6 +72,9 @@ endif  ifeq (${magic},1)  	CFLAGS += -DHAVE_LIBMAGIC  	LDLIBS += -lmagic +	MAN_MAGIC = enabled +else +	MAN_MAGIC = disabled  endif  ifeq (${verscmp},1) 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 diff --git a/src/options.c b/src/options.c index 71c65e2..d3524f7 100644 --- a/src/options.c +++ b/src/options.c @@ -976,6 +976,10 @@ static void show_version(void)  		"help "  #endif +#ifdef HAVE_LIBMAGIC +		"magic " +#endif +  #if _FILE_OFFSET_BITS == 64  		"stat64 "  #endif | 
