File: readme.vms

package info (click to toggle)
ctwm 3.7-3
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k, lenny
  • size: 6,420 kB
  • ctags: 3,180
  • sloc: ansic: 26,429; yacc: 1,004; lex: 147; makefile: 55; sh: 32
file content (123 lines) | stat: -rw-r--r-- 4,590 bytes parent folder | download | duplicates (8)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
To compile and install ctwm on VMS machines:

Unpacking and configuration:
----------------------------

0) You must have the X miscellaneous utilities and X extension libraries.
   Possibly, also have some unix type tools such as tar and gzip
   (get these from ftp.spc.edu in macros32/savesets).

1) Get the latest xpm library (at time of writing, 3.4) and compile that
   first. This is used for coloured icons. (There should be many sites that
   have a copy of xpm, try using Archie to find a site near you.)

2) Copy the xpm.h file from the xpm distribution to the ctwm source directory.

3) Edit the make.com or descrip.mms file to change x11xmu, x11xmulib,
   x11lib and EXIT_ENDSESSION logicals or symbols to point to your own set-up.

   About EXIT_ENDSESSION, see warning W1 below.

Compilation and linking:
------------------------

4) IF YOU DOWNLOADED A PACKAGE WITH OBJECT FILES, you only need to link
   ctwm, doing "@link.com".  Then go to step 7).

5) You do not need to rename the files with _VMS extensions any more.

6) compile ctwm, either with make.com by doing "@make", or with descrip.mms
   by doing "mms/ign=w".

[ N.B.:  WHEN LINKING object files that have been compiled with VAX C
  (*.VAX_VAXC_OBJ), the linker may complain about two undefined symbols.
  They are however not refered to anywhere, so this is completelly harmless.
  The two symbols are COLORCONVERTARGS and SCREENCONVERTARG.
							/Richard Levitte ]

[ N.B.2:  The resulting executable will have the name CTWM.VAX_EXE or
  CTWM.AXP_EXE!  This because you may want to compile or link for both
  architectures in the same directory.			/Richard Levitte ]

Installation:
-------------

7) When ctwm has been successfully built, work out where to put the xpm
   icons, say disk$users:[joe.xpm]. Edit the file ctwm.com and change it to
   suit you.

8) Create your user config file ctwm.rc and put it in DECW$USER_DEFAULTS.
   Now is the time to read the man page on ctwm. Be sure to read vms.txt for
   differences between the Unix ctwm and the VMS version.
   (See peterc.ctwmrc or levitte_system.ctwmrc, for an example config file.)

9) [Optional] Create your own system default config file system.ctwmrc
   and put it in DECW$SYSTEM_DEFAULTS.

10) Go to the session manager and under the Options menu pick out the
    "Menus..." item. Make a menu item called "CT Window Manager" and enter the
    DCL command "@disk$users:[joe.com]ctwm.com", as an example.

11) Go to the session manager, again, and under the Options menu pick out
    the "Automatic Startup..." item. Take out your current window manager
    and replace it with ctwm using the "CT Window Manager" item you just
    created.

12) Now all is done. Exit from the session and log back in to try out ctwm.


WARNINGS:
---------

W1) [THIS APPLIES ON VAX ONLY!]

    It seems like some older DECwindows/Motif versions end their session
    like this:

	%decw$endsession -vueimage sys$system:.exe

    this is an internal Session Manager command.  If this is how it's
    done on your machine, you'd better not use the session ending features
    of ctwm at all, or you won't get back a login prompt when you end
    your session.  In such a case, EXIT_ENDSESSION must be set to 0, or
    you may get into trouble.

W2) Bitmap (xbm) files are sometimes stored in files with no extensions
    on older Unix X11 releases, which makes definitions like this work
    on those ("plaid" is the culprit here):

	WorkSpaces {
	    "One"   {"#619AAE" "white" "firebrick" "white" "plaid"}
	}

    Since those files have never been stored without extension on VMS,
    you have to rewrite such definitions like this:

	WorkSpaces {
	    "One"   {"#619AAE" "white" "firebrick" "white" "plaid.xbm"}
	}

    I has been discussed if you couldn't add a "dna=.xbm" parameter to
    the open() or fopen() that opens the bitmap file.  This would of
    course have been possible, if the loading of bitmap files wasn't
    done through the function XmuLocateBitmapFile().  Of course, you
    could as well hack ExpandFilename(), but that is less clean.  The
    Xmu library needs to be enhanced for this task.


Ctwm 3.3 ported by Peter Chang - peterc@v2.ph.man.ac.uk 4/5/94.
Ctwm 3.4pl2 and 3.5 further ported by Richard Levitte <levitte@lp.se>


Thank you:
----------

A thank you goes to the following people:

  Claude Lecommandeur <Claude.Lecommandeur@epfl.ch>, for making ctwm
	to begin with.
  Peter Chang <peterc@v2.ph.man.ac.uk>, for the previous ports.

  Michael Lemke <ai26@a400.sternwarte.uni-erlangen.de>

/Richard Levitte, <levitte@lp.se>