ftp://ftp.demon.nl/disk1/redhat-contrib/libc5/SRPMS/xscreensaver-2.14-1.src.rpm
[xscreensaver] / README
diff --git a/README b/README
index 22e0c4f8f10bb6ddbac8380804c603eaa596a725..2133a5e31b4b31ddeef471ef145905e28e862d8b 100644 (file)
--- a/README
+++ b/README
@@ -22,6 +22,10 @@ The most important hint is probably this:
 
 To build on VMS, see README.VMS.
 
+If you think you've found a bug, please let me know; but first, read
+the enlosed `README.debugging' file to find out what kind of information
+would be most helpful to include in your bug report.
+
                               ============
 
 The xscreensaver program waits until the keyboard and mouse have been idle
@@ -69,6 +73,7 @@ window, which are pointed at by the screensaver's default resource settings.
    hypercube   - 2d projection of a hypercube rotating on all four axes.
    slidescreen - Divides the screen into a grid and plays a 16-puzzle on it.
    decayscreen - A melting effect.
+   puzzle      - Turns the screen into a jigsaw puzzle and shuffles it.
    halo                - Random circular patterns.
    pyro                - Fireworks.  Looks a lot like the version in xlock.
    hopalong    - Fractals.  I snarfed this code from xlock.
@@ -86,7 +91,7 @@ window, which are pointed at by the screensaver's default resource settings.
    bouboule    - Spinning bubbles on a transparent ball.
    braid       - Draws random color-cycling braids around a circle.
    drift       - Drifting recursive fractal cosmic flames.
-   fract       - Small, curvy geometric patterns.
+   vines       - Small, curvy geometric patterns.
    galaxy      - Spinning, colliding galaxies.
    grav                - Orbital simulation and/or cloud chamber.
    ifs         - Spinning, colliding iterated-function-system shapes.
@@ -99,15 +104,23 @@ window, which are pointed at by the screensaver's default resource settings.
    spiral      - Circular color-cycling interference patterns.
    strange     - Animating strange attractors.
    flag                - A waving flag of an arbitrary bitmap or text.
-   sphere      - draw a bunch of shaded spheres.
+   sphere      - Draws a bunch of shaded spheres.
    forest      - grows a fractal forest.
    lisa                - draws animated full-loop lisajous figures.
+   lissie      - another lisajous path.
    goop                - Squishy transparent oil-and-bubble images
    starfish    - Radially-symmetric throbbing colormap-hacking blobs.
    munch       - The classic 1962-vintage "munching squares" hack.
    rd-bomb      - Reaction-diffusion fractals.
    coral        - Simulation of coral growth, sort of.
    fadeplot    - Draws a swimming ribbon.
+   mountain    - Generates mountains on a square grid.
+   triangle    - Generates mountains on a triangular grid.
+   worm                - Draws wiggly worms.
+   rotor       - Draws a rotating spiral pattern.
+   ant         - A cellular automaton.
+   xjack       - Simulates a schizophrenic typist.
+   xlyap       - Calculates and displays Lyapunov exponents.
    escher      - Draws some escher-like scenes (GLX only.)
    gears       - Draws interlocking rotating gears (GLX only.)
    morph3d     - Draws shiny shape-changing 3d forms (GLX only.)
@@ -129,10 +142,15 @@ Other reasonable things to use as screensavers, if you have them, are
   xv -root file.gif -quit      - they don't all have to animate!
   xsplinefun                   - bouncing splines
   xfishtank -c black -d -r 1   - fish (use version 2.0 or later)
+  xmountains -b                        - very realistic generated mountains
   xtacy -root                  - various eye candy
-  /usr/demos/bin/bongo -wbongo - an SGI GL demo
+  xearth -wait 0 -timewarp 400 - the earth as seen from space
+  /usr/demos/bin/bongo         - an SGI GL demo
+  /usr/demos/bin/ep -S         - another: the stunning ElectroPaint.
+                                 (Compile hacks/xscreensaver-sgigl.c
+                                 to use these with xscreensaver.)
 
-You can get all of these from the contrib directory on ftp.x.org.  If you
+You can get most of these from the contrib directory on ftp.x.org.  If you
 know of (or write) any other interesting programs that can be used as
 screensavers, please let me know!
 
@@ -142,10 +160,57 @@ http://people.netscape.com/jwz/xscreensaver/.
        -- Jamie Zawinski <jwz@netscape.com>
 
 \f
-Changes since 2.09:    Fixed color bugs in rd-bomb; sped up coral.
-Changes since 2.07:    New hacks "rd-bomb" and "coral".
-                       New version of "maze" with some new algorithms.
-                       New colorized version of "rocks".
+Changes since 2.13:    Better fix for the Motif drag-and-die lossage.
+                       Put in some kludges to work around a LessTif bug.
+                       XScreenSaver is known to work with LessTif 0.82 now.
+                       Made fading work on high-end SGI video hardware.
+                       Fixed another SGI-specific bug in screen grabbing;
+                       will the madness never cease?
+                       Fixed another crash in `xlyap'.
+Changes since 2.12:    Made `decayscreen' do directions other than down.
+                       Improved `puzzle'.
+                       Fixed a crash in `xlyap'.
+                       Added CDE info to the man page, removed `cde.txt'.
+                       Configure tweaks for Zippy.
+                       Turned off the signal handling in `bubbles' because
+                       it was sometimes failing to die.
+                       Added `hacks/xscreensaver-sgigl.c' to make it possible
+                       to run SGI's ElectroPaint hack (/usr/demos/bin/ep)
+                       with xscreensaver.  Finally!
+                       Fixed a buffer overrun in the locking code that some
+                       wily, malicious cracker must have slipped in.
+                       Disabled Motif drag-and-drool in the dialog box
+                       buttons, since it's broken in some old versions of
+                       Motif.
+Changes since 2.11:    Added `README.debugging'.
+                       Added `puzzle' hack.
+                       Added `xlyap' hack.
+                       Added "default-n" as a visual name, so that one can
+                       have -install on by default, but turn it off for
+                       certain poorly-behaved hacks (like xv.)
+                       Added support for grabbing frames of external video
+                       (on SGI) to the screen-grabbing hacks (decayscreen,
+                       slidescreen, slip, blitspin, and puzzle.)
+                       Improved look of tiles in `slidescreen'; fixed its
+                       color allocation problem.
+Changes since 2.10:    Tweaked `blitspin', added it to the default list.
+                       Added `lissie', `mountain', `triangle', `worm',
+                       `rotor', and `ant' from xlockmore.
+                       Updated `sierpinski', `galaxy', and `lisa'.
+                       Thickened the lines in `braid' and `lmorph'.
+                       Updated VMS makefiles.
+                       Renamed `fract' to `vines'.
+                       Added `xjack' hack.
+                       Made a few more hacks use erase.c, and added a few
+                       more wipe styles.
+                       Fixed compilation problem with Sun's version of OpenGL.
+                       Added ability to use sigaction() instead of signal()
+                       to work around a SCO kernel bug.
+Changes since 2.09:    Fixed colormap bugs in `rd-bomb'; sped up `coral'.
+                       Configure tweaks for *BSD.
+Changes since 2.07:    New hacks `rd-bomb' and `coral'.
+                       New version of `maze' with some new algorithms.
+                       New colorized version of `rocks'.
                        Fixed a bug in qix on 64-bit machines.
                        Fixed a bug in the -time option.
                        Fixed a bug in configure related to LessTif.