X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?p=xscreensaver;a=blobdiff_plain;f=README;h=699f29ca41132ef7b29e40a6170b416313c2c8d7;hp=6d3229c7337c811cd3f172b913699ca17b158c63;hb=ffd8c0873576a9e3065696a624dce6b766b77062;hpb=a1d41b2aa6e18bf9a49b914a99dda8232c5d7762 diff --git a/README b/README index 6d3229c7..699f29ca 100644 --- 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 + /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' @@ -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.