feh.1: Rework DESCRIPTION/MODES a bit

1 files changed, 20 insertions, 29 deletions

diff --git a/man/feh.1 b/man/feh.1
index b68e91d..b6e69f8 100644
--- a/man/feh.1
+++ b/man/feh.1
@@ -9,28 +9,33 @@
 .Sh SYNOPSIS
 .Nm
 .Op Ar options
-.Ar
+.Ar files or directories ...
 .
 .Sh DESCRIPTION
 .Nm
-is an image viewer using the imlib2 library to open and manipulate
-images.  It has a large number of operational modes.  The default mode is an
-image slideshow, showing one image at a time from those specified on the
-command line.  Keys and mouse control may be used to move through them.
-Other modes can be specified on the commandline, and are described below.
+is a mode-based image viewer useful for viewing and cataloguing images.  It
+is especially aimed at commandline 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 imagee.
 .Pp
 .Nm
-can also recurse through a directory structure to form a filelist for
-processing, and will convert directory names on the commandline into a list
-of their contents automatically.
-.Pp
-Filelists can be sorted in a number of ways.  The default is the order in
-which the files were specified on the commandline, or the order in which they
-were read from the disk.  You can specify sorting modes such as randomize
-or you can sort by filename, image name, width, height, pixels, etc.
-Filelists can also be saved to or loaded from files.
+supports filelists, various image sorting modes, image captions and more.
+Control happens via keyboard shortcuts; the mouse can also be used to control
+it, but is only required for very few actions.
 .
 .Sh MODES
+.Nm
+is based on various modes, which are selected at startup by comandline
+options.
+.Pp
+Slideshow mode is the default.  It opens one window and displays the first
+image in it, the keyboard and mouse can be used to change slides
+.Pq images .
+In slideshow mode, images can be deleted either from the filelist or from the
+disk, the new filelist can then be saved to the disk and reopened at a later
+time.
+.Pp
 Montage mode forms a montage from the filelist.  The resulting image can be
 viewed or saved, and its size can be limited by height, width or both.
 .Pp
@@ -48,9 +53,6 @@ the selected image in a new window.
 Multiwindow mode shows images in multiple windows, instead of as a slideshow
 in one window.  Don't use with a large filelist ;)
 .Pp
-Fullscreen mode shows images in fullscreen view.  Can be combined with a
-slide-change delay to show an automated presentation.
-.Pp
 List mode doesn't display images.  Outputs an
 .Cm ls - No style
 listing of the files in the filelist, including image info such as size,
@@ -60,17 +62,6 @@ in the format you choose.
 .Nm
 can also list either all the loadable files in a filelist or all the
 unloadable files.  Useful for preening a directory.
-.Pp
-.Nm
-also has the ability to load files via http or ftp, simply specify the url on
-the commandline.
-.Pp
-.Nm
-can read options from the commandline, or from a config file.  The syntax is
-the same in each case.  See
-.Sx CONFIG FILE SYNTAX
-for details about using themes defined in a config file.
-These methods may be used in conjunction.
 .
 .Sh OPTIONS
 .Bl -tag -width indent