X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?p=xscreensaver;a=blobdiff_plain;f=README;h=fe349aa757f71b8ab1d61c5fa2b16d2aca77ab85;hp=beac235b174825362409a12ee30eb955eca4e8ed;hb=6b1c86cf395f59389e4ece4ea8f4bea2c332745b;hpb=3f438031d610c7e15fd33876a879b97e290e05fb diff --git a/README b/README index beac235b..fe349aa7 100644 --- a/README +++ b/README @@ -1,81 +1,146 @@ XScreenSaver - a screen saver and locker for the X window system - by Jamie Zawinski + a collection of + free screen savers + for X11 and MacOS - http://www.jwz.org/xscreensaver/ - -To build on Unix: - - - ./configure - - make - - make install - -The `configure' shell script will attempt to figure out which options are -appropriate for your system, and will create config.h and the various -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.) - -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 + By Jamie Zawinski + and many others -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 -small. But first, please read the enclosed `README.debugging' file to find -out what kind of information would be most helpful to include in your bug -report. - -Getting Started: - -You can try out xscreensaver like so: + http://www.jwz.org/xscreensaver/ - xscreensaver & - xscreensaver-demo +=============================================================================== -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. +This is the XScreenSaver source code distribution. It is strongly recommended +that you install a binary release rather than trying to compile it yourself. +Binaries are available for almost all platforms, including MacOS X. See the +XScreenSaver web site for details. -xscreensaver has an extensive manual -- please read it! +To compile on a Unix system with X11: - ============ + ./configure + make + make install -The xscreensaver daemon waits until the keyboard and mouse have been idle -for a period, and then runs a graphics demo chosen at random. The demo is -terminated as soon as there is any mouse or keyboard activity (or, in -locking mode, when the proper password is typed.) +To compile on MacOS X: -It is trivially easy to add new display modes to xscreensaver: any program -which can be invoked in such a way that it draws on the root window of the -screen can be used as a screensaver. You just change a config file -- -there's no need to recompile or reinstall anything. + Use the included XCode project. Requires XCode 2.4 and MacOS X 10.4.0 + or newer. - ============ +Interested in writing a new screen saver? -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 190 such programs are included. For details, see the -xscreensaver web page, or the enclosed manual pages. + See the README.hacking file. -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 +XScreenSaver has an extensive manual -- please read it! - ============ +=============================================================================== +Changes since 5.04: * New hacks, `cubicgrid', `hypnowheel', and + `lcdscrub' (which isn't really a screen saver). + * Updates to `m6502' and `gears'. + * Fixed double-buffering problems in `cubestorm' and + `noof'. + * Better handling of horizontal scroll wheels. + * Attempt to work around latest Xinerama braindamage: + if the server reports overlapping screens, use the + largest non-overlapping rectangles available. + * Don't warning about receipt of bogus ClientMessages, + since Gnome's just never going to stop sending those. + * Worked around MacOS 10.5 perl bug that caused the + text-displaying hacks to fail on some systems. + * Hopefully fixed font-related System Preferences crashes + in MacOS savers. + * The recent PAM changes broke the "Caps Lock" warning + in the password dialog, the failed login warnings, and + syslogging. Fixed all that. +Changes since 5.03: * Fixed a possible crash in the unlock dialog (more + fallout from the recent PAM changes...) + * New hacks, `moebiusgears', `abstractile', and + `lockward'. + * Rewrote `gears' to use better (involute) gear models, + and to be more random. + * Minor updates to `cwaves', `voronoi', `deco', + `glcells', `rd-bomb', `fireworkx' and `webcollage'. + * `pong' can now display the current time as the score. + * `xmatrix -mode pipe' works better. + * Minor tweaks for compilation on MacOS 10.5.0. +Changes since 5.02: * New hacks, `cwaves', `glcells', `m6502', and `voronoi'. + * Minor fixes to `bsod'. + * Fixed possible crash with PAM USB-dongle auth. + * Updated `webcollage' to track recent Google Images + and Flickr changes. +Changes since 5.01: * Reworked PAM code to support fingerprint readers, etc. + * Ported 'webcollage' to OSX. + * Added OSX 10.2 and 10.3 kernel panics to `bsod'. + * Fixed a Xinerama crash when changing the screen count. + * New blobbier `mirrorblob'. + * Minor updates to `lisa', `bsod', `ifs', `hypertorus', + `polytopes', `circuit', `endgame', `crackberg', + `flipflop', `flipscreen3d', `fliptext', and `carousel'. + * Enabled multi-threaded OpenGL on OSX. +Changes since 5.00: * Backed out recent locale-related changes, since they + broke far more things than they fixed. + * Fail gracefully with ridiculously small window sizes. + * `xflame' and `flag' ignore bitmap option on MacOS. + * `speedmine' prefs work on MacOS. + * Better explosions in `boxed'. + * More dynamic motion in `sproingies'. + * More options in `flipflop'. + * Minor updates to `topblock'. + * Various other minor fixes. +Changes since 4.24: * Ported to MacOS X! (10.4.0 or newer) + * API change: instead of providing a single screenhack() + function that does not return, screen savers using the + screenhack.h framework must now provide "init" and + "draw one frame" functions instead. All bundled savers + have been updated; third-party patches will need work. + * All image-loading happens asynchronously. + * xscreensaver-getimage-file caches the contents of the + image directory for a few hours, so consecutive runs + won't have to re-list the whole directory tree. + * New hacks, `topblock' and `glschool'. + * Removed `xteevee' (superceded by `xanalogtv'). + * Added variable-sized puzzle pieces to `jigsaw'. + * Changes to the defaults and command-line options of + many hacks to make the .xml files more consistent. + * Reap zombies in `glslideshow' and `carousel'. + * `sonar' works without setuid on OSX (dgram icmp). + * `xmatrix -mode pipe' displays the text of a subprocess. + * `endgame' has higher resolution chess-piece models. + * `webcollage' takes a -directory option to get images + from a local directory. + * The RPM spec file no longer auto-restarts xscreensaver + when a new version is installed. Restart it manually. +Changes since 4.23: * New versions of `cube21', `glsnake', `celtic'. + * Backed out a DPMS-related patch that cause desktop + flickering with some X servers. + * Fixed startup crash in getgroups() when running setuid. + * Default to not displaying stderr on the saver window. + * Fixed bad free() in "Documentation" button. + * Don't try to run hacks that aren't installed. + * Minor fixes to various XML config files and man pages. +Changes since 4.22: * New hacks, `glhanoi', `cube21', `timetunnel', + `juggler3d', and `celtic'. + * New versions of `tangram', `webcollage', `hypertorus', + `polytopes', and `ripples'. + * `sonar' is now quiet about unresolvable hosts. + * Minor corrections to BASIC code in `apple2'. + * xscreensaver-demo now provides an RPM clue when none + of the hacks seem to be installed. + * Don't install `ant' by default, since there is some + Java tool of that name, which was causing confusion. + And also it's boring. + * Made screen grabbing work again on MacOS 10.4.2. + * No longer prints bogus warnings about ClientMessages + intended for the window manager. + * Ignore unprintable characters in passwd entry field. + * Fixed yet another cross-host-display image-loading + endian problem. + * `xscreensaver-command -watch' and `-time' now work + on 64-bit machines. Changes since 4.21: * Fixed a bug in the new mouse-motion code that caused the screen to never blank on multi-head non-Xinerama systems. Oops.