From 7b80962e541ddc156762aa9d53cd6f00864b9178 Mon Sep 17 00:00:00 2001
From: Daniel Friesel <derf@finalrewind.org>
Date: Tue, 6 Nov 2018 21:13:56 +0100
Subject: Improve parts of feh(1)

---
 man/feh.pre | 36 +++++++++++++++++++++---------------
 1 file changed, 21 insertions(+), 15 deletions(-)

diff --git a/man/feh.pre b/man/feh.pre
index 34220a2..8a72f07 100644
--- a/man/feh.pre
+++ b/man/feh.pre
@@ -382,8 +382,7 @@ only affects smaller images and never scales larger than necessary to fit the
 screen size.
 The only exception is a
 .Ar zoom
-of 100, in which case images will always be shown at 100% zoom, no matter
-their dimensions.
+of 100, in which case images will always be shown at 100% zoom.
 .
 .Pp
 .
@@ -394,17 +393,17 @@ The thumbnail list itself will still be windowed.
 .
 .It Cm -g , --geometry Ar width Cm x Ar height | Cm + Ar x Cm + Ar y | Ar width Cm x Ar height Cm + Ar x Cm + Ar y
 .
-Limit (and don't change) the window size.
-Takes an X-style geometry
-.Ar string
-like 640x480 with optional +x+y window offset.
-Use
+Use a fixed window size as specified in the X-style geometry
+.Ar string ,
+e.g. 640x480.
+An optional +x+y window offset can be specified.
+Combine with
 .Cm --scale-down
 to scale down larger images like in fullscreen mode.
 .
-Also note that this option does not enforce the geometry, changing it by a tiling
+Note that this option does not enforce the window size; changing it by a tiling
 WM or manually is still possible.
-After each resize, the resulting window size is used as the new size limit.
+However, auto-resize remains disabled.
 .
 .It Cm -Y , --hide-pointer
 .
@@ -421,8 +420,9 @@ Accepted values: default, checks, or an XColor
 .
 In windowed mode, the default is checks
 .Pq a checkered background so transparent image parts are easy to see .
-In fullscreen and background setting mode, checks is not accepted and the
-default is black.
+In fullscreen and background setting mode,
+.Cm checks
+is not accepted and the default is black.
 .
 .It Cm -i , --index
 .
@@ -489,13 +489,19 @@ Returns false if at least one image failed to load.
 .
 .It Cm --conversion-timeout Ar timeout
 .
-Stop trying to convert unloadable files after
+.Nm
+can use ImageMagick to try converting unloadable files into a supportad
+file format.
+As this can take a long time, it is disabled by default.
+Set
 .Ar timeout
-seconds.
-Negative values disable conversion altogether, zero causes
+to a non-negative value to enable it.
+A positive value
+specifies after how many seconds conversion attempts should be aborted,
+zero causes
 .Nm
 to try indefinitely.
-By default, conversion is disabled.
+Negative values restore the default by disabling conversion altogether.
 .
 .It Cm --max-dimension Ar width No x Ar height
 .
-- 
cgit v1.2.3