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] directory
+[\-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
.B --name
Don't load an image: instead just print the file name to stdout.
.TP 4
-.I directory
-The directory to search. The directory will be searched recursively,
-and all files in it are assumed to be images.
+.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 xloadimage (1),
.BR chbg (1)
.SH COPYRIGHT
-Copyright \(co 2001 by Jamie Zawinski. Permission to use, copy,
+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
projects / xscreensaver / blobdiff