summaryrefslogtreecommitdiff
path: root/feh.1
diff options
context:
space:
mode:
authorDaniel Friesel <derf@derf.homelinux.org>2010-03-21 16:57:12 +0100
committerDaniel Friesel <derf@derf.homelinux.org>2010-03-21 16:57:12 +0100
commit031cf5e8ffd0511c1d69a41da295ab6bb017bc1d (patch)
treea1e909a0c683e2ab1d684d61a7664111d3632302 /feh.1
parentb3c405408fb7abaad6039b65d86ef701b12c9f0a (diff)
Remove autoconf (from branch 'autocruft')
Use config.mk for configuration, both GNU make and FreeBSD make are supported.
Diffstat (limited to 'feh.1')
-rw-r--r--feh.1720
1 files changed, 0 insertions, 720 deletions
diff --git a/feh.1 b/feh.1
deleted file mode 100644
index 6192b73..0000000
--- a/feh.1
+++ /dev/null
@@ -1,720 +0,0 @@
-.TH feh 1 "August 14, 2001"
-.SH NAME
-feh - image viewer and cataloguer
-.SH SYNOPSIS
-feh [options] file(s)
-.SH DESCRIPTION
-.B feh
-is an image viewer using the
-.B imlib2
-library to open and manipulate images.
-.B feh
-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
-commandline. Keys and mouse control may be used to move through them. Other
-modes can be specified on the commandline, and are described below.
-.PP
-.B feh
-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
-.B Filelists
-can be sorted in a number of ways. The default is the order the files were
-specified on the commandline, or the order they were read from the disk. You
-can specify sorting modes such as
-.B
-randomize
-or you can sort by filename, image name, width, height, pixels, etc.
-Filelists can also be saved to or loaded from files.
-.SH MODES
-.B Montage mode
-forms a montage from the filelist. The resultant image can be viewed or
-saved, and it's size can be limited by height, width or both.
-.PP
-.B Collage mode
-is very similar to montage mode, except the images are distributed randomly
-and may overlap eachother
-.PP
-.B 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 font of
-your choice. The resultant image can be viewed or saved, and it's size can
-be limited by height, width or both.
-.PP
-.B Thumbnail mode
-is like index mode, but the mini-images are clickable, and launch the
-clicked image in a browser window.
-.PP
-.B Multiwindow mode
-shows images in multiple windows, instead of as a slideshow in one window.
-Don't use with a large filelist ;)
-.PP
-.B Fullscreen mode
-shows image in fullscreen view, can be combined with a slide-change delay to
-show an automated presentation.
-.PP
-.B List mode
-doesn't display images. Outputs an 'ls'-style listing of the files in the
-filelist, including image info such as size, pixels, type, etc. Customlist
-mode will display whatever image info you want, in the format you choose.
-.PP
-.B feh
-can also list either all the loadable files in a filelist or all the
-unloadable files. Useful for preening a directory.
-.PP
-.B feh
-also has the ability to load files over http or ftp, simply specify the url
-on the commandline.
-.PP
-.B feh
-can read options from the commandline, or from a config file. The syntax
-is the same in each case. See
-.B CONFIG FILE SYNTAX
-for details about using themes defined in a config file.
-These methods may be used in conjunction.
-.SH OPTIONS
-.TP 5
-.B -h, --help
-display help output and exit
-.TP 5
-.B -v, --version
-output version information and exit
-.TP 5
-.B -V, --verbose
-output useful information, progress bars, etc
-.TP 5
-.B -q, --quiet
-Don't report non-fatal errors for failed loads. Verbose and quiet modes
-are not mutually exclusive, the first controls informational messages,
-the second only errors.
-.TP 5
-.B -T, --theme THEME
-Load options from config file with name THEME - see CONFIG FILE SYNTAX for more info.
-Note that options from the theme file always override commandline options.
-.TP 5
-.B -_, --rcfile FILE
-Use FILE to parse themes and options from,
-instead of the default ~/.fehrc, /etc/fehrc files.
-.TP 5
-.B -r, --recursive
-Recursively expand any directories in FILE to the content of those
-directories, all the way down to the bottom level. (Take it easy)
-.TP 5
-.B --no-jump-on-resort
-Don't jump to the first image after resorting the filelist.
-.TP 5
-.B -z, --randomize
-When viewing multiple files in a slideshow, randomise the file list before
-displaying.
-.TP 5
-.B -f, --filelist FILE
-This option is similar to the playlists used by music software. If FILE
-exists, it will be read for a list of files to load, in the order they
-appear. The format is a list of image filenames, absolute or relative to the
-current directory, one filename per line.
-.br
-If FILE doesn't exist, it will be created from the internal filelist at the
-end of a viewing session. This is best used to store the results of complex
-sorts (\-Spixels for example) for later viewing. Any changes to the internal
-filelist (such as deleting a file or it being pruned for being unloadable)
-will be saved to FILE when feh exits. You can add files to filelists by
-specifying them on the commandline when also specifying the list.
-.TP 5
-.B -|, --start-at POSITION
-Start at POSITION in the filelist
-.TP 5
-.B -p, --preload
-Preload images. This doesn't mean hold them in RAM, it means run through
-them and eliminate unloadable images first. Otherwise they will be removed
-as you flick through. This also analyses the images to get data for use in
-sorting, such as pixel size, type etc. A preload run will be automatically
-performed if you specify one of these sort modes.
-.TP 5
-.B -F, --full-screen
-Make the window fullscreen
-.TP 5
-.B -g, --geometry STRING
-Limit (and don't change) the window size. Takes
-an X-style geometry string like 640x480.
-Note that larger images will be zoomed out to fit
-but you can see them at 1:1 by clicking the zoom
-button.
-.TP 5
-.B -., --scale-down
-When not in fullscreen: Scale images to screen size if they are too big
-.TP 5
-.B -Z, --auto-zoom
-Zoom picture to screen size in fullscreen (affected by --stretch and
---ignore-aspect).
-.TP 5
-.B --zoom PERCENT
-Zooms images by a PERCENT, when in full screen mode or when window geometry
-is fixed. If combined with \-\-auto-zoom, zooming will be limited to the the
-size.
-.TP 5
-.B -w, --multiwindow
-Disable slideshow mode. With this setting, instead of opening multiple
-files in slideshow mode, multiple windows will be opened, one per file.
-.TP 5
-.B -x, --borderless
-Create borderless windows
-.TP 5
-.B -d, --draw-filename
-Draw the filename at the top\-left of the image
-.TP 5
-.B -D, --slideshow-delay NUM
-For slideshow mode, specifies time delay (seconds, can be a decimal) between automatically
-changing slides. Great for presentations.
-.TP 5
-.B --cycle-once
-Exit feh after one loop through the slideshow
-.TP 5
-.B -R, --reload NUM
-Use this option to tell
-.B feh
-to reload an image after NUM seconds. Useful for viewing webcams via http,
-or even on your local machine.
-.TP 5
-.B -k, --keep-http
-When viewing files using HTTP, feh normally deletes the local copies after
-viewing, or, if caching, on exit. This option prevents this so that you
-get to keep the local copies. They will be in /tmp with "feh" in the name.
-.TP 5
-.B -j, --output-dir DIR
-Save files to DIR (only useful with \-k)
-.TP 5
-.B -Q, --builtin
-Use builtin http client to grab remote files instead of wget, useful if you
-don't have wget installed.
-.TP 5
-.B -G, --wget-timestamp
-Don't add a timestamp ("?1234") to URLs when (re)loading them
-.TP 5
-.B --caption-path PATH
-Path to directory containing image captions. This turns on caption viewing, and
-if captions are found in PATH, which is relative to the directory of each
-image, they are overlayed on the displayed image. e.g with caption path
-"captions", and viewing image images/foo.jpg, caption will be looked for as
-"images/captions/foo.jpg.txt"
-.TP 5
-.B -l, --list
-Don't display images. Analyse them and display an 'ls'\-style listing.
-Useful in scripts hunt out images of a certain size/resolution/type etc.
-.TP 5
-.B -L, --customlist FORMAT
-Use FORMAT as the format specifier for list
-output. FORMAT is a printf-like string containing
-image info specifiers. See FORMAT SPECIFIERS.
-.TP 5
-.B -U, --loadable
-Don't display images. Just print out their names if imlib2 can successfully
-load them.
-.TP 5
-.B -u, --unloadable
-Don't display images. Just print out their name if imlib2 can NOT
-successfully load them.
-.TP 5
-.B -S, --sort SORT_TYPE
-The file list may be sorted according to image parameters. Allowed sort
-types are: name, filename, width, height, pixels, size, format. For sort
-modes other than name or filename, a preload run will be necessary,
-causing a delay proportional to the number of images in the list
-.TP 5
-.B -n, --reverse
-Reverse the sort order. Use this to invert the order of the filelist. Eg
-to sort in reverse width order, use
-.B -nSwidth
-.TP 5
-.B -A, --action ACTION
-Specify a string as an action to perform on the image. In slideshow or
-multiwindow modes, the action will be run when the enter key is pressed, in
-list mode, the action will be run for each file listed. The action will be
-executed by /bin/sh. Use format specifiers to refer to image info. See
-FORMAT SPECIFIERS for examples
-.br
-Eg. feh \-A "mv %f ~/images/%n" *
-.br
-In slideshow mode, the next image will be shown after running the action,
-in multiwindow mode, the window will be closed.
-.TP 5
-.B --action1...9
-Extra actions which can be set and triggered using the appropriate number
-key.
-.TP 5
-.B --draw-actions
-Draw the defined actions and what they do at the top\-left of the image.
-.TP 5
-.B -m, --montage
-Enable montage mode. Montage mode creates a new image consisting of a grid
-of thumbnails of the images in the filelist. When montage mode is selected,
-certain other options become available. See MONTAGE MODE OPTIONS
-.TP 5
-.B -c, --collage
-Enable collage mode. Collage mode is very similar to montage mode, except
-the images are distributed randomly.
-When using collage mode, you should also specify --limit-width and
---limit-height.
-.TP 5
-.B -i, --index
-Enable Index mode. Index mode is similar to montage mode, and accepts the
-same options. It creates an index print of thumbails, printing the image
-name beneath each thumbnail. Index mode enables certain other options, see
-INDEX MODE OPTIONS
-.TP 5
-.B -I, --fullindex
-Same as Index mode, but you also get image size and dimensions printed
-below each thumbnail.
-.TP 5
-.B -t, --thumbnails
-Same as Index mode, but the thumbnails are clickable image launchers.
-.TP 5
-.B --cache-thumbnails
-Enable thumbnail caching (in ~/.thumbnails)
-.TP 5
-.B -~, --thumb-title STRING
-Set title for windows opened from thumbnail mode. See also FORMAT SPECIFIERS.
-.TP 5
-.B --index-name BOOL
-Show/Don't show filename in thumbnail/index mode.
-.TP 5
-.B --index-size BOOL
-Show/Don't show filesize in thumbnail/index mode.
-.TP 5
-.B --index-dim BOOL
-Show/Don't show image dimensions in thumbnail/index mode.
-.TP 5
-.B --bg-tile FILE
-.TP 5
-.B --bg-center FILE
-.TP 5
-.B --bg-scale FILE
-.TP 5
-.B --bg-fill FILE
-.TP 5
-.B --bg-seamless FILE
-Set your desktop background to FILE. Feh
-can use enlightenment IPC if you are running
-it, or will fall back to X methods.
-Feh stores the commandline necessary to restore
-the background you chose in ~/.fehbg. So to have
-feh-set backgrounds restored when you restart X,
-add the line "`cat $HOME/.fehbg`" to your
-X startup script (e.g. ~/.xsession). Note that
-you only need to do this for non E window
-managers.
-.TP 5
-.B -M, --menu-font FONT
-Use FONT for the font in menus.
-.TP 5
-.B -C, --fontpath PATH
-Specify PATH as an extra directory in which to search for fonts, can use
-multiple times to add multiple paths, e.g \-\-fontpath /path/a \-\-fontpath
-/path/b.
-.TP 5
-.B --menu-style FILE
-Use FILE as the style descriptor for menu text.
-.TP 5
-.B -), --menu-bg BG
-Use BG for the background image in menus.
-.TP 5
-.B --menu-border INT
-Specify number of pixels that define the menu
-background's border. Borders are not stretched
-when images are scaled.
-.TP 5
-.B -N, --no-menus
-Don't load or show any menus.
-.TP 5
-.B -B, --image-bg STYLE
-Use STYLE as background for transparent image parts and the like.
-Accepted values: white, black, default.
-.TP 5
-.B -^, --title TITLE
-Use TITLE as window title in slideshow mode.
-.TP 5
-.B -0, --reload-button B
-Use button B to reload the current image (default: 0)
-.TP 5
-.B -1, --pan-button B
-Use button B to pan the image (hold button down and move mouse to move the image).
-When the mouse is not moved, advances to the next image in slideshow mode
-(defaults to 1, usually the left button).
-.TP 5
-.B -2, --zoom-button B
-Use button B to zoom the current image in any
-mode (defaults to 2, usually the middle button).
-.TP 5
-.B -3, --menu-button B
-Use button B to activate the menu in any mode.
-This option is disabled if the \-N or \-\-no\-menus option is set
-(defaults to 3, usually the right button).
-.TP 5
-.B --menu-ctrl-mask
-Require CTRL+Button for menu activation in any mode (default=off).
-.TP 5
-.B -4, --prev-button B
-Use button B to switch to the previous image in slideshow mode
-(defaults to 4, usually <mousewheel up>).
-.TP 5
-.B -5, --next-button B
-Use button B to switch to the next image in slideshow mode
-(defaults to 5, usually <mousewheel down>).
-.TP 5
-.B -8, --rotate-button B
-Use CTRL+Button B to rotate the current image in any mode (default=2).
-.TP 5
-.B --no-rotate-ctrl-mask
-Don't require CTRL+Button for rotation in any mode -- just use the button (default=off).
-.TP 5
-.B -9, --blur-button B
-Use CTRL+Button B to blur the current image in any mode (default=1).
-.TP 5
-.B --no-blur-ctrl-mask
-Don't require CTRL+Button for blurring in any mode -- just use the button (default=off).
-.TP 5
-.B --no-xinerama
-Disable Xinerama support. Only makes sense when you have Xinerama support compiled in.
-.TP 5
-.B --screen-clip
-Enable/disable window clipping based on screen size. WARNING: With this disabled, windows could become very large, making them unmanageable in certain window managers.
-.TP 5
-.B --hide-pointer
-Hide the mouse pointer in full screen mode (useful for slideshows etc).
-.SH FORMAT SPECIFIERS
-.B %f
-image path/filename
-.br
-.B %n
-image name
-.br
-.B %s
-image size (bytes)
-.br
-.B %p
-image pixel size
-.br
-.B %w
-image width
-.br
-.B %h
-image height
-.br
-.B %t
-image format
-.br
-.B %P
-prints feh
-.br
-.B %v
-prints the version
-.br
-.B %m
-prints the mode (slideshow, multiwindow...)
-.br
-.B %l
-prints the total number of files in the filelist
-.br
-.B %u
-prints the current file number
-.br
-.nf
-\\n newline
-.fi
-.br
-Eg. feh \-A "mv %f ~/images/%n" *
-.SH MONTAGE MODE OPTIONS
-.TP 5
-.B -X, --ignore-aspect
-By default, the montage thumbnails will retain their aspect ratios, while
-fitting in \-\-thumb\-width and \-\-thumb\-height. This option will force them to
-be the size set by \-\-thumb-width and \-\-thumb-height This will prevent any
-whitespace in the final montage
-.TP 5
-.B -s, --stretch
-Normally, if an image is smaller than the specified thumbnail size, it will
-not be enlarged. If this option is set, the image will be scaled up to fit
-the thumnail size. (Aspect ratio will be maintained unless \-\-ignore\-aspect is
-specified)
-.TP 5
-.B -y, --thumb-width NUM
-Set thumbnail width in pixels
-.TP 5
-.B -E, --thumb-height NUM
-Set thumbnail height in pixels
-Thumbnails default to 20x20 pixels
-.TP 5
-.B -W, --limit-width NUM
-Limit the width of the montage in pixels
-.TP 5
-.B -H, --limit-height NUM
-Limit the height of the montage in pixels These options can be used together
-(to define the image size exactly), or separately. If only one is specified,
-theother is calculated from the number of files specified and the size of
-the thumbnails. The default is to limit width to 800 pixels and calculate
-the height as necessary
-.TP 5
-.B -b, --bg FILE|trans
-Use FILE as a background for your montage. With this option specified, the
-size of the montage will default to the size of FILE if no size restrictions
-are specified. Alternatively, if FILE is 'trans', the background will be
-made transparent.
-.TP 5
-.B -a, --alpha NUM
-When drawing thumbnails onto the background, apply them with a transparency
-level of NUM (0-255).
-.TP 5
-.B -o, --output FILE
-Save the created montage to FILE
-.TP 5
-.B -O, --output-only FILE
-Just save the created montage to FILE without displaying it (use in scripts)
-.SH INDEX MODE OPTIONS
-.TP 5
-.B -e, --font FONT
-Use FONT to print the information under each thumbnail. FONT should be a
-truetype font, resident in the current directory, or in feh's font
-directory, and should be defined in the form fontname/size(points). (No
-extension). eg. \-\-font myfont/12
-.TP 5
-.B -@, --title-font FONT
-Use FONT to print a title on the index, if no font is specified, a title
-will not be printed
-.SH CONFIG FILE SYNTAX
-The feh config file allows the naming of option groups, or themes.
-If
-.B $HOME/.fehrc
-exists, or if not, but
-.B /etc/fehrc
-exists, feh will look in it for theme name/options pairs. If neither
-$HOME/.fehrc or /etc/fehrc exist, feh will create a default one in ~/.fehrc.
-An example entry would be:
-.br
-.B imagemap -rVq --thumb-width 40 --thumb-height 30
-.br
-You can then use this theme in two ways. Either
-.br
-.B feh --theme imagemap *.jpg
-.br
-or you can create a symbolic link to feh with the name of the options you
-want it to use. So from the example above:
-.br
-.B ln -s `which feh` ~/bin/imagemap
-.br
-Now I just run
-.B imagemap *.jpg
-to use those options. A cooler example is
-.br
-.B mkindex -iVO index.jpg --title-font 20thcent/24 .
-.br
-Notice the '.' at the end. Now with a symlink I can create a mkindex
-command which will create an index.jpg in the current directory. I just
-run
-.B mkindex
-to do it.
-.br
-You can combine these themes with commandline options, they will be
-combined. So in the example above, typing
-.B mkindex -q
-will create and index, suppressing error messages.
-An example.fehrc is provided with a couple of cool examples.
-.SH SLIDESHOW KEYS
-The default mode for viewing mulitple images is Slideshow mode
-When viewing a slideshow, the following keys may be used:
-.TP 5
-.B p, P, <BACKSPACE>, <LEFT>
-Goto previous slide
-.TP 5
-.B n, N, <SPACE>, <RIGHT>
-Goto next slide
-.TP 5
-.B r, R
-Reload current image. Useful for webcams.
-.TP 5
-.B v, V
-Toggle fullscreen.
-.TP 5
-.B m, M
-Show popup menu.
-.TP 5
-.B c, C
-Caption entry mode. If \-\-caption\-path has been specified, then this enables
-caption editing. The caption will turn yellow and be editable, hit enter to
-confirm and save the caption, or hit escape to cancel and revert the caption.
-.TP 5
-.B w, W
-Size window to current image size.
-.TP 5
-.B h, H
-Pause the slideshow (only useful when using
-timed reloading or image changes)
-.TP 5
-.B a, A
-Toggle actions display (see --draw-actions)
-.TP 5
-.B d, D
-Toggle filename display (see --draw-filename)
-.TP 5
-.B s, S
-Save the current image to a unique filename.
-.TP 5
-.B f, F
-Save the current filelist to a unique filename.
-.TP 5
-.B <, >
-In place editing, rotate the image 90 degrees left/right.
-The rotation is lossless, but may create artifacts in some image corners
-when used with JPEG images.
-Rotating in the reverse direction will make them go away.
-See jpegtran(1) for more about lossless JPEG rotation.
-.TP 5
-.B <HOME>
-Goto first slide
-.TP 5
-.B <END>
-Goto last slide
-.TP 5
-.B <PAGE UP>
-Go forward around 5% of the way through the slideshow
-.TP 5
-.B <PAGE DOWN>
-Go backward around 5% of the way through the slideshow
-.TP 5
-.B <ESCAPE>
-Quit the slideshow
-.TP 5
-.B +, =
-Increase reload delay
-.TP 5
-.B -, _
-Decrease reload delay
-.TP 5
-.B <DELETE>
-Remove the currently viewed file from the filelist
-.TP 5
-.B <CTRL+DELETE>
-Delete the currently viewed file and remove it from the filelist
-.TP 5
-.B x, X
-Close current window
-.TP 5
-.B q, Q
-Quit feh
-.TP 5
-.B <KEYPAD LEFT>
-Move the image to the left
-.TP 5
-.B <KEYPAD RIGHT>
-Move the image to the right
-.TP 5
-.B <KEYPAD UP>
-Move the image up
-.TP 5
-.B <KEYPAD DOWN>
-Move the image down
-.TP 5
-.B <KEYPAD BEGIN>
-Antialias the image.
-When controlling feh with the mouse, this is done by default as soon as the
-respective mouse button is released; in keypad mode, you need to press this
-button.
-.TP 5
-.B <KEYPAD +>
-Zoom in
-.TP 5
-.B <KEYPAD ->
-Zoom out
-.TP 5
-.B <KEYPAD *>
-Zoom to 100%
-.TP 5
-.B <KEYPAD />
-Zoom to fit the window
-.SH MOUSE ACTIONS
-When viewing an image, mouse button 1 moves to the next image (slideshow
-mode only), button 2 zooms (click and drag left->right to zoom in,
-right->left to zoom out, click once to restore 1x zoom), and mouse button 3
-pans. Ctrl+button 1 blurs or sharpens the image (drag left to blur and right
-to sharpen). Ctrl+button 2 rotates the image around the center point.
-Ctrl+button 3 activates the context-sensitive menu. Buttons can be redefined
-with the \-1 through \-9 (or \-\-*\-button) cmdline flags. All you people
-with million button mice can remove the ctrl mask with the \-\-no-*\-ctrl-mask
-options.
-.SH SUGGESTED USAGE EXAMPLES
-Here are some examples of nice option combinations to achieve cool results:
-.TP 5
-.B feh -r /opt/images
-Recursively scan /opt/images and show all the images in a slideshow.
-.TP 5
-.B feh -rSname /opt/image
-Same again, but sort by name before showing.
-.TP 5
-.B feh -m /opt/images/landscapes
-Create a montage from the images in /opt/images/landscapes
-.TP 5
-.B feh -Xrm -W 400 --thumb-width 30 --thumb-height 20 ./landscapes
-Create a montage from the images in /opt/images/landscapes and all
-directories below it. Limit the width of the image to 400 and make the
-thumbnails 30x20, ignoring aspect ratio.
-.TP 5
-.B feh -irFarial/14 -O index.jpg /opt/images
-Make an index print of /opt/images and all directories below it, using 14
-point arial to write the image info under each thumbnail. Save the image as
-index.jpg and don't display it, just exit.
-.TP 5
-.B feh -LrSpixels /opt/images
-List the images in /opt/images and all directories within, sorted by pixel
-size, giving as much info as possible.
-.TP 5
-.B feh -kR30 http://url.of.a.webcam.jpg
-Use feh to view a webcam, reloading every 30 seconds, and saving the images
-in /tmp.
-.TP 5
-.B feh --unloadable -r /opt/images
-Weed out (list) all the unloadable images in /opt/images and below.
-.TP 5
-.B feh -w /opt/images/holidays
-Open each image in /opt/images/holidays in it's own window
-.TP 5
-.B feh -FD5 -Sname /opt/images/presentation
-Show the images in /opt/images/presentation, sorted by name, in fullscreen
-view, automatically changing slides every 5 seconds.
-.TP 5
-.B feh -rSwidth -A 'mv %f ~/images/%n\' /opt/images
-View all the images in /opt/images and below, sorted by width (smallest
-first) and move the image to ~/images/image_name when enter is pressed.
-.SH BUGS
-When the files (or even the directory) feh is displaying is deleted by an
-external application while feh is running, trying to change or resize the
-current image may cause segmentation faults.
-.PP
-There are probably other bugs, too. If you find one, let me know :)
-.SH LICENSE
-Copyright Tom Gilbert (and various contributors), 1999, 2000
-.PP
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to
-deal in the Software without restriction, including without limitation the
-rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
-sell copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-.PP
-The above copyright notice and this permission notice shall be included in
-all copies of the Software and its documentation and acknowledgment shall be
-given in the documentation and software packages that this Software was
-used.
-.PP
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
-THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
-IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
-CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-.PP
-Email bugs and feature requests to
-.br
-.B <derf@chaosdorf.de>
-.PP
-Original author (no longer developing):
-.br
-.B <feh_sucks@linuxbrit.co.uk>