X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?p=xscreensaver;a=blobdiff_plain;f=README;h=699f29ca41132ef7b29e40a6170b416313c2c8d7;hp=15d882301a72a26c7db92a0187ec572229dabf85;hb=ffd8c0873576a9e3065696a624dce6b766b77062;hpb=14463b6ad1ab1ccf81f9c33350b048e410ba94cb diff --git a/README b/README index 15d88230..699f29ca 100644 --- a/README +++ b/README @@ -18,15 +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, you might want to delete your ~/.xscreensaver file. -If you don't, you might not see the new graphics modes. If you are upgrading -from version 2.* to version 3.*, definitely do delete your .xscreensaver file. +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 @@ -38,14 +40,11 @@ Getting Started: You can try out xscreensaver like so: xscreensaver & - xscreensaver-command -demo + xscreensaver-demo -After a few seconds, the screen should go black, and a dialog box should -appear in the upper right corner. This is "Demo Mode". - -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-command' 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! @@ -64,19 +63,459 @@ 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 100 such programs are included. For details, see the xscreensaver -web page, or the enclosed manual pages. There are also some helpful hints -on customization in the xscreensaver app-defaults file (normally installed -in /usr/lib/X11/app-defaults/XScreenSaver.) +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 + /lib/xscreensaver/ instead of /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' + was causing GL programs to malfunction or crash on + those systems. + * Improved fading on TrueColor XFree86 4.1.x systems. + * New GL hack, `circuit'. + * Added `fuzz' mode to `decayscreen'. + * New version of `whirlygig'. + * 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 + was set to a non-existent directory. + * Made `xscreensaver-getimage-video' invoke XawTV's + `streamer' program better. + * Made `phosphor' and `starwars' deal with CR, LF, + or CRLF line endings. + * Changes for Cygwin compilation environments. + * Made `sonar' compile on systems that can't ping. + * Configure changes for HPUX 10.20. + * Made PAM code work on Red Had 4.2 systems. + * Made `xscreensaver-command -deactivate' work when the + saver is not active: what that does is reset the idle + timer, as if keyboard input had been detected. This + was added for the benefit of people writing DVD-playing + software: they can now prevent the screensaver from + kicking in by sending a -deactivate message once a + minute while the movie is playing and not paused. + * Various minor portability tweaks. +Changes since 3.32: * New hacks, `speedmine' and `whirlygig'. + * Sped up `pyro', made the explosions look a bit better. + * Added better stars to `glplanet' and `starwars'. + * Many internal changes to `webcollage'. + * Some new options to `attraction'. + * Minor fix to `noseguy' to avoid un-erased pixels. + * Rewrote the screen-eraser effects so that they complete + in the same amount of time regardless of how slow + your X server is (some of them were glacial on servers + with slow blitting.) + * Fixed a potential free memory reference that could + sometimes cause a crash at startup. + * Possibly fixed a problem that could cause the daemon + to crash with an X error. I was never able to + reproduce this problem, but I think I might have + figured out what caused it. + * Worked around a problem that caused PAM authentication + to fail on some Red Hat 7.x systems. + * Added a `memoryLimit' parameter that controls the + amount of memory a graphics hack may allocate: if they + try to allocate more than this, malloc() will fail + (and they will exit or (safely) crash, rather than + hogging memory.) Default is 50M. + * Made `gnome-help-browser' be the default way to display + man pages in `xscreensaver-demo', if running on a + GNOME system. +Changes since 3.31: * The image-manipulating hacks (`slidescreen', etc.) can + now operate on randomly chosen image files from disk, + or on frames captured from the system's video input, + instead of (or in addition to) manipulating images of + the desktop. + * Rewrote `vidwhacker' to use the new image-grabbing + mechanism. + * Made fading work on TrueColor XFree86 4.x systems. + * Fixed a subtle rendering bug in `atlantis' (the fish + were inside out!) + * Made `atlantis' have a texture simulating light + reflections from the surface of the ocean. + * Fixed up label placement in `molecule'. + * Better color bars in `xteevee'. + * Made `install-strip' not try to strip scripts. +Changes since 3.30: * Put in more sensible defaults for DPMS, and updated + the documentation to reflect the fact that all your + DPMS settings are now belong to xscreensaver. + * Fixed the `xscreensaver.spec' file so that `--force' + 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'. + * New version of `gflux'. + * Made `gltext' able to display the current time. + * Fixed a floating-point-precision problem in `gltext' + that sometimes caused horizontal lines to vanish. + * Removed the `-window-id' option from the hacks: + it never worked right, and was unnecessary. + * Made the `starwars' hack use thicker lines, antialias + the text, and fade out at the far edge instead of just + dropping off. + * Fixed an SHM segment leak in `moire'. +Changes since 3.28: * Better rendering of the new logo. + * New hack, `gltext'. + * Added `-planetary' option to `gears', to draw a + different kind of gear system. + * Made motion and rotation be smoother in `gears', + `glplanet', `moebius', `rubik', and `sierpinski3d'. + * Improved coloration in `sierpinski3d'. + * Made the GL hacks react to window size changes. + * Made most of the GL hacks take a -fps option (like + `pulsar' did), so you can use them to benchmark your + 3D hardware. + * Fixed the previous fix to `sonar'. + * Minor fix to `nerverot'. + Made sonar able to ping hosts on DEC OSF1. + * Eliminated a bogus "didn't get enough colors" warning + in some of the hacks. +Changes since 3.27: * New logo for xscreensaver! + * New hacks, `starwars' and `stonerview'. + * Made the motion of the bouncing ball in `stairs' be a + little less jerky. + * Made newly-added screenhacks be added to .xscreensaver + automatically: if there are hacks in the app-defaults + file that are not also in ~/.xscreensaver, they will + be added to the end of the list. + * Redid the `Screensaver Options' part of the control + panel; xscreensaver now lets you configure your DPMS + settings. + * Fixed some Makefile problems with non-GL builds. + * Fixed detection of MesaGL for version 3.3. + * Better workaround to Red Hat 7.0's broken gcc. + * Added Sparc Solaris kernel panic to `bsod'. +Changes since 3.26: * New hacks: `zoom' and `whirlwindwarp'. + * Fixed a free-memory-reference bug in `sonar'. + * Better error handling when there are no suitable GL + visuals. + * Added diagnostic dialog when xscreensaver-demo is + unable to launch xscreensaver (e.g., when running as + root.) + * Fixed a bug that caused screenhack argument changes + to be ignored when xscreensaver-demo was running as + root (if "root" and "nobody" have different home + directories.) + * Made the programs default to ":0" if $DISPLAY is unset. + * Made the `-verbose' output include information about + which server extensions were supported at compile time. + * Worked around Red Hat 7.0's broken gcc 2.96. + * Updated default delays on the GL hacks to look better + on machines with super-fast 3D hardware. + * Install `screensaver-properties-capplet' to work around + the usual egregious GNOME lossage. +Changes since 3.25: * Added "enabled" checkboxes in the list of hacks in + xscreensaver-demo (Gtk version only.) + * New hacks `hyperball', `xrayswarm', and `gflux'. + * New versions of `nerverot', `galaxy', and `hypercube'. + * Small fixes to `phosphor', `shadebobs', `xflame', + and `sonar'. + * Added external helper program `xscreensaver-gl-helper' + to figure out which X visual to use for OpenGL + programs. + * Configure updates for XFree86 4.0, and for BSD. + * Made it be more tolerant of bogus /etc/group files. + * When installing the PAM config file, first try to just + copy an existing "xdm" or "login" config file, so that + xscreensaver does authentication in the same way as the + rest of the system. +Changes since 3.24: * New hack, `nerverot'. + * Added BSD kernel panic to `bsod'. + * New version of `shadebobs'. + * New version of `petri'. + * Updated `webcollage' to handle recent Altavista URL + format changes; made it search the AP photo gallery. + * Revamped command-line options of `sonar' and made it + properly handle subnets. + * The `bubbles' hack can now trickle up or down the + screen. + * The `xsublim' hack can now read its text from programs. + * Support for GLE version 3 in `extrusion'. + * Fixed compilation problems in `maze'. + * Fixed a rare crash in `flow'. + * Fixes for minor installation problems. +Changes since 3.23: * Added `-ignorant' option to `maze' hack. + * Updates to `critical', `bsod', `xflame', and `flow'. + * Added support for Kerberos 5 (via its Kerberos 4 + compatibility layer.) + * Fixed a bad leak in `xteevee'. + * Updated `webcollage' to handle recent Altavista URL + format changes. + * Removed xscreensaver-demo's `Ok' and `Cancel' buttons, + since they were confusing people: all changes are now + instantanious. + * Made xscreensaver-demo install itself into the Gnome + Control Center. +Changes since 3.22: * Fixed some misplaced text fields in the Motif version + of xscreensaver-demo; fixed a crash in the Gtk version + that would happen if the programs list was empty. + * Fixed a recently-introduced bug in `pulsar'. + * Made `sierpinski3d' use solid tetrahedrons instead of + points. + * Added `-trace' option to `xmatrix'. + * Added new hacks `xteevee' and `xspirograph'. Changes since 3.21: * Fixed some bugs in xscreensaver-demo. * Rewrote the Motif version of xscreensaver-demo to match the new Gtk version. @@ -86,7 +525,7 @@ Changes since 3.20: * Tweaked the xscreensaver-demo UI (Gtk only.) GL visual should be used with nVidia systems now. * Made the Makefiles obey $install_prefix. * Made the `xscreensaver.spec' file able to generate both - GL and non-GL packages simultaniously. + GL and non-GL packages simultaneously. Changes since 3.19: * Added new hacks `ripples' and `sierpinski3d'. * Made `xscreensaver-command -exit' be silent when no screen saver was running (instead of complaining.) @@ -707,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.