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 d9d3abf467de7c591f312bbedcc4a0731814b284..699f29ca41132ef7b29e40a6170b416313c2c8d7 100644 (file)
--- a/README
+++ b/README
@@ -18,10 +18,16 @@ 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
 
+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.
+
 To build on VMS, see README.VMS.
 
 If you think you've found a bug, please let me know!  No bug report is too
@@ -57,18 +63,244 @@ 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 3.34:   * Redesigned `xscreensaver-demo' GUI.
+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').
@@ -173,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'