[\-root]
[\-count \fInumber\fP]
[\-cycles \fInumber\fP]
-[\-delay \fInumber\fP]
+[\-periodic|\-no\-periodic]
+[\-search|\-no\-search]
+[\-rotate|\-no\-rotate]
+[\-ride|\-no\-ride]
+[\-box|\-no\-box]
+[\-dbuf|\-no\-dbuf]
[\-ncolors \fInumber\fP]
-[\-rotate \fIbool\fP]
-[\-ride \fIbool\fP]
-[\-zoom \fIbool\fP]
-[\-box \fIbool\fP]
-[\-freeze \fIbool\fP]
-[\-allow2d \fIbool\fP]
-[\-slow \fIbool\fP]
+[\-delay \fInumber\fP]
+[\-fps]
.SH DESCRIPTION
-Another series of strange attractors: a flowing series of points, making
-strange rotational shapes.
+Strange attractors formed of flows in a 3D differential equation phase
+space. Features the popular attractors described by \fBLorentz\fP,
+\fBRoessler\fP, \fBBirkhoff\fP and \fBDuffing\fP, and can discover
+entirely new attractors by itself.
.SH OPTIONS
.TP 8
.B \-visual \fIvisual\fP
Draw on the root window.
.TP 8
.B \-count \fInumber\fP
-Number of pixels. Default: 500.
+Number of particles in the flow. Default: 3000
+.TP 8
+.B \-size \fInumber\fP
+Length of particle trails. Negative values indicate
+randomness. The computational load of a given flow depends on
+(particle count) * (trail length). Default: -10
.TP 8
.B \-cycles \fInumber\fP
-Timeout before changing objects. 0 - 800000. Default: 3000.
+Timeout before changing objects. 0 - 800000. Default: 10000.
.TP 8
-.B \-delay \fInumber\fP
-Per-frame delay, in microseconds. Default: 1000 (0.001 seconds.).
+.B \-periodic
.TP 8
-.B \-ncolors \fInumber\fP
-Number of Colors. Default: 200.
+.B \-no\-periodic
+turn on/off periodic attractors. These are flows in 2 dependent
+variables, with a periodic dependence on a third independent variable
+(eg time). Flow will sometimes choose to start all the particles in
+the same phase to illustrate the flow's cross-section. Default:
+on
+.TP 8
+.B \-search
+.TP 8
+.B \-no\-search
+turn on/off search for new attractors. If this is enabled, a fraction
+of the computing cycles is directed to searching a 60-dimensional
+parameter space for new strange attractors. If periodic flows are
+enabled, these can be searched too. Watch carefully - you are quite
+likely to see mathematical objects that have never been seen before,
+and since the parameters are not recorded, you'll probably never see
+them again! Default: on
.TP 8
.B \-rotate
-Rotate Around Attractor.
+.TP 8
+.B \-no\-rotate
+turn on/off rotating around attractor. Default: on
.TP 8
.B \-ride
-Ride a Trained Bee.
.TP 8
-.B \-zoom
-Zoom In and Out.
+.B \-no\-ride
+turn on/off ride in the flow. Default: on
+
+If both -rotate and -ride are enabled the viewpoint will occasionally
+fly between the two views.
.TP 8
.B \-box
-Show Bounding Box.
.TP 8
-.B \-freeze
-Freeze Some Bees.
+.B \-no\-box
+turn on/off bounding box. Default: on
+.TP 8
+.B \-dbuf
.TP 8
-.B \-allow2d
-Allow 2D Attractors.
+.B \-no\-dbuf
+turn on/off double buffering. If Flow runs slowly in full screen, but
+fast in a smaller window (eg on old graphics cards with too little
+memory), try turning this option off. Default: on
+.TP 8
+.B \-ncolors \fInumber\fP
+Number of Colors. Default: 200.
+.TP 8
+.B \-delay \fInumber\fP
+Per-frame delay, in microseconds. Default: 10000 (0.01 seconds.).
.TP 8
-.B \-slow
-Slow Bees with Antifreeze.
+.B \-fps
+Display the current frame rate and CPU load.
.SH ENVIRONMENT
.PP
.TP 8
.BR X (1),
.BR xscreensaver (1)
.SH COPYRIGHT
-Copyright \(co 2002 by Jeff Butterworth. 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.
+Copyright (c) 1996 by Tim Auckland <Tim.Auckland@Procket.com>
+Incorporating some code from Stephen Davies Copyright (c) 2000
+
+Search code based on techniques described in "Strange Attractors:
+Creating Patterns in Chaos" by Julien C. Sprott
+
+Permission to use, copy, modify, and distribute this software and its
+documentation for any purpose and without fee is hereby granted,
+provided that the above copyright notice appear in all copies and that
+both that copyright notice and this permission notice appear in
+supporting documentation.
+
+This file is provided AS IS with no warranties of any kind. The author
+shall have no liability with respect to the infringement of copyrights,
+trade secrets or any patents by this file or any part thereof. In no
+event will the author be liable for any lost revenue or profits or
+other special, indirect and consequential damages.
+
+Adapted from swarm.c Copyright (c) 1991 by Patrick J. Naughton.
+
+Adapted from xswarm by Jeff Butterworth. (butterwo@ncsc.org).
.SH AUTHOR
-Jeff Butterworth.
+Tim Auckland