summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Friesel <derf@finalrewind.org>2018-11-07 20:15:26 +0100
committerDaniel Friesel <derf@finalrewind.org>2018-11-07 20:15:26 +0100
commit0c4d8edf95abeacfa0d98d34d05d34fee051362c (patch)
tree5263e2e0ef861f474e556205a9c335e142e6e969
parent7b80962e541ddc156762aa9d53cd6f00864b9178 (diff)
Further manpage refinements
-rw-r--r--man/feh.pre74
1 files changed, 34 insertions, 40 deletions
diff --git a/man/feh.pre b/man/feh.pre
index 8a72f07..35ff062 100644
--- a/man/feh.pre
+++ b/man/feh.pre
@@ -37,8 +37,7 @@ It is especially aimed at command line users who need a fast image viewer
without huge GUI dependencies, though it can also be started by
.Pq graphical
file managers to view an image.
-By default
-.Pq unless arguments or a filelist are specified ,
+When no file arguments or filelists are specified,
.Nm
displays all files in the current directory.
.
@@ -96,7 +95,7 @@ and its size can be limited by height, width or both.
.
Index mode forms an index print from the filelist.
Image thumbnails are shown along with the filename,
-filesize and pixel size, printed using a truetype
+size and dimensions, printed using a truetype
font of your choice.
The resulting image can be viewed or saved, and its size
can be limited by height, width or both.
@@ -148,7 +147,7 @@ also supports RAW files provided by cameras and will display the embedded
thumbnails.
Use
.Cm --conversion-timeout Ar num
-with a non-negative value to enable it.
+with a non-negative value to enable support for these formats.
.
.
.Sh OPTIONS
@@ -376,7 +375,7 @@ to get a progress bar.
.
Make the window fullscreen.
Note that in this mode, large images will always be scaled down to fit the
-screen,
+screen, and
.Cm --zoom Ar zoom
only affects smaller images and never scales larger than necessary to fit the
screen size.
@@ -463,10 +462,9 @@ or in the current working directory.
.
.It Cm --insecure
.
-When viewing files with HTTPS, this option disables strict hostname and peer
-checking.
-This allows images on sites with self-signed certificates to be opened, but is
-no more secure than plain HTTP.
+When viewing files with HTTPS, this option disables all certificate checks. It
+allows images on sites with self-signed or expired certificates to be opened,
+but is no more secure than plain HTTP.
.
.It Cm --keep-zoom-vp
.
@@ -635,8 +633,9 @@ to the content of those directories, all the way down to the bottom level.
.
.It Cm --no-recursive
.
-Don't recursively expand any directories (enabled by default).
-Useful to override theme options.
+Don't recursively expand any directories.
+This is the default, but this option is useful to override themes containing
+.Cm --recursive .
.
.It Cm -R , --reload Ar int
.
@@ -644,7 +643,7 @@ Reload filelist and current image after
.Ar int
seconds.
Useful for viewing HTTP webcams or frequently changing directories.
-.Pq Note that the filelist reloading is still experimental.
+.Pq Note that filelist reloading is still experimental.
.
.Pp
.
@@ -680,10 +679,10 @@ In tiling environments, this also causes the image to be centered in the window.
Scroll
.Ar count
pixels whenever scroll_up, scroll_down, scroll_left or scroll_right is pressed.
-Note that this option accepts negative numbers in case you need to inverse the
-scroll direction; see
+Note that this option accepts negative numbers in case you need to reverse the
+scroll direction. See
.Sx KEYS CONFIG SYNTAX
-to change it permanently.
+for how to reverse it permanently.
Default: 20
.
.It Cm -D , --slideshow-delay Ar float
@@ -1001,20 +1000,14 @@ be printed.
.
Redraw thumbnail window every
.Ar n
-images.
-In
-.Nm
-<= 1.5, the thumbnail image used to be redrawn after every computed thumbnail
-.Pq so, it updated immediately .
-However, since the redrawing takes quite long
-.Pq especially for thumbnail mode on a large filelist ,
-this turned out to be a major performance penalty.
-As a workaround, the thumbnail image is redrawn every 10th image now by default.
+images while generating thumbnails.
+Redrawing takes quite long, so the default is 10.
Set
.Ar n No = 1
-to get the old behaviour,
-.Ar n No = 0
-will only redraw once all thumbnails are loaded.
+to update the thumbnail window immediately.
+With
+.Ar n No = 0 ,
+there will only be one redraw once all thumbnails are loaded.
.
.El
.
@@ -1250,7 +1243,7 @@ If the files are not found in that directory, it will also try
All config files treat lines starting with a
.Qq #
character as comments.
-Note that mid-line comments are not supported.
+Comments at the end of a line are not supported.
.
.
.Sh THEMES CONFIG SYNTAX
@@ -1473,7 +1466,7 @@ will keep zoom and X, Y offset when switching images.
.It m Bq toggle_menu
.
Show menu.
-Use the arrow keys and return to select items,
+Use the arrow keys and return to select items, and
.Aq escape
to close the menu.
.
@@ -1635,7 +1628,7 @@ Scroll up
.It Ao keypad Down Ac , Ao Ctrl+Down Ac Bq scroll_down
.
Scroll down.
-Note that the scroll keys work without anti-aliasing for performance reasons,
+Note that the scroll keys work without anti-aliasing for performance reasons;
hit the render key after scrolling to antialias the image.
.
.It Aq Alt+Left Bq scroll_left_page
@@ -1869,7 +1862,7 @@ Switch to previous image
.
Here are some examples of useful option combinations.
See also:
-.Aq http://feh.finalrewind.org/examples/
+.Aq https://feh.finalrewind.org/examples/
.
.Bl -tag -width indent
.
@@ -1941,7 +1934,7 @@ Same as above
.
Show some EXIF information, extracted by exifprobe/exifgrep
.
-.It feh --action 'rm %F' -rl --max-dim 1000x800
+.It feh --action 'rm %F' -rl --max-dimension 1000x800
.
Recursively remove all images with dimensions below or equal to 1000x800 pixels
from the current directory.
@@ -1951,23 +1944,24 @@ from the current directory.
.
.Sh DEPENDENCIES
.
+When
+.Cm --edit
+is used,
.Nm
-requires the
+needs the
.Cm jpegtran
and
.Cm jpegexiforient
binaries
.Pq usually distributed in Qo libjpeg-progs Qc or similar
-for lossless rotation.
+for lossless JPEG rotation.
.
.Pp
.
-To view images from URLs such as http://, you need
+To view images from URLs such as http://,
.Nm
-compiled with libcurl support (enabled by default).
-See the
-.Sx VERSION
-section.
+must be compiled with libcurl support.
+It is $MAN_CURL$ in this build
.
.
.Sh BUGS
@@ -2074,4 +2068,4 @@ Tom Gilbert
.Pp
.
See also:
-http://feh.finalrewind.org
+https://feh.finalrewind.org