|author||Daniel Friesel <firstname.lastname@example.org>||2018-11-07 20:15:26 +0100|
|committer||Daniel Friesel <email@example.com>||2018-11-07 20:15:26 +0100|
Further manpage refinements
Diffstat (limited to 'man')
1 files changed, 34 insertions, 40 deletions
diff --git a/man/feh.pre b/man/feh.pre
index 8a72f07..35ff062 100644
@@ -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
file managers to view an image.
-.Pq unless arguments or a filelist are specified ,
+When no file arguments or filelists are specified,
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
.Cm --conversion-timeout Ar num
-with a non-negative value to enable it.
+with a non-negative value to enable support for these formats.
@@ -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
.Cm --zoom Ar zoom
only affects smaller images and never scales larger than necessary to fit the
@@ -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
-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
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.
@@ -680,10 +679,10 @@ In tiling environments, this also causes the image to be centered in the window.
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.
.It Cm -D , --slideshow-delay Ar float
@@ -1001,20 +1000,14 @@ be printed.
Redraw thumbnail window every
-<= 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.
.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.
+.Ar n No = 0 ,
+there will only be one redraw once all thumbnails are loaded.
@@ -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
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
-Use the arrow keys and return to select items,
+Use the arrow keys and return to select items, and
to close the menu.
@@ -1635,7 +1628,7 @@ Scroll up
.It Ao keypad Down Ac , Ao Ctrl+Down Ac Bq 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.
.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.
.Pq usually distributed in Qo libjpeg-progs Qc or similar
-for lossless rotation.
+for lossless JPEG rotation.
-To view images from URLs such as http://, you need
+To view images from URLs such as http://,
-compiled with libcurl support (enabled by default).
+must be compiled with libcurl support.
+It is $MAN_CURL$ in this build
@@ -2074,4 +2068,4 @@ Tom Gilbert