X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?p=xscreensaver;a=blobdiff_plain;f=hacks%2Fboxfit.man;h=ffd74419357d2ee9a4009aacd8aebfa687399904;hp=49b4f57394fd7f0fc5d6739bdf275fe72866ea50;hb=447db08c956099b3b183886729108bf5b364c4b8;hpb=2d04c4f22466851aedb6ed0f2919d148f726b889

diff --git a/hacks/boxfit.man b/hacks/boxfit.man
index 49b4f573..ffd74419 100644
--- a/hacks/boxfit.man
+++ b/hacks/boxfit.man
@@ -13,6 +13,8 @@ boxfit - fills space with a gradient of growing boxes or circles.
 [\-spacing \fIint\fP]
 [\-border \fIint\fP]
 [\-circles | \-squares | \-random]
+[\-grab]
+[\-peek]
 .SH DESCRIPTION
 Packs the screen with growing boxes or circles, colored according to a
 horizontal or vertical gradient.  The objects grow until they touch,
@@ -49,6 +51,27 @@ Thickness of the colored border around each object.  Default 1.
 .TP 8
 .B \-circles\fB | \-squares\fP | \-random\fP
 Draw circles, squares, or choose randomly (the default).
+.TP 8
+.B \-grab
+Normally it colors the boxes with a horizontal or vertical gradient.
+If \fI\-grab\fP is specified, it will instead load a random image,
+and color the boxes according to the colors in that image.
+As the picture fills in, some features of the underlying image
+may become recognisable.
+
+When grabbing images, the image will be grabbed from the portion of
+the screen underlying the window, or from the system's video input,
+or from a random file on disk, as indicated by
+the \fIgrabDesktopImages\fP, \fIgrabVideoFrames\fP,
+and \fIchooseRandomImages\fP options in the \fI~/.xscreensaver\fP
+file; see
+.BR xscreensaver-demo (1)
+for more details.
+.TP 8
+.B \-peek
+This option says to briefly show you the underlying image before
+beginning.  The default is not to show the unadulterated image at all.
+(This only has an effect when \fI\-grab\fP is used.)
 .SH ENVIRONMENT
 .PP
 .TP 8
@@ -61,6 +84,8 @@ stored in the RESOURCE_MANAGER property.
 .SH SEE ALSO
 .BR X (1),
 .BR xscreensaver (1)
+.BR xscreensaver\-demo (1),
+.BR xscreensaver\-getimage (1)
 .SH COPYRIGHT
 Copyright \(co 2005 by Jamie Zawinski.  Permission to use, copy, modify, 
 distribute, and sell this software and its documentation for any purpose is