Copyright 1984, 1988, 1990, 1993-1995 by Rick Jansen, all rights reserved.

  X S N O W
        *
  *   *
    *       *
        *
   *

20 November 1995

How to compile:
---------------
  xmkmf
  make depend
  make

For Silicon Graphics: the man page xsnow.z can be moved 
to /usr/catman/u_man/cat1/X11/xsnow.z

VMS
---
This distribution contains a file 'make.com' to build Xsnow on
VMS systems, and 'xsnow.hlp'. To build type '@make' in the
xsnow directory. Another make.com is make2.com 

Virtual window managers
-----------------------
For compatibility with virtual window managers Xsnow uses 'vroot.h',
an include file that makes X programs compatible with window managers
like swm and tvtwm. The complete vroot distribution is available from
'ftp.x.org' in the contrib directory as 'vroot.shar.Z'.
Vroot was written by Andreas Stolcke <stolcke@ICSI.Berkeley.EDU>, 9/7/90
and is copyright 1991 by Andreas Stolcke, copyright 1990 by Solbourne 
Computer Inc.

Silicon Graphics IRIX 5.x
------------------------
(Thanks to Jon Madison, jm@iquest.net)
You don't have to turn off backgrounds & desktops to run
xsnow!!! just do:

cp /usr/lib/X11/system.backgrounds ~/.backgrounds

vi .backgrounds

and add this line:

background "snow"
   command "-execute /usr/people/jm/xsnow/xsnow"
   default "-execute /usr/people/jm/xsnow/xsnow"
   exeok "/usr/people/jm/xsnow/xsnow"

replace /usr/people/jm/xsnow/xsnow with wherever your xsnow is.

call up the Customize->backgrounds in the toolchest.

choose snow.


In case that does not work for you try:
- - - - - - - - - - - - - - - - - - - -
(Thanks to Fjodor van Slooten <fjodor@utwpue.wb.utwente.nl>)
To be able to run xsnow on a Silicon Graphics machine running
IRIX 5.x, with active desktop and icons, you should turn
desktop and icons off. Here's how to do this:

Turn off desktop management by creating a file named 'nodesktop'
on your desktop directory:

touch $HOME/.desktop-<yourmachinename>/nodesktop

Where <yourmachinename> is the hostname of your machine.
You can obtain this name with the command 'hostname'.

A simpler method: create the file .disableDesktop in your home
directory with

touch .disableDesktop

To turn off icon placement, add the following line to your
.Xdefaults file:

4Dwm*SG_usebackgrounds: False

After you made these changes you should logout and login again,
and then you must be able to start xsnow.

Of course you can get your original desktops and icons back
by reversing this process.



HP and hp-ux:
-------------
HP also uses a Workspace Manager which may interfere with Xsnow.
If Xsnow does not appear:
In the "Style Manager", choose "Backdrop" and select "NoBackdrop".
You should now be able to run Xsnow.


Update history
--------------
 1.22 Really building up snow at bottom of screen
 1.22 A choice of Santa's. Thanks to Holger Veit (Holger.Veit@gmd.de)
      for Santa no. 2. Santa 1 was derived from 2 by scaling down.
 1.23 Aaaargh! gnu C doesn't like the initialization of the new
      Santa pixmaps. Extra braces do the trick, which is so often the case
 1.24 Deleted PaintSnowAtBottom. It's more of a surprise this way.
 1.24 Bug removed with windows off-screen to the left
 1.25 Rudolf's red nose. Silly. Grmbll.
 1.25 Bug with -nokeepsnowonwindows removed
 1.27 Bug with erasing snow on top of windows removed
      Erasing of snow at bottom of screen improved in case of expose event
 1.30 Performance improved. Wind.
 1.31 Make.com and xsnow.hlp for VMS
 1.32 unsigned long snowDelay changed to long, as strtoul is troublesome
 1.35 Snow really builds up on windows now, and does not snow on pop-ups.
 1.37 Offset for certain window managers like twm, nokeepsnowonwindows
      and nokeepsnowonscreen are back.
 1.38 Santa is a real snow plough now.
 1.39 usSleep fixed for VMS. Bug resulted in using too much resources.
 1.40 -solidbg for improved performance, memory leak fixed.

 Copyright
 ---------
 Xsnow is available freely and you may give it to other people as is,
 but I retain all rights. Therefore it does not classify as 'Public
 Domain' software.

Merry X-mas!

Rick Jansen
--
rick@sara.nl

