![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to VMSINSTALL CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / contrib / emacs-18.55|
Return to VMSINSTALL CVS log | Up to [CSRG BSD Unix] / 43BSDReno / contrib / emacs-18.55 |
1.1 root 1: * Installing GNU Emacs from a VMS install kit
2:
3: If you receive a VMS distribution tape containing an install kit, you
4: can restore Emacs and run it immediately on any VMS system 4.2 or newer.
5: The installation command file will automatically rename certain files
6: whose names must vary according to the version of VMS in use.
7:
8: However, it is not certain we will have the install kit developed
9: soon, so until that is done, you may receive an ordinary BACKUP
10: saveset instead.
11:
12: * Installing GNU Emacs from an ordinary VMS BACKUP saveset
13:
14: If you receive a VMS distribution tape in VMS BACKUP interchange
15: format you can restore Emacs and run it on VMS versions 4.2 or newer
16: after executing a few commands. What you must do depends on the
17: VMS version (one procedure for VMS 4.2 or 4.3; another procedure
18: for newer VMS versions).
19:
20: For VMS versions 4.4 and up, make sure the file
21: SYS$SYSTEM:RIGHTSLIST.DAT has WORLD:R access. Emacs reads this file
22: to check file access.
23:
24: In order to compile Emacs with the VMS C compiler, you will need a
25: pagefile quota of around 22000 pages, plus enough swap space to handle
26: that. (This was in VMS 5.1-1, with 5 meg of physical memory.) See
27: HELP SYSGEN CREATE and HELP SYSGEN INSTALL for more information.
28:
29: Choose a directory to restore to, say DEV:[LIB]. Do:
30:
31: $ mount/foreign mta0:
32: $ backup/log mta0: dev:[lib...]
33:
34: Now, if you are using VMS version 4.4 or later, set your default to
35: the directory DEV:[LIB.EMACS] and run the command file
36: DEV:[LIB.EMACS]ALLRENAME.COM:
37:
38: $ set default dev:[lib.emacs]
39: $ @allrename [...] "_" "-"
40:
41: This renames all files in the Emacs distribution from their old-VMS
42: names (containing `_' characters) to their new-VMS names (containing
43: `-' instead).
44:
45: Now, edit DEV:[LIB.EMACS]EMACS.COM. Replace the definition of
46: EMACS_LIBRARY with the appropriate device and directory. The
47: definition initially reads as follows:
48:
49: $ define /translation=concealed emacs_library sys$device:[emacs.]
50:
51: You would replace this with:
52:
53: $ define /translation=concealed emacs_library dev:[lib.emacs.]
54:
55: Now execute the command file DEV:[LIB.EMACS]EMACS.COM. This defines
56: a command EMACS that runs a suspendable permanent Emacs. To
57: fully install Emacs, you must arrange for users to run this file
58: on login, or arrange for this file to be run when the system boots.
59:
60: The distribution contains an Emacs executable in
61: DEV:[LIB.EMACS]EMACS.EXE. It uses DEV:[LIB.EMACS]EMACS.DUMP every time
62: it runs. The EMACS.EXE has been linked with the non-sharable C
63: library, so it should run on any VMS V4.4+ system, whether or not the
64: C compiler exists. The .OBJ files are all there, so you can relink
65: with /debug if you want to have fun.
66:
67: A few C source files contain compilation conditionals that depend
68: on the version of VMS. We have compiled these files specially for
69: VMS version 4.2 (or 4.3) in object files with extension .JBO.
70: So to run on VMS 4.2, rename all the .JBO files to .OBJ, then
71: link and build Emacs as described in DEV:[LIB.EMACS.SRC]VMSBUILD.
72:
73: $ set def [.src]
74: $ rename *.jbo *.obj
75: $ @precomp
76: $ @link
77: $ @build
78: $ rename temacs.exe [-]emacs.exe
79: $ rename temacs.dump [-]emacs.dump
80:
81: To be clean, you should also edit the file [.SRC]CONFIG.H
82: to #include the file S_VMS4_2.H instead of S-VMS-4-4.H. Then the
83: proper conditionals will be activated if you ever recompile.
84:
85: * Moving a Unix distribution to VMS.
86:
87: Moving a Unix distribution to VMS is mostly a matter of transferring
88: the files to the VMS system, but with old versions of VMS (prior to
89: 4.4) it is a little more complicated because some of the file names
90: used on Unix are not supported by VMS. Every `-' in a Unix file name
91: must be changed to a `_' on VMS. (In VMS versions 4.4 and up, this is
92: not necessary, since `-' is allowed in file names.)
93:
94: A few other changes must be made regardless of the version of VMS:
95:
96: 1) Copy the file [.SRC]VMSPATHS.H to [.SRC]PATHS.H, replacing any existing
97: file PATHS.H in that directory.
98:
99: 2) Delete any file [.SRC]CONFIG.H and replace it with a copy of
100: CONFIG.H-DIST. Then edit this file so it specifies `m-vax.h' as the
101: second include file and for the first include file one of
102: `s-vms4-0.h', `s-vms4-2.h' or `s-vms4-4.h'. (Use the highest version
103: not greater than the VMS version you are running. For VMS versions
104: prior to 4.4, the `-' characters must be replaced with `_'.)
105:
106: You can now compile, link, build and install Emacs as described in
107: [.SRC]VMSBUILD..
108:
109: * Moving a VMS distribution to Unix.
110:
111: Delete all .OBJ files, and PATHS.H and CONFIG.H. Then copy the
112: remaining files, changing each `_' in a file name to `-`. Unix will
113: allow filenames with `_' but Emacs will not work with them!
114:
115: Names which on VMS end in a period (have a null extension) should
116: have no period on Unix. Thus, "YMAKEFILE." becomes "ymakefile".
117:
118: VMS file names are case-insensitive. On Unix, case is significant.
119: Most of the file names must be in lower case or they will not work.
120: There are only a few exceptions:
121:
122: 1) CHANGELOG. becomes ChangeLog
123: 2) MAKEFILE. becomes Makefile
124: 3) TAGS. becomes TAGS
125: 4) Files of English text with null extensions keep their names
126: in upper case. For example, README. becomes README and
127: [.ETC]GNU. becomes GNU
128:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.