ftp://ftp.linux.ncsu.edu/mirror/ftp.redhat.com/pub/redhat/linux/enterprise/4/en/os...
[xscreensaver] / README
diff --git a/README b/README
index 6d3229c7337c811cd3f172b913699ca17b158c63..699f29ca41132ef7b29e40a6170b416313c2c8d7 100644 (file)
--- a/README
+++ b/README
@@ -18,14 +18,17 @@ Makefiles for you.  Run `configure --help' to see how to override these
 choices, or to specify things like the default installation directory.
 The file `INSTALL' gives a general overview of use of these sorts of
 configure scripts (those generated by the GNU autoconf system.)
-The most important hint is probably this:
+
+If you have libraries in non-standard places, you can specify their
+locations with options like this:
 
      ./configure --with-motif=/opt/Motif --with-xpm=/usr/local
 
-To build on VMS, see README.VMS.
+On MacOS X, it is strongly recommended that you install Fink first
+(http://fink.sourceforge.net/).  With Fink installed, you probably want
+to pass --prefix=/sw to configure.
 
-If you are upgrading from version 2.* to version 3.*, be sure to delete
-your ~/.xscreensaver file first, if you have one.
+To build on VMS, see README.VMS.
 
 If you think you've found a bug, please let me know!  No bug report is too
 small.  But first, please read the enclosed `README.debugging' file to find
@@ -39,9 +42,9 @@ You can try out xscreensaver like so:
        xscreensaver &
        xscreensaver-demo
 
-Note: unlike `xlock', xscreensaver has a client-server model: the
-`xscreensaver' process is a daemon that runs in the background; it is
-controlled by the foreground `xscreensaver-demo' program.
+The XScreenSaver suite of applications uses a client-server model:
+The `xscreensaver' program is a daemon that runs in the background;
+it is controlled by the foreground `xscreensaver-demo' program.
 
 xscreensaver has an extensive manual -- please read it!
 
@@ -60,17 +63,270 @@ there's no need to recompile or reinstall anything.
                               ============
 
 Along with the xscreensaver daemon itself, this package also includes
-numerous graphics hacks for use as screensavers.  There is nothing magic
-about these: they are just programs that draw on the root window.
-
-More than 120 such programs are included.  For details, see the xscreensaver
-web page, or the enclosed manual pages.
+numerous graphics hacks for use as screensavers.  There is nothing
+magic about these: they are just programs that draw on the root window.
+More than 180 such programs are included.  For details, see the
+xscreensaver web page, or the enclosed manual pages.
 
 The latest version of xscreensaver is always available on the web at
 http://www.jwz.org/xscreensaver/.
 
+Looking for tips on writing your own screensavers?  There is an entry in
+the XScreenSaver FAQ about that: http://www.jwz.org/xscreensaver/faq.html
+
                               ============
 
+Changes since 4.17:   * Oops, pay no attention to the man behind the curtain.
+Changes since 4.16:   * New hacks, `anemotaxis' and `memscroller'.
+                      * Fixed a bad bug that caused `vidwhacker' to never die.
+                      * Fixed normals and lighting in `polyhedra'.
+                      * Don't reuse the window when changing hacks (to work
+                        around bugs in some GL implementations.)
+                      * Made `xscreensaver-getimage-file' skip thumbnail-sized
+                        images.
+                      * Fixed endian problem in `barcode' on non-x86.
+                      * Updates to `webcollage', `apple2', `fuzzyflakes',
+                        `atunnel', and `pacman'.
+                      * Timing tweaks to `bubble3d', `bouncingcow', `engine',
+                        `gltext', `lavalite', `molecule', `spotlight', 
+                        `sballs', `boxed', `blinkbox', and `circuit'.
+                      * Configure updates for Fedora core 2 / xorg 6.7.0.
+                      * Compile without warnings under gcc 3.3.3.
+                      * I give up: don't blank or lock the screen if we can't
+                        get a keyboard grab.  In that case, both choices are
+                        bad.
+Changes since 4.15:   * New hacks, `polyhedra', `fuzzyflakes', `antinspect',
+                        and `providence'.
+                      * Minor updates to `webcollage', `bsod', `endgame',
+                        `antspotlight', `xmatrix', and `glmatrix'.
+                      * Added support for the RANDR (Resize and Rotate)
+                        extension to detect when the size of the desktop has
+                        been changed while xscreensaver is already running.
+                      * Possibly-futile attempt to work around "rdesktop"
+                        focus/grab idiocy.
+                      * Made `xscreensaver-getimage -file' still work even if
+                        imageDirectory is unset.
+                      * Convert Latin1 to ASCII in `starwars' and `phosphor'
+                        (since the GLUT font only has ASCII glyphs.)
+                      * Fixed randomization in `noof'.
+                      * Added "GetViewPortIsFullOfLies" preference to work
+                        around longstanding XFree86 bug #421.
+                      * Made `sonar' subnet pinging work properly on bigendian
+                        machines (e.g., PPC.)
+Changes since 4.14:   * New hacks, `wormhole', `mismunch', `noof', and
+                        `pacman'.
+                      * `phosphor' and `apple2' include vt100 emulators now:
+                        this means you can do "phosphor -program top", or
+                        can use either program as an xterm replacement:
+                        "apple2 -text -fast -program 'xemacs -nw'".
+                      * `analogtv' (and related) fill the screen better.
+                      * The '-gradient' option works in `atlantis' now.
+                      * Minor updates to `blinkbox', `queens', `endgame',
+                        `glmatrix', `mirrorblob', `blocktube', and `molecule'.
+                      * Integrated SuSE's "external passwd helper" support.
+                      * Marginally better /tmp handling in various programs.
+                      * Updated config defaults for xplanet 1.0.3.
+                      * Portability fixes.
+Changes since 4.13:   * New hacks, `fontglide', `apple2', `xanalogtv', `pong',
+                        `gleidescope', `mirrorblob', and `blinkbox'.
+                      * New version of `glsnake' (with many more models.)
+                      * Another Windows crash in `bsod'; also HVX/GCOS6/TPS6.
+                      * New version of `endgame'.
+                      * Screen grabbing works on MacOS X.
+                      * Various minor fixes.
+Changes since 4.12:   * On Xinerama systems, xscreensaver now runs one hack on
+                        each monitor (just like in "real" multi-head mode)
+                        instead of running one hack stretching across all the
+                        screens.  Note that for this to work with any 3rd party
+                        screensavers, they must update their "vroot.h" file.
+                      * `webcollage' and `vidwhacker' display images using
+                        `xscreensaver-getimage' now.
+                      * Added `ljlatest' script for use with `starwars' and
+                        `phosphor'.
+Changes since 4.11:   * New GL hacks, `flipflop', `antspotlight', and
+                        `polytopes'.
+                      * Added VMS to `bsod'.
+                      * Compile without warnings in "gcc -pedantic".
+                      * Updates to `webcollage' and `queens'.
+                      * Fixed a bug that could cause PAM to hang.
+Changes since 4.10:   * New hacks, `hypertorus', `cubestorm', `glknots',
+                        `blocktube', and `glmatrix'.
+                      * Updates to `cloudlife', `engine', `xmatrix', and
+                        `sonar'.
+                      * Rewrote `glslideshow': it should work on somewhat
+                        wimpier video cards now.
+                      * Various portability tweaks.
+Changes since 4.09:   * New hacks, `cloudlife' and `klein'.
+                      * Added Apple ][+, HPUX, and OS/390 sessions to BSOD.
+                      * Added some Matrix Reloaded text to `xmatrix'.
+                      * Updates to `webcollage', `eruption', `jigglypuff',
+                        `metaballs', and `endgame'.
+                      * Completely ignore the `memoryLimit' setting now,
+                        since it was still causing people GL grief.
+                      * Various minor fixes.
+Changes since 4.08:   * New hacks, `flyingtoasters', `bouncingcow',
+                        `jigglypuff', and `glslideshow'.
+                      * More models in `engine'.
+                      * Rewrote `xscreensaver-getimage' to remove reliance on
+                        external image loaders (xv, chbg, xloadimage, etc.)
+                        and to reduce flicker when loading files.
+                      * Made `gflux' and `flipscreen3d' be mouse-spinnable.
+Changes since 4.07:   * New hacks, `atunnels' and `piecewise'.
+                      * Physics improvement in `fluidballs'.
+                      * Various fixes for XDarwin systems (X11 on MacOS X.)
+                      * Added -clock option to `barcode'.
+                      * Minor fixes to `endgame', `flurry', `flipscreen3d',
+                        and `gflux'.
+Changes since 4.06:   * New hacks, `flurry', `metaballs', `eruption',
+                        `popsquares', and `barcode'.
+                      * Minor updates to `maze' for high density mazes.
+                      * Added double buffering to `fluidballs' and `whirlygig'.
+                      * Bug fixes for running xscreensaver to a remote XFree86
+                        display (which nobody would ever do...)
+                      * Updated `webcollage' (faster Alta Vista searching.)
+                      * Updated `glplanet' so the sun sets in the west.
+                      * Updated `sproingies' with smooth, unsegmented surfaces.
+                      * Fixed Perl version-sensitivity in
+                        `xscreensaver-getimage-file'.
+                      * Fixed GTK2 scrolling bug in `xscreensaver-demo'.
+Changes since 4.05:   * New hack, `glblur' (disabled by default, since it
+                        requires fast OpenGL texture support.)
+                      * New hack, `halftone'.
+                      * Updates to `endgame', `queens', `bumps', `glplanet',
+                        `engine', and `circuit'.
+                      * New version of `menger' that uses far fewer polygons.
+                      * Fixed minor bug in `critical' that could cause some
+                        bogus X servers to crash.
+                      * Better labels in `molecule': the labels now appear to
+                        be attached to the atoms, instead of floating in front
+                        of the whole scene.
+                      * Fixed bug that could rarely cause GL hacks to fail to
+                        double-buffer (causing intermittent flickering.)
+                      * Fixed a relative-URL-parsing bug in `webcollage'.
+                      * Fixed a bug that (sometimes) caused the window manager
+                        close box to kill `xscreensaver-demo' with a crash
+                        instead of a graceful exit.
+                      * Updated xscreensaver.pam to the Red Hat 7.3 way.
+                      * More Gnome2-related configure crap.
+                      * Updated to latest `config.guess' and `config.sub'.
+                      * Fixed occasional core dump in `distort'.
+                      * Added a Linux fsck failure and kernel panic to `bsod'.
+                      * Added MacOS X kernel panic to `bsod'.
+                      * Fixed a bug in `bsod' (all bsod bugs are ironic.)
+                      * Fixed a bug that caused `xscreensaver-gl-helper' to
+                        print a nonsense visual ID with some versions of
+                        `printf': this could cause GL programs to display
+                        incorrectly (e.g., flickery.)
+Changes since 4.04:   * More `configure' tweaks to try and get things working
+                        on systems that both Gtk 1.x and 2.x installed.
+                      * New hack, `endgame'.
+                      * Minor updates to `gltext'.
+Changes since 4.03:   * Support for GTK 2.x / GNOME 2.x.
+                      * The `configure' script will now use `pkg-config' if
+                        you have it, in preference to `gtk-config', etc.
+                      * New hacks, `lavalite', `queens', and `anemone'.
+                      * Minor updates to `spheremonics', `gltext', `xmatrix'.
+                      * You can use the mouse to manually spin most of the GL
+                        hacks now (when they are displaying in a window.)
+                      * Fixed a bug in `webcollage' (due to recent Alta Vista
+                        url changes) that was causing it to try and load 
+                        incorrect image URLs.
+                      * Made `xscreensaver-getimage' use gdk_pixbuf if it is
+                        available: this means that those hacks that load images
+                        will no longer rely on "xv", "xloadimage", etc.  This
+                        will close a race condition that could sometimes cause
+                        your desktop background to be changed; and also makes
+                        it possible for those programs to operate on image
+                        files when running in windowed mode.
+                      * `webcollage' can now be used in conjunction with
+                        `driftnet' to display images snooped from your local
+                        ethernet instead of obtained from search engines.
+                      * Added man pages for all the hacks that didn't have
+                        them.
+Changes since 4.02:   * New hack, `spheremonics'.
+                      * Minor updates to `webcollage', `cage', `moebius',
+                        `morph3d', `boxed', `circuit', and `helix'.
+                      * `pulsar' and `extrusion' can now load texture JPEGs.
+                      * `rubik' now does non-square cubes.
+                      * `fluidballs' now does various sizes of balls.
+                      * `menger' and `sierpinski3d' now also show polygon
+                        counts in -fps mode.
+                      * `molecule' displays real subscripts in the formulae.
+                      * GTK internationalization/localization support.
+                      * Better detection of the various versions of libxml.
+                      * Upgraded to autoconf 2.53 (from 2.13.)
+Changes since 4.01:   * Plugged a few minor leaks in `xscreensaver' and
+                        `xscreensaver-demo'.
+                      * New hacks, `cubenetic' and `fluidballs'.
+                      * Sped up `pipes'.
+                      * Fixed sphere projection error in `glplanet'; installed
+                        a better image of earth.
+                      * Added Win2K and MacOS 1 crashes to `bsod'.
+                      * Put back previous (better) version of `forest' that
+                        was accidentially downgraded in the last release.
+                      * New version of `bumps'.
+                      * Made FPS computation in GL hacks more efficient: it
+                        will influence the results less, thus resulting in
+                        higher (but more accurate) reported frame rates.
+Changes since 4.00:   * New hacks: `twang', `glsnake', `boxed', `sballs',
+                        and `glforestfire'.
+                      * New hacks `apollonian', `euler2d', `juggle',
+                        `polyominoes' and `thornbird', from xlockmore.
+                      * Merged recent xlockmore changes into `ant', `braid',
+                        `demon', `discrete', `drift', `fadeplot', `forest',
+                        `grav', `hopalong', `ifs', `laser', `lightning',
+                        `lisa', `lissie', `loop', `mountain', `penrose',
+                        `rotor', `sierpinski', `slip', `sphere', `spiral',
+                        `strange', and `vines'.
+                      * Fixed the `gltext' bug that sometimes caused
+                        horizontal lines to vanish again.  This time for sure.
+                      * Sped up `webcollage' by adding a C helper program to
+                        replace the PPM pipeline.  It also pastes images
+                        semi-transparently now.
+                      * Added support for the gdk_pixbuf library: if this lib
+                        is available, then `blitspin', `xflame', and `flag'
+                        can load GIF, JPEG, and PNG images in addition to XPM
+                        and XBM.
+                      * Fixed a rare race condition where the desktop-grabbing
+                        hacks could sometimes leave the screen wedged, if the
+                        user moved the mouse exactly when they were grabbing
+                        the screen image (it would un-wedge the next time the
+                        saver timed out or was activated.)
+                      * Fixed incorrect colors in the screen-grabbing GL hacks
+                        (`gflux' and `flipscreen3d'.)
+                      * Made SIGHUP restart the daemon process (though using
+                        `xscreensaver-command -restart' is still the preferred
+                        way.)
+                      * Tweaks to `xspirograph'.
+                      * Minor configure and portability tweaks.
+Changes since 3.34:   * Redesigned `xscreensaver-demo' GUI: it now includes
+                        small-preview and per-hack configuration dialogs.
+                      * Added three new modes of operation: `One Screen Saver',
+                        `Blank Screen', and `Don't Blank' (in addition to the
+                        historical `Random Screen Saver').
+                      * Configure now defaults to installing the hacks in
+                        <prefix>/lib/xscreensaver/ instead of <prefix>/bin/.
+                        (Most distros already did it this way.)
+                      * New GL hacks, `menger', `engine', `flipscreen3d'.
+                      * Made `sierpinski3d' be more colorful.
+                      * New versions of `xmatrix' and `nerverot'.
+                      * Fixed a bug in `starwars' that made the font be drawn
+                        with thin lines in -root mode.
+                      * Fixed a bad colormap bug in `crystal' that could make
+                        *subsequent* hacks malfunction!
+                      * Made `gflux' able to grab screen images (`-mode grab').
+                      * Updated `webcollage' for recent search engine changes.
+                      * Removed most command-line options to `xscreensaver':
+                        just edit the ~/.xscreensaver file instead.
+                      * Improved behavior on multi-screen and Xinerama systems:
+                        the mouse now stays on the screen where the user left
+                        it, and the password and splash dialogs always appear
+                        on the screen that has the mouse.
+                      * Made the splash dialog use more Gtk-like colors;
+                        made it have only two buttons, "Settings" and "Help".
+                      * Made `sonar' understand `.ssh/known_hosts2' format
+                        files, and be better about stripping out illegal 
+                        addresses.
 Changes since 3.33:   * Turned `memoryLimit' off by default, sigh.  Apparently
                         some versions of the GL libraries (appear to) allocate
                         hundreds of megs for every GL program, so `memoryLimit'
@@ -80,7 +336,7 @@ Changes since 3.33:   * Turned `memoryLimit' off by default, sigh.  Apparently
                       * New GL hack, `circuit'.
                       * Added `fuzz' mode to `decayscreen'.
                       * New version of `whirlygig'.
-                      * Added links to `glplanet' and `sphereEversion'.
+                      * Added links to `xplanet' and `sphereEversion'.
                       * Fixed rare race condition that could make `sonar' hang.
                       * Fixed potential crash in `speedmine'.
                       * Made `xscreensaver-demo' not crash when imageDirectory
@@ -149,7 +405,7 @@ Changes since 3.30:   * Put in more sensible defaults for DPMS, and updated
                         is no longer needed.
                       * New versions of `rotzoomer' and `nerverot'.
                       * Fixed an OSF/1 compilation problem in `molecule'.
-Changes since 3.29:   * New hacks, `molecule' `dangerball', and `rotzoomer'.
+Changes since 3.29:   * New hacks, `molecule', `dangerball', and `rotzoomer'.
                       * New version of `gflux'.
                       * Made `gltext' able to display the current time.
                       * Fixed a floating-point-precision problem in `gltext'
@@ -890,3 +1146,12 @@ Changes since 1.13:   * Added `orbit' option to `attraction' hack.
 Changes since 1.8:    * Added demo mode, and locking.
                      * Added `maze' hack.
                      * Added `norotate' option to `rocks' hack.
+Changes since 1.4:    * Works when run from XDM before anyone logs in.
+                      * Sped up `imsmap'.
+                      * Can use `xv' as a slideshow without using up colormap
+                        entries while the screen is not blanked.
+                      * Fixed a BadDrawable error in non-XIdle mode.
+                      * Added `blitspin' and `imsmap'.
+Changes since 1.0:    * Current list of included hacks is now: qix, helix,
+                        rorschach, attraction, greynetic, rocks, pyro,
+                        hopalong, and noseguy.