ftp://updates.redhat.com/enterprise/2.1AS/en/os/SRPMS/xscreensaver-3.33-4.rhel21...
[xscreensaver] / README
1
2                               XScreenSaver
3
4             a screen saver and locker for the X window system
5                             by Jamie Zawinski
6
7                      http://www.jwz.org/xscreensaver/
8
9 To build on Unix:
10
11   -  ./configure
12   -  make
13   -  make install
14
15 The `configure' shell script will attempt to figure out which options are
16 appropriate for your system, and will create config.h and the various
17 Makefiles for you.  Run `configure --help' to see how to override these
18 choices, or to specify things like the default installation directory.
19 The file `INSTALL' gives a general overview of use of these sorts of
20 configure scripts (those generated by the GNU autoconf system.)
21 The most important hint is probably this:
22
23      ./configure --with-motif=/opt/Motif --with-xpm=/usr/local
24
25 To build on VMS, see README.VMS.
26
27 If you are upgrading from version 2.* to version 3.*, be sure to delete
28 your ~/.xscreensaver file first, if you have one.
29
30 If you think you've found a bug, please let me know!  No bug report is too
31 small.  But first, please read the enclosed `README.debugging' file to find
32 out what kind of information would be most helpful to include in your bug
33 report.
34
35 Getting Started:
36
37 You can try out xscreensaver like so:
38
39         xscreensaver &
40         xscreensaver-demo
41
42 Note: unlike `xlock', xscreensaver has a client-server model: the
43 `xscreensaver' process is a daemon that runs in the background; it is
44 controlled by the foreground `xscreensaver-demo' program.
45
46 xscreensaver has an extensive manual -- please read it!
47
48                               ============
49
50 The xscreensaver daemon waits until the keyboard and mouse have been idle
51 for a period, and then runs a graphics demo chosen at random.  The demo is
52 terminated as soon as there is any mouse or keyboard activity (or, in
53 locking mode, when the proper password is typed.)
54
55 It is trivially easy to add new display modes to xscreensaver: any program
56 which can be invoked in such a way that it draws on the root window of the
57 screen can be used as a screensaver.  You just change a config file --
58 there's no need to recompile or reinstall anything.
59
60                               ============
61
62 Along with the xscreensaver daemon itself, this package also includes
63 numerous graphics hacks for use as screensavers.  There is nothing magic
64 about these: they are just programs that draw on the root window.
65
66 More than 120 such programs are included.  For details, see the xscreensaver
67 web page, or the enclosed manual pages.
68
69 The latest version of xscreensaver is always available on the web at
70 http://www.jwz.org/xscreensaver/.
71
72                               ============
73
74 Changes since 3.32:   * New hacks, `speedmine' and `whirlygig'.
75                       * Sped up `pyro', made the explosions look a bit better.
76                       * Added better stars to `glplanet' and `starwars'.
77                       * Many internal changes to `webcollage'.
78                       * Some new options to `attraction'.
79                       * Minor fix to `noseguy' to avoid un-erased pixels.
80                       * Rewrote the screen-eraser effects so that they complete
81                         in the same amount of time regardless of how slow
82                         your X server is (some of them were glacial on servers
83                         with slow blitting.)
84                       * Fixed a potential free memory reference that could
85                         sometimes cause a crash at startup.
86                       * Possibly fixed a problem that could cause the daemon
87                         to crash with an X error.  I was never able to
88                         reproduce this problem, but I think I might have
89                         figured out what caused it.
90                       * Worked around a problem that caused PAM authentication
91                         to fail on some Red Hat 7.x systems.
92                       * Added a `memoryLimit' parameter that controls the
93                         amount of memory a graphics hack may allocate: if they
94                         try to allocate more than this, malloc() will fail
95                         (and they will exit or (safely) crash, rather than
96                         hogging memory.)  Default is 50M.
97                       * Made `gnome-help-browser' be the default way to display
98                         man pages in `xscreensaver-demo', if running on a 
99                         GNOME system.
100 Changes since 3.31:   * The image-manipulating hacks (`slidescreen', etc.) can
101                         now operate on randomly chosen image files from disk,
102                         or on frames captured from the system's video input,
103                         instead of (or in addition to) manipulating images of
104                         the desktop.
105                       * Rewrote `vidwhacker' to use the new image-grabbing
106                         mechanism.
107                       * Made fading work on TrueColor XFree86 4.x systems.
108                       * Fixed a subtle rendering bug in `atlantis' (the fish
109                         were inside out!)
110                       * Made `atlantis' have a texture simulating light
111                         reflections from the surface of the ocean.
112                       * Fixed up label placement in `molecule'.
113                       * Better color bars in `xteevee'.
114                       * Made `install-strip' not try to strip scripts.
115 Changes since 3.30:   * Put in more sensible defaults for DPMS, and updated
116                         the documentation to reflect the fact that all your
117                         DPMS settings are now belong to xscreensaver.
118                       * Fixed the `xscreensaver.spec' file so that `--force'
119                         is no longer needed.
120                       * New versions of `rotzoomer' and `nerverot'.
121                       * Fixed an OSF/1 compilation problem in `molecule'.
122 Changes since 3.29:   * New hacks, `molecule' `dangerball', and `rotzoomer'.
123                       * New version of `gflux'.
124                       * Made `gltext' able to display the current time.
125                       * Fixed a floating-point-precision problem in `gltext'
126                         that sometimes caused horizontal lines to vanish.
127                       * Removed the `-window-id' option from the hacks:
128                         it never worked right, and was unnecessary.
129                       * Made the `starwars' hack use thicker lines, antialias
130                         the text, and fade out at the far edge instead of just
131                         dropping off.
132                       * Fixed an SHM segment leak in `moire'.
133 Changes since 3.28:   * Better rendering of the new logo.
134                       * New hack, `gltext'.
135                       * Added `-planetary' option to `gears', to draw a
136                         different kind of gear system.
137                       * Made motion and rotation be smoother in `gears',
138                         `glplanet', `moebius', `rubik', and `sierpinski3d'.
139                       * Improved coloration in `sierpinski3d'.
140                       * Made the GL hacks react to window size changes.
141                       * Made most of the GL hacks take a -fps option (like
142                         `pulsar' did), so you can use them to benchmark your
143                         3D hardware.
144                       * Fixed the previous fix to `sonar'.
145                       * Minor fix to `nerverot'.
146                         Made sonar able to ping hosts on DEC OSF1.
147                       * Eliminated a bogus "didn't get enough colors" warning
148                         in some of the hacks.
149 Changes since 3.27:   * New logo for xscreensaver!
150                       * New hacks, `starwars' and `stonerview'.
151                       * Made the motion of the bouncing ball in `stairs' be a
152                         little less jerky.
153                       * Made newly-added screenhacks be added to .xscreensaver
154                         automatically: if there are hacks in the app-defaults
155                         file that are not also in ~/.xscreensaver, they will
156                         be added to the end of the list.
157                       * Redid the `Screensaver Options' part of the control
158                         panel; xscreensaver now lets you configure your DPMS
159                         settings.
160                       * Fixed some Makefile problems with non-GL builds.
161                       * Fixed detection of MesaGL for version 3.3.
162                       * Better workaround to Red Hat 7.0's broken gcc.
163                       * Added Sparc Solaris kernel panic to `bsod'.
164 Changes since 3.26:   * New hacks: `zoom' and `whirlwindwarp'.
165                       * Fixed a free-memory-reference bug in `sonar'.
166                       * Better error handling when there are no suitable GL
167                         visuals.
168                       * Added diagnostic dialog when xscreensaver-demo is
169                         unable to launch xscreensaver (e.g., when running as
170                         root.)
171                       * Fixed a bug that caused screenhack argument changes
172                         to be ignored when xscreensaver-demo was running as
173                         root (if "root" and "nobody" have different home
174                         directories.)
175                       * Made the programs default to ":0" if $DISPLAY is unset.
176                       * Made the `-verbose' output include information about
177                         which server extensions were supported at compile time.
178                       * Worked around Red Hat 7.0's broken gcc 2.96.
179                       * Updated default delays on the GL hacks to look better
180                         on machines with super-fast 3D hardware.
181                       * Install `screensaver-properties-capplet' to work around
182                         the usual egregious GNOME lossage.
183 Changes since 3.25:   * Added "enabled" checkboxes in the list of hacks in
184                         xscreensaver-demo (Gtk version only.)
185                       * New hacks `hyperball', `xrayswarm', and `gflux'.
186                       * New versions of `nerverot', `galaxy', and `hypercube'.
187                       * Small fixes to `phosphor', `shadebobs', `xflame',
188                         and `sonar'.
189                       * Added external helper program `xscreensaver-gl-helper'
190                         to figure out which X visual to use for OpenGL
191                         programs.
192                       * Configure updates for XFree86 4.0, and for BSD.
193                       * Made it be more tolerant of bogus /etc/group files.
194                       * When installing the PAM config file, first try to just
195                         copy an existing "xdm" or "login" config file, so that
196                         xscreensaver does authentication in the same way as the
197                         rest of the system.
198 Changes since 3.24:   * New hack, `nerverot'.
199                       * Added BSD kernel panic to `bsod'.
200                       * New version of `shadebobs'.
201                       * New version of `petri'.
202                       * Updated `webcollage' to handle recent Altavista URL
203                         format changes; made it search the AP photo gallery.
204                       * Revamped command-line options of `sonar' and made it
205                         properly handle subnets.
206                       * The `bubbles' hack can now trickle up or down the
207                         screen.
208                       * The `xsublim' hack can now read its text from programs.
209                       * Support for GLE version 3 in `extrusion'.
210                       * Fixed compilation problems in `maze'.
211                       * Fixed a rare crash in `flow'.
212                       * Fixes for minor installation problems.
213 Changes since 3.23:   * Added `-ignorant' option to `maze' hack.
214                       * Updates to `critical', `bsod', `xflame', and `flow'.
215                       * Added support for Kerberos 5 (via its Kerberos 4
216                         compatibility layer.)
217                       * Fixed a bad leak in `xteevee'.
218                       * Updated `webcollage' to handle recent Altavista URL
219                         format changes.
220                       * Removed xscreensaver-demo's `Ok' and `Cancel' buttons,
221                         since they were confusing people: all changes are now
222                         instantanious.
223                       * Made xscreensaver-demo install itself into the Gnome
224                         Control Center.
225 Changes since 3.22:   * Fixed some misplaced text fields in the Motif version
226                         of xscreensaver-demo; fixed a crash in the Gtk version
227                         that would happen if the programs list was empty.
228                       * Fixed a recently-introduced bug in `pulsar'.
229                       * Made `sierpinski3d' use solid tetrahedrons instead of
230                         points.
231                       * Added `-trace' option to `xmatrix'.
232                       * Added new hacks `xteevee' and `xspirograph'.
233 Changes since 3.21:   * Fixed some bugs in xscreensaver-demo.
234                       * Rewrote the Motif version of xscreensaver-demo to
235                         match the new Gtk version.
236                       * The Athena toolkit is no longer supported.
237 Changes since 3.20:   * Tweaked the xscreensaver-demo UI (Gtk only.)
238                       * Fixed a few visual selection bugs.  I think the proper
239                         GL visual should be used with nVidia systems now.
240                       * Made the Makefiles obey $install_prefix.
241                       * Made the `xscreensaver.spec' file able to generate both
242                         GL and non-GL packages simultaneously.
243 Changes since 3.19:   * Added new hacks `ripples' and `sierpinski3d'.
244                       * Made `xscreensaver-command -exit' be silent when no
245                         screen saver was running (instead of complaining.)
246                       * Made `webcollage' and `vidwhacker' use `xloadimage'
247                         when available (in addition to `xli' and `xv'.)
248                       * Improved memory usage in `petri' and gave it a hard
249                         cap on how much memory it can allocate.
250                       * Added `-watch' option to `xscreensaver-command'.
251                       * Made `xscreensaver-demo' come up with the
252                         most-recently-run hack selected by default.
253                       * Rewrote the Gtk version of `xscreensaver-demo'.
254                         It's a lot easier to use now.
255                       * Extended the format of the programs list in the
256                         .xscreensaver file, for the benefit of the new
257                         capabilities of `xscreensaver-demo'.
258                         NOTE: you might want to delete your ~/.xscreensaver
259                         file and allow it to be re-created!  The old one
260                         should still work, but xscreensaver-demo won't be as
261                         pretty.
262 Changes since 3.18:   * Fixed gcc dependencies in `bumps' and `ccurve'.
263                       * New hack, `extrusion'.
264                       * Some of the web sites that `webcollage' was using as
265                         its sources changed formats; tweaked it to understand
266                         the current layouts.
267                       * Added typeahead in the password dialog: if the screen
268                         is locked, and you unlock it by typing a character,
269                         that key will be automatically inserted in the
270                         password dialog (unless it is Return, Enter, Space,
271                         or a non-printing key like Shift.)
272                       * Made `xmatrix' take a `-small' option, since some
273                         folks with tiny screens prefer a smaller font.
274 Changes since 3.17:   * New versions of `shadebobs', `lmorph', and `distort'.
275                       * Added `ccurve', `blaster', and `bumps' hacks.
276                       * Replaced `forest' hack with a rewritten version.
277                       * Worked around a Xinerama server bug.
278                       * Fixed a bug I introduced in 3.10 that caused some
279                         hacks to print out superfluous warnings about not
280                         having gotten enough colors.
281                       * Made `sproingies' obey the `-delay' option.
282                       * Fixed a portability bug in `shadebobs'.
283                       * Made `webcollage' and `vidwhacker' use `xli' in
284                         preference to `xv', if it is available.
285                       * Added a new source of images to `webcollage'.
286                       * If running under KDE, xscreensaver will add itself to
287                         KDE's list of screensavers (via xscreensaver.kss.)
288                       * Improved detection of GL libraries.
289                       * Made the password dialog include the date and time.
290 Changes since 3.16:   * New version of `webcollage' -- deals better with
291                         corrupted images, and can use an http proxy.
292                       * New hack, `xsublim' (run it in the background,
293                         rather than adding it to the programs list.)
294                       * The xscreensaver daemon was leaking a file descriptor
295                         each time you edited your .xscreensaver file.  Fixed.
296 Changes since 3.15:   * New version of `shadebobs'.
297                       * Improved image selection in `webcollage', and sped it
298                         up slightly.
299                       * Made configure find the right version of perl.
300                       * Rewrote the CGI part of `webcollage'.
301                       * `make clean' was deleting some things it shouldn't.
302                       * Fixed a typo in the default programs list.
303 Changes since 3.14:   * Added `webcollage' and `shadebobs' hacks.
304                       * Added a `-stdout' arg to `vidwhacker' so that it can
305                         be used in a pipeline.
306                       * Made `petri' use less memory.
307 Changes since 3.13:   * Various improvements to the Gtk port.
308                       * Turned off PAM by default on Solaris, since PAM seems
309                         generally to be misconfigured out-of-the-box.
310                       * Made the `--without-gtk' configure option work.
311                       * Made configure check the Gtk version number, since it
312                         requires 1.2.
313                       * Fixed a bug in the code that attempted to prevent
314                         changes of screen resolution while the screen is
315                         locked.
316                       * Fixed a race condition in `xscreensaver-demo' that
317                         could cause an X error at startup.
318                       * Added `-transparent' option to `deluxe'.
319                       * Added `petri' hack.
320 Changes since 3.12:   * Ported `xscreensaver-demo' to Gtk.
321                       * Made it possible to build Motif, Gtk, and Athena
322                         versions of `xscreensaver-demo' in the same directory
323                         without reconfiguring.
324                       * Made `xscreensaver-demo' chase symlinks before writing
325                         the .xscreensaver file, so that if .xscreensaver is
326                         itself a symlink, the underlying file will be replaced
327                         instead.
328                       * Some Makefile and configure tweaks for Solaris and
329                         FreeBSD.
330                       * Made it possible to set the fire color in `xflame'.
331                       * Made transparency work in TrueColor (for `goop' and
332                         `qix'.)
333                       * Fixed a multi-head bug introduced by the virtual
334                         viewports stuff.
335 Changes since 3.11:   * Made it so that you can't scroll the screen while the
336                         lock dialog is up (with XFree86 virtual viewports.)
337                       * Fixed a bug in `flag' that caused bob's chin to get cut
338                         off after a few iterations.
339 Changes since 3.10:   * Made `xjack' be black-on-white-ish, so that it looks
340                         less like a computer screen and more like the
341                         typewritten paper it's supposed to be.
342                       * New version of `pulsar'.
343                       * Fixed Solaris compilation problem in `phosphor'.
344                       * Made xscreensaver notice XFree86's virtual root window
345                         hack, so that if the X server's root window is larger
346                         than the monitor's displayable resolution, the screen
347                         saver will limit itself to the area that actually
348                         appears on the screen.
349                       * Made the xscreensaver daemon do a better job of
350                         picking the visual class that should be used for GL
351                         programs.  Less user intervention should be needed
352                         now: you can use the logical visual name `GL' instead
353                         of having to figure out by hand which one to use.
354                       * Oops, the visual was defaulting to "best" instead of
355                         "default", because the .xscreensaver file was not being
356                         loaded quite early enough.
357                       * Made configure figure out how to build icmp ping
358                         support into the `sonar' hack automatically.
359                       * Made warnings about not being able to read shadow
360                         passwords not be printed if compiled with PAM support.
361                       * Improved PAM startup diagnostics.
362                       * Worked around the Solaris PAM bug that was causing
363                         crashes there, so now PAM is turned on by default.
364                       * Made configure detect the number of arguments that
365                         pam_strerror() takes, since on Linux, this apparently
366                         changed between 2.0 and 2.2, sigh.
367                       * Made the /proc/interrupts kludge look for "PS/2 Mouse"
368                         as well as "keyboard".
369                       * Made xscreensaver notice when there has been a sudden
370                         large jump in wall-clock time, and if so, lock right
371                         away, instead of waiting for "lockTimeout" to expire
372                         first.  (Laptops need this for safer recovery from
373                         ``hibernation.'')
374                       * Added `-throttle' option to `xscreensaver-command'.
375 Changes since 3.09:   * Added `phosphor', `xmatrix', and `pulsar' hacks.
376                       * Fixed a bug in the color allocator that sometimes
377                         caused `starfish' to fall back to monochrome.
378                       * Reduced the amount of code that runs before root
379                         privileges are disavowed: "normal" and "shadow"
380                         passwords now do some initialization as root, but the
381                         PAM and Kerberos authorization schemes will be
382                         initialized while running as "nobody".  Supposedly 
383                         this closes a potential security hole when using
384                         Kerberos.
385                       * Added some more sanity checking to configure.
386 Changes since 3.08:   * Added `compass', `squiral', `xflame', `wander',
387                         `spotlight', and `critical' hacks.
388                       * Added some new modes to `decayscreen'.
389                       * Made `deluxe' work in monochrome.
390                       * Generalized usage of the Double-Buffer server extension
391                         in several hacks (`compass', `deluxe', `interference',
392                         `kumppa', and `moire2'.)
393                       * Fixed another visual-depth problem in `rd-bomb'.
394                       * The screen saver will now defer blanking if neither
395                         the keyboard nor the mouse could be grabbed.  Instead,
396                         it will just try again in a few minutes.  This fixes
397                         a bad interaction between xscreensaver and programs
398                         like VMware that hold the mouse and keyboard grabbed
399                         for a long time.
400                       * Added a new erase mode (expanding spiral.)
401 Changes since 3.07:   * Fixed some bugs in my port of `t3d'.
402                       * Added `penetrate' and `deluxe' hacks.
403                       * When linking against Motif 2.x, also link against XPM.
404                       * Added support for using /proc/interrupts for idle
405                         detection on Linux.  Now xscreensaver shouldn't kick
406                         in when the user is active on a non-X virtual console.
407                       * Upgraded to autoconf 2.13.
408 Changes since 3.06:   * Configure tweaks (sometimes -lXmu wasn't getting linked
409                         in properly; check for _Xsetlocale in -lXintl.)
410                       * Portability fixes for sonar.c.
411                       * Fixed a compilation problem when you have GL but don't
412                         have XPM.
413                       * Made configure notice when MesaGL requires -lpthread.
414                       * Made `flame' ignore SIGFPE (not sure if this is the
415                         right fix; it seems only to be needed on FreeBSD.)
416                       * Kludged `rd-bomb' work on visuals that are of depth 24
417                         but that *do not* support pixmaps of depth 32.
418                       * Fixed `halo' to work properly in TrueColor.
419                       * Changed `xscreensaver.spec' to install the hacks in
420                         /usr/X11R6/lib/xscreensaver/ by default, since that's
421                         where recent Red Hat distributions put them.
422                       * Added `t3d' hack.
423                       * Updated versions of `crystal', `hopalong', and `flow'
424                         from xlockmore.
425                       * Imported `demon' and `loop' modes from xlockmore.
426 Changes since 3.05:   * Oops, the "default-n" visual descriptor was broken;
427                         it was always installing a colormap if the
428                         `installColormap' preference was set, meaning that
429                         `xearth', `xv' and friends were using the wrong
430                         colors on 8-bit systems.
431                       * Turned off HAVE_PING in `sonar', since it compiles
432                         on some Linux systems, but not others of similar
433                         vintage...
434 Changes since 3.04:   * Fixed an off-by-1 in `distort'.
435                       * Added `sonar' hack.
436                       * New version of `glplanet' (with stars.)
437                       * Made all hacks exit when you type `q' or `ESC' at them,
438                         and made them obey the WM_DELETE_WINDOW ClientMessage.
439                       * Fixed a nonfatal buffer overrun in lament (note:
440                         lament still doesn't work with MesaGL 3.0: it dies in
441                         lambda_textured_triangle1(), which is Mesa's bug, not
442                         mine.)
443 Changes since 3.03:   * Added an `xscreensaver.spec' file, to make it easier
444                         for other folks to generate RPMs.
445                       * Made the password code work on HPUX in the situation
446                         where: ``enhanced security'' is available; but not 
447                         used; but the user typed a password more than 8
448                         characters long anyway.  FTSOHPUX.
449 Changes since 3.02:   * Made locking work when passwd aging is enabled.
450                       * Added support for PAM (Pluggable Authentication
451                         Modules.)  It is still turned off by default, though,
452                         since it doesn't seem to work on Solaris 2.6, and has
453                         been behaving erratically on Red Hat 5.1.
454                       * Made each possible authentication method be tried in
455                         turn until one succeeds; this means that Kerberos is
456                         being used, we will first check Kerberos, and if that
457                         fails, will then consult the local password file.
458                         Likewise with PAM.
459                       * Save and restore the bits under the passwd dialog,
460                         to avoid leaving a black rectangle behind when 
461                         unlocking is cancelled.
462 Changes since 3.01:   * Not everyone has sys/select.h, sigh...
463 Changes since 3.00:   * Some fixes to `reflect'.
464                       * Configure tweaks.
465                       * Made it log unsuccessful attempts to unlock the screen
466                         to syslog.
467                       * Fixed a bug where `xscreensaver-demo' could be seeing
468                         a different programs list than `xscreensaver' did.
469 Changes since 2.34:   * The xscreensaver daemon no longer links against Motif
470                         or Athena: demo-mode and the preferences panel are no
471                         longer built in to the daemon, but are now handled by
472                         an external program, `xscreensaver-demo'.
473                         (I decided that this, along with the recent addition
474                         of the `.xscreensaver' config file, justified bumping
475                         the version number to 3.00, since this is a fairly
476                         major architectural change.)
477                       * Lines in the `*programs' resource may now begin with
478                         the character "-", meaning "don't run this hack."
479                         In this way, it's possible to disable a hack without
480                         throwing away the information about it (making it 
481                         easier to change your mind later.)  Eventually the
482                         preferences/demo mode GUI should represent this as a
483                         checkbox or something.
484                       * Fixed a short race condition where it was possible for
485                         xscreensaver to die with a BadWindow error if it was
486                         blanking the screen just as another window was being
487                         deleted.
488                       * Made it possible to disable specific modes in `bsod'.
489 Changes since 2.33:   * Fixed a bug that was making `pipes' generate way too
490                         many valves.  Made the viewpoint in `pipes' be selected
491                         randomly instead of always being -10 degrees.
492                       * Fixed a bug in the XSHM code, in the case where the
493                         server supports the XSHM extension but is not the same
494                         machine as the client.
495                       * Made `rd-bomb' default to taking up the whole screen.
496                       * Made it not try to do fading/unfading if no PseudoColor
497                         visuals exist.
498                       * Initial attempt at supporting VT-locking (doesn't work
499                         yet.)
500                       * Eliminated the `captureStdout' resource; now
501                         `captureStderr' controls both streams.
502                       * Added `-capture-stderr' and `-no-capture-stderr'
503                         command-line arguments.
504                       * Added `glplanet' hack.
505                       * When a hack is selected with `xscreensaver-command
506                         -select', that hack will be used until further notice
507                         (until the saver turns off, or another activation
508                         command is issued.)
509 Changes since 2.32:   * Made `xscreensaver-command' print error messages:
510                         the xscreensaver daemon now responds to ClientMessage
511                         events by writing a response message on a window
512                         property, instead of just writing to its stderr.
513                       * Made the ~/.xscreensaver file be automatically reloaded
514                         when the file date changes.
515                       * The password dialog and splash screen no longer depend
516                         on Motif or Athena.  This should clear up a number of
517                         focus problems, and is the first step on the path
518                         toward moving all of the Motif/Athena/whatever code
519                         out of the xscreensaver daemon, and into external
520                         processes.
521                       * Don't complain about LessTif 0.86 any more, since the
522                         new password dialog makes that problem go away.
523                       * Configure tweaks for Irix 6.5, SunOS 5.something.
524                       * New `-reflect' option to `distort'.
525 Changes since 2.31:   * Added reading and writing of a ~/.xscreensaver file,
526                         so that the Preferences panel can save its settings.
527                       * New version of `rubik'.
528                       * Added `-select N' argument to `xscreensaver-command'.
529                       * Oops, left out some of the `bubbles3d' files...
530 Changes since 2.30:   * The cursor was invisible in the password dialog. Fixed.
531                       * Made configure warn against MesaGL 2.6.
532                       * Fixed X error at startup when using non-default visual.
533                       * New version of `crystal', `ant', and `atlantis' from
534                         xlockmore.
535                       * New hack, `bubble3d'.
536                       * Added some new modes to `bsod'.
537 Changes since 2.29:   * Changed the order in which -lSM and -lICE are linked
538                         to be after Motif instead of before (Lesstif on Irix
539                         needs this.)
540 Changes since 2.28:   * Work around a bash bug in configure.
541                       * Tweaked HPUX paths again.  FTSOHPUX.
542                       * Made configure recommend against LessTif 0.86, due
543                         to a bug in that version that causes a security hole
544                         in the screen locking code.  LessTif 0.87 will fix it.
545                       * Made all of the `--with' options to `configure' accept
546                         a directory option as well (so that --with-motif=/FOO
547                         will add -I/FOO/include -L/FOO/lib).  I believe this is
548                         the Configure Party Line of how do to such things.
549                       * Fixed a bug where the mouse was left un-grabbed
550                         after the first time the graphics hack was changed
551                         (simplified all of the mouse-grabbing logic.)
552                       * Maybe possibly perhaps made `vidwhacker' really not
553                         leave stray xv windows around.  This time for sure.
554                       * Added a new erase mode (random dots fizzling out.)
555                       * Added `-prefs' argument to `xscreensaver-command',
556                         that brings up the Preferences dialog directly (it
557                         seems that nobody ever noticed the `Preferences' button
558                         on the Demo Mode dialog, maybe this will help.)
559                       * Added a splash screen.  Turn it off with *splash:false.
560 Changes since 2.27:   * Better macsbug text in `bsod'.
561                       * New version of `distort' with many new modes.
562                       * Plugged a leak in `coral'.
563                       * Tweaked configure for HPUX.
564                       * Removed some compiler warnings.
565                       * More consistent usage of stderr versus stdout.
566                       * More diagnostics should an X error occur.
567                       * Fixed a possible crash in SGI-specific unfading code.
568 Changes since 2.26:   * Improved version of `distort'.
569                       * Made `lament' compile against OpenGL 1.0 (though it
570                         still requires 1.1 to work properly.)
571                       * Updated my email address and home page.
572 Changes since 2.24:   * Improved motion in `rd-bomb'.
573                       * Added XSHM (shared memory extension) support to the
574                         `distort', `interference', `moire', `rd-bomb', and
575                         `swirl' hacks, which speeds them up a bit.
576                       * Added `lament' hack.
577 Changes since 2.23:   * Tweaked the order of the -L options again.
578                       * Cleaned up configure's `--help' message.
579                       * Added `kumppa' hack.
580                       * Smarter maze-solving algorithm in `maze'.
581                       * Took `xlyap' out of the default list of hacks, since
582                         it's just incredibly buggy (and slow.)  Maybe someday
583                         someone will fix it...
584                       * Added `distort' hack, but didn't add it to the default
585                         list (yet) because it's still too slow.
586                       * Made the Athena demo dialog look more like the Motif
587                         version; it has a text-entry field now, too.
588                       * Made the Athena password dialog echo asterisks, like
589                         Motif does, instead of using a flyspeck font.
590                       * Some random configure tweaks.
591                       * Added a `timestamp' resource that makes the `-verbose'
592                         messages include the time at which they were printed.
593 Changes since 2.22:   * The fix for SGI's ``scheme'' nonsense broke things, and
594                         let the user's "*background" resource show through.
595                         Fixed it in a different way.
596 Changes since 2.21:   * Added support for the DPMS server extension (Display
597                         Power Management System.)
598                       * Made configure advertize the `--enable-subdir' option a
599                         little more, since that seemed to cause some people
600                         stress.  Also, made that directory be built into the
601                         xscreensaver executable, as a hardcoded prefix to
602                         $PATH.  (Might help, shouldn't hurt.)
603                       * Made configure prefer the two-arg gettimeofday to the
604                         one-arg version, since AIX doesn't have any prototypes.
605                       * Made it work with Xaw3d (the 3D Athena library.)
606                       * Made `make install' create directories as necessary.
607                       * New version of lmorph from Sverre.
608                       * Added `crystal' and `discreet' hacks from xlockmore.
609                       * Added a new mode to `bsod'.
610 Changes since 2.20:   * Made `xscreensaver-command -time' use different words.
611                         (It now describes the two states as "screen blanked
612                         since..."  and "screen non-blanked since..." instead of
613                         "active since..." and "inactive since..." which a lot
614                         of people interpreted as meaning the opposite of what
615                         was intended.)
616                       * Improved some error messages, in the hopes of making
617                         the distinction between the xscreensaver and
618                         xscreensaver-command programs more obvious.
619                       * Rewrote (and reorganized) parts of the xscreensaver and
620                         xscreensaver-command manual pages.
621                       * Renamed xscreensaver's `-lock' command-line option to
622                         be `-lock-mode', to avoid confusion with the `-lock'
623                         option to xscreensaver-command, which does a totally
624                         different thing.
625                       * Removed xscreensaver's `-demo' command-line option for
626                         a similar reason; use `xscreensaver-command -demo'
627                         instead.
628                       * Disabled SGI's ``scheme'' nonsense in a better way than
629                         fully-qualifying the background colors in every single
630                         hack.
631                       * Fixed some other minor cosmetic problems when *sgiMode
632                         is turned on.
633                       * Fixed an X error in `bsod -root' (how ironic...)
634 Changes since 2.19:   * Fixed a bug that caused the mouse to sometimes not be
635                         grabbed properly (meaning the window manager menu could
636                         pop up over the demo-mode display.)
637                       * Fixed a bug that made the stderr output sometimes get
638                         printed twice.
639                       * Fixed a bug that made the demo-mode scrollbar move too
640                         fast.
641                       * Protected against a possible buffer overflow.
642                       * Made `vidwhacker' not leave stray xv windows around.
643                       * New version of `ant' so that Bagley doesn't calve.
644                       * Make configure on AIX get XShm from the right library.
645 Changes since 2.18:   * One file was missing from the tar file.  Fixed.
646 Changes since 2.17:   * Oops, atlantis wasn't being built by default.  Fixed.
647                       * Added `epicycle' hack.
648                       * Added `interference' hack.
649                       * Added `truchet' hack.
650                       * Added `bsod' hack.
651                       * Added some new modes to `vidwhacker'.
652 Changes since 2.16:   * Added a -window-id argument to most hacks, so that they
653                         can draw on arbitrary externally-provided windows.
654                       * Synched with xlockmore 4.11a01.
655                       * Added `flow' hack.
656                       * Added `atlantis' GL hack.
657                       * Renamed `puzzle' hack to `jigsaw', since xlock already
658                         had a different mode called `puzzle'.
659                       * Made it self-configure properly when Motif 2.1.0 is
660                         being used (requires -lXp now, sigh...)
661 Changes since 2.15:   * Made `flag' able to do XPM images.
662                       * New look for the xscreensaver logo (`xroger').
663                       * Fixed compilation error on Suns with adjunct passwords.
664                       * Got multi-architecture builds working again.
665                       * Some configure tweaks for building on HPUX and Solaris.
666                       * Fixed bug in decayscreen.
667                       * Fixed typo in passwd.c.
668                       * Made `cynosure' not die when colormap is full.
669 Changes since 2.14:   * Added `cynosure' hack.
670                       * Added `moire2' hack.
671                       * Tweaked `erase.c' some more.
672                       * Made unfading a bit smoother.
673                       * Added `vidwhacker' hack (not installed by default.)
674                       * Added `stairs' hack.
675                       * Split `escher' into `cage' and `moebius', as per
676                         xlockmore.
677                       * Changed subprocess handling to use sigaction() instead
678                         of signal() if it's available (this is necessary for
679                         SCO but should work fine on other systems too.)
680                       * Various other tweaks.
681 Changes since 2.13:   * Better fix for the Motif drag-and-die lossage.
682                       * Put in some kludges to work around a LessTif bug.
683                       * XScreenSaver is known to work with LessTif 0.82 now.
684                       * Made fading work on high-end SGI video hardware.
685                       * Fixed another SGI-specific bug in screen grabbing;
686                         will the madness never cease?
687                       * Fixed another crash in `xlyap'.
688 Changes since 2.12:   * Made `decayscreen' do directions other than down.
689                       * Improved `puzzle'.
690                       * Fixed a crash in `xlyap'.
691                       * Added CDE info to the man page, removed `cde.txt'.
692                       * Configure tweaks for Zippy.
693                       * Turned off the signal handling in `bubbles' because
694                         it was sometimes failing to die.
695                       * Added `hacks/xscreensaver-sgigl.c' to make it possible
696                         to run SGI's ElectroPaint hack (/usr/demos/bin/ep)
697                         with xscreensaver.  Finally!
698                       * Fixed a buffer overrun in the locking code that some
699                         wily, malicious cracker must have slipped in.
700                       * Disabled Motif drag-and-drool in the dialog box
701                         buttons, since it's broken in some old versions of
702                         Motif.
703 Changes since 2.11:   * Added `README.debugging'.
704                       * Added `puzzle' hack.
705                       * Added `xlyap' hack.
706                       * Added `default-n' as a visual name, so that one can
707                         have -install on by default, but turn it off for
708                         certain poorly-behaved hacks (like xv.)
709                       * Added support for grabbing frames of external video
710                         (on SGI) to the screen-grabbing hacks (decayscreen,
711                         slidescreen, slip, blitspin, and puzzle.)
712                       * Improved look of tiles in `slidescreen'; fixed its
713                         color allocation problem.
714 Changes since 2.10:   * Tweaked `blitspin', added it to the default list.
715                       * Added `lissie', `mountain', `triangle', `worm',
716                         `rotor', and `ant' from xlockmore.
717                       * Updated `sierpinski', `galaxy', and `lisa'.
718                       * Thickened the lines in `braid' and `lmorph'.
719                       * Updated VMS makefiles.
720                       * Renamed `fract' to `vines'.
721                       * Added `xjack' hack.
722                       * Made a few more hacks use erase.c, and added a few
723                         more wipe styles.
724                       * Fixed compilation problem with Sun's version of OpenGL.
725                       * Added ability to use sigaction() instead of signal()
726                         to work around a SCO kernel bug.
727 Changes since 2.09:   * Fixed colormap bugs in `rd-bomb'; sped up `coral'.
728                       * Configure tweaks for *BSD.
729 Changes since 2.07:   * New hacks `rd-bomb' and `coral'.
730                       * New version of `maze' with some new algorithms.
731                       * New colorized version of `rocks'.
732                       * Fixed a bug in qix on 64-bit machines.
733                       * Fixed a bug in the -time option.
734                       * Fixed a bug in configure related to LessTif.
735 Changes since 2.06:   * Minor header tweaks in windows.c and flag.c.
736                       * Made multi-architecture ($VPATH) builds work properly.
737                       * Merged new GL stuff from xlockmore (rubik, morph3d.)
738                       * Fixed intermittent crashes in `imsmap' and `munch'.
739                       * Added `fadeplot' hack from xlockmore.
740 Changes since 2.05:   * Merged in VMS support from Patrick Moreau.
741 Changes since 2.04:   * Fixed a MIT-SCREEN-SAVER-related crash, and tweaked
742                         configure to detect the extra-random -Xss library.
743 Changes since 2.03:   * HP configure tweaks.  Detect and warn about LessTif.
744                       * Fixed low-color behavior of `goop', `pyro', `starfish',
745                         `greynetic', `flame', `halo', and `moire'.
746 Changes since 2.02:   * Fixed flicker in `pipes'.  Fixed 3d in `bouboule'.
747                       * Added `munch' hack.
748                       * Added basic dependencies to the Makefile.in files.
749 Changes since 2.01:   * Fixes for compiling with the MIT saver extension.
750                       * Made the yow/fortune program be a configure option.
751                       * Various configure tweaks.
752 Changes since 2.00:   * Added `goop' and `starfish' hacks.
753                       * Added colomap cycling to `halo'.
754                       * Made `attraction' use the new colormap allocator.
755                       * Added better $PATH diagnostics.
756                       * There was a bug in frand!  Color selection should be
757                         much improved now.
758 Changes since 1.34:   * Converted to use `configure' instead of `imake'.
759                       * ANSI C is now required.
760                       * Added Kerberos locking support, from Nat Lanza.
761                       * Made the stderr text use overlay planes, if possible.
762                       * Reworked the xlockmore compatibility stuff again.
763                       * Added `gears', `superquadrics', `escher', `pipes',
764                         and `sproingies' hacks (depend on OpenGL.)
765 Changes since 1.33:   * Fixed some bugs, made fading be a little smoother.
766 Changes since 1.32:   * Made it work with multi-headed displays.
767                       * Generalized sub-process management (Unix sucks!)
768                       * Added interactive mouse frobbing to Julia.
769                       * Added (untested) support for HPUX shadow passwords.
770                       * Made normal non-shadow passwords be checked if the
771                         shadow passwords aren't accessible for some reason.
772 Changes since 1.31:   * Removed *colorPrograms and *monoPrograms resources:
773                         made it possible to specify the desired visual on a
774                         per-hack basis.
775                       * Cleaned up / restructured the driver: no more globals.
776                       * Made the Motif and Athena dialogs share more code.
777                       * Probably fixed some Athena colormap-installation bugs.
778                       * Fixed screen grabbing (cmap) on SGI 12-bit PseudoColor.
779                       * Fixed divide-by-zero in bright random colormaps.
780                       * Added an improved version of xlock's `flag' hack.
781                       * Made unfading work better, and not flicker on SGIs.
782                       * Added `sphere', `forest', `lisa' hacks from xlockmore.
783                       * Added (untested) support for SunOS Adjunct passwords.
784 Changes since 1.30:   * Improved colors and colormap cycling of many hacks.
785                       * Cleaned up xlockmore compatibility layer.
786                       * Made `blitspin' able to grab an image off the screen.
787                       * Ported `swirl' and `bouboule' hacks from xlockmore.
788                       * Made the driver more careful about not leaving bits on
789                         the screen, or allowing other windows to raise
790                         themselves: it now re-blanks the screen every so often.
791                       * Added `-time' option to `xscreensaver-command'.
792                       * Improved SGI screen-grabbing some more: now it can grab
793                         TrueColor screens into PseudoColor windows and have the
794                         colors still come out semi-reasonably.
795 Changes since 1.29:   * Made `slidescreen' and `decayscreen' work better on
796                         SGIs when windows of different visuals are present, by
797                         using the XReadDisplay() extension to get a true 24-bit
798                         image out of the frame buffer.
799                       * Made `noseguy' be in color, if compiled with XPM.
800                       * Ported `braid', `drift', `fract', `galaxy', `grav',
801                         `ifs', `julia', `laser', `lightning', `penrose',
802                         `sierpinski', `slip', `spiral', and `strange' hacks
803                         from xlockmore.
804                       * Merged `hopalong' hack with a more recent version.
805                       * Added `cde.txt'.
806 Changes since 1.27:   * Added `deco', `moire', and `kaleidescope' hacks.
807                       * Merged in support for non-Motif locking and demo mode.
808                       * Made `blitspin' and `bubbles' work in TrueColor.
809                       * Fixed a stupid bug I introduced in `imsmap'.
810                       * Added `poly' and `gravity' options to `qix'.
811 Changes since 1.26:   * Added support for SGI SCREEN_SAVER extension.
812                       * Made `fade' and `unfade' work on 8-bit SGIs.
813                       * Made the dialog boxes more Motify.
814                       * Added `bubbles' hack.
815 Changes since 1.25:   * Added `lmorph' hack.
816                       * Added viscosity and mouse-control to attraction.
817                       * Fixed possible bad color choices in qix and attraction.
818                       * Added ramp-mode to halo.
819                       * Added a new RNG, which is faster and more portable
820                         than using the RNG in libc.
821                       * Made locking work on SCO.
822                       * Various other minor tweaks that I don't remember.
823 Changes since 1.24:   * Made it capture the stdout/stderr of its subprocesses
824                         and present them on the screensaver window itself.
825                       * Made demo mode work correctly with non-default visuals
826                         and color maps, instead of always using the defaults.
827                       * Added -visual argument to all included screenhacks.
828                       * Support for the R6 MIT-SCREEN-SAVER server extension.
829                       * Made the demo mode list scroll properly.
830                       * Added `pedal' hack.
831 Changes since 1.23:   * Fixed some private-colormap oddities in slidescreen,
832                         decayscreen, and xroger.  Fixed apparent conservation-
833                         of-mass problem in pyro; made the shrapnel round.
834 Changes since 1.22:   * Minor tweaks for IRIX5; fixed locking race condition.
835 Changes since 1.21:   * Minor tweaks for X11R6.
836                       * Fixes for non-default visuals.
837 Changes since 1.20:   * Fixed bug in color blitspin; added default image.
838                       * Added diagnostics to noseguy.  Fixed off-by-one
839                         error in flame.  Added some missing casts.
840 Changes since 1.18:   * Added `flame' hack.
841                       * Fixed a minor Motif dialog text field bug.
842                       * Fixed yet another XPointer-not-defined-in-R4 bug.
843 Changes since 1.17:   * Added support for shadow password files.
844                       * Fixed some Motif-related locking bugs.
845                       * Added diagnostics when locking is disabled.
846                       * Made blitspin able to use the XPM library.
847                       * Added `decayscreen' hack.
848 Changes since 1.16:   * Added `halo' hack.
849 Changes since 1.15:   * Portability fixes.
850 Changes since 1.14:   * Broke the driver up into more source files.
851                       * Moved the hacks into their own directory.
852                       * Made all `time' parameters accept the 00:00:00 syntax,
853                         so that even the parameters which are normally read as
854                         minutes can be specified in seconds.
855                       * Added colormap cycling to `imsmap'.
856                       * Made hyper work with K&R compilers.
857 Changes since 1.13:   * Added `orbit' option to `attraction' hack.
858                       * Added `lock-timeout' option.
859                       * Cleaned up options of `maze' hack.
860 Changes since 1.8:    * Added demo mode, and locking.
861                       * Added `maze' hack.
862                       * Added `norotate' option to `rocks' hack.