1 files changed, 66 insertions, 0 deletions
diff --git a/driver/xscreensaver-getimage-file.man b/driver/xscreensaver-getimage-file.man
new file mode 100644
index 0000000..778ad85
--- /dev/null
+++ b/driver/xscreensaver-getimage-file.man
@@ -0,0 +1,66 @@
+.TH XScreenSaver 1 "20-Mar-2005 (4.21)" "X Version 11"
+.SH NAME
+xscreensaver-getimage-file - put a randomly-selected image on the root window
+.SH SYNOPSIS
+.B xscreensaver-getimage-file
+[\-display \fIhost:display.screen\fP]
+[\--verbose]
+[\--name]
+[\--no-cache]
+directory-or-URL
+.SH DESCRIPTION
+The \fIxscreensaver\-getimage\-file\fP program is a helper program
+for the xscreensaver hacks that manipulate images.  Specifically, it
+is invoked by
+.BR xscreensaver\-getimage (1)
+as needed.  This is not a user-level command.
+
+This program selects a random image from disk, and loads it on the root
+window.  It does this by figuring out which image-loading programs are
+installed on the system, and invoking the first one it finds.
+.SH OPTIONS
+.I xscreensaver-getimage-file
+accepts the following options:
+.TP 4
+.B --verbose
+Print diagnostics.
+.TP 4
+.B --name
+Don't load an image: instead just print the file name to stdout.
+.TP 4
+.I directory-or-URL
+If a directory is specified, it will be searched recursively for
+images.  Any images found will eligible for display.  For efficiency,
+the contents of the directory are cached for a few hours before it
+is re-scanned.
+
+If a URL is specified, it should be the URL of an RSS or Atom feed
+containing images.  The first time it is accessed, all of the images
+in the feed will be downloaded to a local cache directory.  If a few
+hours have elapsed since last time, the URL will be polled again, and
+any new images will be cached, any images no longer in the feed
+will be expired.
+.TP 4
+.B --no-cache
+Update the cache immediately, even if it is not time yet.  This
+will re-scan the directory, or re-poll the RSS feed.
+.SH SEE ALSO
+.BR X (1),
+.BR xscreensaver (1),
+.BR xscreensaver\-demo (1),
+.BR xscreensaver\-getimage (1),
+.BR xv (1),
+.BR xli (1),
+.BR xloadimage (1),
+.BR chbg (1)
+.SH COPYRIGHT
+Copyright \(co 2001-2012 by Jamie Zawinski.  Permission to use, copy,
+modify, distribute, and sell this software and its documentation for
+any purpose is hereby granted without fee, provided that the above
+copyright notice appear in all copies and that both that copyright
+notice and this permission notice appear in supporting documentation.
+No representations are made about the suitability of this software for
+any purpose.  It is provided "as is" without express or implied
+warranty.
+.SH AUTHOR
+Jamie Zawinski <jwz@jwz.org>, 14-Apr-01