changed version name
[xscreensaver] / xscreensaver / README.VMS
1 OpenVMS port of Xscreensavser version 2.10     October 1997
2 ==========================================
3
4 Xscreensaver distribution can be found in 3 subdirectories:
5
6 [.DRIVER]   The Xscreensaver and Xscreensaver-command programs.
7 [.HACKS]    Graphic demos ,can be run either through the xscreensaver program 
8             or standalone.
9 [.UTILS]    A small libraries of various utilities.
10
11 This port has been tested with  VAX VMS 6.1 (compiled with DEC 5 5.0 and
12 Motif 1.2) and AXP VMS 6.2 (compiled with DEC C 5.0 and Motif 1.2-4). 
13
14 To rebuild, you need to rebuild [.UTILS] directory first and create the
15 object library (look at the end of COMPILE*.COM procedure).
16
17 You can now build the [.HACKS] directory and the [.DRIVER] directory.
18
19 A one-step build is now available via the MAKEVMS.COM script. 
20
21 WARNING : before building [.HACKS], you may need to correct some of the
22 DECwindows bitmap files. Some files are bogus !! (they have a long line of 
23 null chars  at the end). These files are under 
24 SYS$COMMON:[DECW$INCLUDE.BITMAPS] directory:
25
26 STIPPLE.XBM
27 HLINES2.XBM
28 LIGHT_GRAY.XBM
29 ROOT_WEAVES.XBM
30 VLINES2.XBM
31
32 These files are all used by Greynetic demo.
33
34 Nota: link procedure automagically select appropriate X and Motif Libraries
35 (X11R4/Motif 1.1 - X11R5/Motif 1.2). 
36
37 The SETUP.COM procedure gives you a definition of all DCL foreign command
38 symbols needed to run Xscreensaver and all the graphic hacks. You need to
39 modify this procedure if you install these programs in another directory tree.
40
41 You can easily add new graphic demos without recompiling Xscreensaver. You just
42 need to add them in resource file XSCREENSAVER.DAT. This file (originally
43 present in [.DRIVER] directory ) can be installed under your SYS$LOGIN 
44 directory for a per-user customization basis. You can also install it under 
45 the system-wide user resource directory SYS$COMMON:[DECW$DEFAULT.USER] 
46 (with (W:RE) protections). The new graphics hack must be run in root-window 
47 mode to be accepted by Xscreensaver.
48
49 The graphic demos are spawn into subprocess created by the system() call (in
50 the Unix version the execvp() call is used).
51
52 The VMS passord checking programs were picked up in the Xlock distribution.
53
54 Enjoy,
55
56 Patrick MOREAU - CENA/Athis-Mons - FRANCE  (pmoreau@cena.dgac.fr)
57                                            (moreau_p@decus.decus.fr)