1 files changed, 102 insertions, 0 deletions
diff --git a/hacks/boxfit.man b/hacks/boxfit.man
new file mode 100644
index 0000000..ec157e3
--- /dev/null
+++ b/hacks/boxfit.man
@@ -0,0 +1,102 @@
+.TH XScreenSaver 1 "" "X Version 11"
+.SH NAME
+boxfit - fills space with a gradient of growing boxes or circles.
+.SH SYNOPSIS
+.B boxfit
+[\-display \fIhost:display.screen\fP]
+[\-visual \fIvisual\fP]
+[\-window]
+[\-root]
+[\-delay \fIusecs\fP]
+[\-count \fIint\fP]
+[\-growby \fIint\fP]
+[\-spacing \fIint\fP]
+[\-border \fIint\fP]
+[\-circles | \-squares | \-random]
+[\-grab]
+[\-peek]
+[\-fps]
+.SH DESCRIPTION
+Packs the screen with growing boxes or circles, colored according to a
+horizontal or vertical gradient.  The objects grow until they touch,
+then stop.  When the screen is full, they shrink away and the process
+restarts.
+.SH OPTIONS
+.TP 8
+.B \-visual \fIvisual\fP
+Specify which visual to use.  Legal values are the name of a visual class,
+or the id number (decimal or hex) of a specific visual.
+.TP 8
+.B \-window
+Draw on a newly-created window.  This is the default.
+.TP 8
+.B \-root
+Draw on the root window.
+.TP 8
+.B \-delay \fImicroseconds\fP
+How much of a delay should be introduced between steps of the animation.
+Default 20000, or about 0.02 seconds.
+.TP 8
+.B \-count \fIint\fP
+How many boxes or circles to animate simultaneously; default 50.
+Smaller numbers yield larger boxes/circles.
+.TP 8
+.B \-growby \fIint\fP
+How many pixels the objects should grow by, each frame.  Default 1.
+.TP 8
+.B \-spacing \fIint\fP
+How many pixels of space should be left between the objects.  Default 1.
+.TP 8
+.B \-border \fIint\fP
+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.)
+.TP 8
+.B \-fps
+Display the current frame rate and CPU load.
+.SH ENVIRONMENT
+.PP
+.TP 8
+.B DISPLAY
+to get the default host and display number.
+.TP 8
+.B XENVIRONMENT
+to get the name of a resource file that overrides the global resources
+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 
+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>