http://www.ibiblio.org/pub/historic-linux/ftp-archives/sunsite.unc.edu/Sep-29-1996...
[xscreensaver] / README
diff --git a/README b/README
index 2783d608b2bd94de41a0cdc078aa66b87b3362c7..55b1ae208d46845fbca13a34719f6222fc238c38 100644 (file)
--- a/README
+++ b/README
@@ -1,7 +1,9 @@
 
-See config.h for configuration parameters.  To build, do the usual:
+To build:
 
-       xmkmf ; make ; make install ; make install.man
+  -  read the comments in `config.h' and edit it as appropriate
+  -  xmkmf ; make
+  -  make install install.man
 
 The xscreensaver program waits until the keyboard and mouse have been idle
 for a period, and then runs a graphics demo chosen at random.  It turns off
@@ -20,11 +22,11 @@ xautolock programs is the ease with which new graphics hacks can be
 installed: you don't need to recompile this program to add a new display
 mode, you just change some resource settings.  Any program which can be
 invoked in such a way that it draws on the root window of the screen can
-now be used as a screensaver without modification [*].  The programs that
+now be used as a screensaver without modification.  The programs that
 are being run as screensavers don't need to have any special knowledge
 about what it means to be a screensaver.
 
-The XIdle extension will be used if you have it (win win.)
+The XIDLE or MIT-SCREEN-SAVER server extensions will be used if you have them.
 
 Unfortunately, locking doesn't work if you don't have Motif.
 
@@ -35,6 +37,7 @@ window, which are pointed at by the screensaver's default resource settings.
    qix         - My own implementation of this, with many more options
                  than you would have thought qix could have.
    helix       - Generates spirally "stringart" patterns.
+   pedal       - Draws a different kind of spirally pattern.
    rorschach   - Random inkblot patterns.
    attraction  - A bouncing ball demo, or a qix-like demo, or a wild
                  color-cycling thing, with some odd rules.
@@ -44,13 +47,16 @@ window, which are pointed at by the screensaver's default resource settings.
    imsmap      - Generates random maps or cloud formations.
    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.
    halo                - Random circular patterns.
    pyro                - Fireworks.  Looks a lot like the version in xlock.
    hopalong    - Fractals.  I snarfed this code from xlock.
+   flame       - Fractals.  Also from xlock.
    noseguy     - A guy with a big nose wanders around the screen saying
                  things.  I snarfed this code from xnlock.
    maze                - This is the X maze demo modified to take a -root option
                  so that it works with xscreensaver.
+   lmorph      - morphing line drawings.
 
 All of these will pop up their own window unless given that -root option.
 See their man pages for more details.
@@ -67,11 +73,61 @@ Other reasonable things to use as screensavers, if you have them, are
   kaleid -root                 - qix-like kaleidescope patterns
   xfishtank -c black -d -r 1   - fish (use version 2.0 or later)
 
-You can get all of these from export.lcs.mit.edu.  If you know of (or write)
-any other interesting programs that can be used as screensavers, please let
-me know!
-
-       -- Jamie Zawinski <jwz@lucid.com>
-
-[*] It may be necessary to include "vroot.h" in the program, but that would
-be necessary for it to work with virtual-root window managers anyway.
+You can get all 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!
+
+The latest version of xscreensaver is always ftpable from ftp.x.org.  You can
+also get it from my web page at http://www.netscape.com/people/jwz/.
+
+       -- Jamie Zawinski <jwz@netscape.com>
+
+\f
+Changes since 1.25:    Added `lmorph' hack.
+                       Added viscosity and mouse-control to attraction.
+                       Fixed possible bad color choices in qix and attraction.
+                       Added ramp-mode to halo.
+                       Added a new RNG, which is faster and more portable
+                       than using the RNG in libc.
+                       Made locking work on SCO.
+                       Various other minor tweaks that I don't remember.
+Changes since 1.24:    Made it capture the stdout/stderr of its subprocesses
+                       and present them on the screensaver window itself.
+                       Made demo mode work correctly with non-default visuals
+                       and color maps, instead of always using the defaults.
+                       Added -visual argument to all included screenhacks.
+                       Support for the R6 MIT-SCREEN-SAVER server extension.
+                       Made the demo mode list scroll properly.
+                       Added `pedal' hack.
+Changes since 1.23:    Fixed some private-colormap oddities in slidescreen,
+                       decayscreen, and xroger.  Fixed apparent conservation-
+                       of-mass problem in pyro; made the shrapnel round.
+Changes since 1.22:    Minor tweaks for IRIX5; fixed locking race condition.
+Changes since 1.21:    Minor tweaks for X11R6.
+                       Fixes for non-default visuals.
+Changes since 1.20:    Fixed bug in color blitspin; added default image.
+                       Added diagnostics to noseguy.  Fixed off-by-one
+                       error in flame.  Added some missing casts.
+Changes since 1.18:    Added `flame' hack.
+                       Fixed a minor Motif dialog text field bug.
+                       Fixed yet another XPointer-not-defined-in-R4 bug.
+Changes since 1.17:    Added support for shadow password files.
+                       Fixed some Motif-related locking bugs.
+                       Added diagnostics when locking is disabled.
+                       Made blitspin able to use the XPM library.
+                       Added `decayscreen' hack.
+Changes since 1.16:    Added `halo' hack.
+Changes since 1.15:    Portability fixes.
+Changes since 1.14:    Broke the driver up into more source files.
+                       Moved the hacks into their own directory.
+                       Made all `time' parameters accept the 00:00:00 syntax,
+                       so that even the parameters which are normally read as
+                       `minutes' can be specified in seconds.
+                       Added colormap cycling to `imsmap'.
+                       Made hyper work with K&R compilers.
+Changes since 1.13:    Added `orbit' option to `attraction' hack.
+                       Added `lock-timeout' option.
+                       Cleaned up options of `maze' hack.
+Changes since 1.8:     Added demo mode, and locking.
+                       Added `maze' hack.
+                       Added `norotate' option to `rocks' hack.