Mercurial > vim

annotate README_os390.txt @ 3059:e7e703047af2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added tag v7-3-301 for changeset 4a7097153089
author Bram Moolenaar <bram@vim.org>
date Wed, 07 Sep 2011 19:58:10 +0200
parents 073ff46fe397
children 6ec6b7ff2d43
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2572
ee53a39d5896 Last changes for the 7.3 release!
Bram Moolenaar <bram@vim.org>
parents: 2561
diff changeset
1 README_zOS.txt for version 7.3 of Vim: Vi IMproved.
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
2
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3 This readme explains how to build Vim on z/OS. Formerly called OS/390.
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4 See "README.txt" for general information about Vim.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5
2453
1cd1c68045a2 Fix typos in README files. (Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
6 Most likely there are not many users out there using Vim on z/OS. So chances
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
7 are good, that some bugs are still undiscovered.
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
8
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
9 Getting the source to z/OS:
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10 ==========================
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
12 First get the source code in one big tar file and ftp it a binary to z/OS. If
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
13 the tar file is initially compressed with gzip (tar.gz) or bzip2 (tar.bz2)
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
14 uncompress it on your PC, as this tools are (most likely) not available on the
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
15 mainframe.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
17 To reduce the size of the tar file you might compress it into a zip file. On
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
18 z/OS Unix you might have the command "jar" from java to uncompress a zip. Use:
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
19 jar xvf <zip file name>
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
21 Unpack the tar file on z/OS with
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
22 pax -o from=ISO8859-1,to=IBM-1047 -rf vim.tar
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
24 Note: The Vim source contains a few bitmaps etc which will be destroyed by
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
25 this command, but these files are not needed on zOS (at least not for the
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
26 console version).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29 Compiling:
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
30 ==========
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
32 Vim can be compiled with or without GUI support. For 7.3 only the compilation
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
33 without GUI was tested. Below is a section about compiling with X11 but this
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
34 is from an earlier version of Vim.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
36 Console only:
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
37 -------------
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39 If you build VIM without X11 support, compiling and building is nearly
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
40 straightforward.
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
41
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
42 Change to the vim directory and do:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 # Don't use c89!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45 # Allow intermixing of compiler options and files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 $ export CC=cc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48 $ export _CC_CCMODE=1
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
49 $./configure --with-features=big --without-x --enable-gui=no
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
50 $ cd src
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51 $ make
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
52
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
53 There may be warnings:
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
54 - include files not found (libc, sys/param.h, ...)
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
55 - Redeclaration of ... differs from ...
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
56 -- just ignore them.
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
57
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
58 $ make test
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
59
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
60 This will produce lots of garbage on your screen (including error
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
61 messages). Don't worry.
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
62
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
63 If the test stops at one point in vim (might happen in test 11), just
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
64 press :q!
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
65
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
66 Expected test failures:
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
67 11: If you don't have gzip installed
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
68 24: test of backslash sequences in regexp are ASCII dependent
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
69 42: Multibyte is not supported on z/OS
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
70 55: ASCII<->EBCDIC sorting
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
71 57: ASCII<->EBCDIC sorting
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
72 58: Spell checking is not supported with EBCDIC
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
73 71: Blowfish encryption doesn't work
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
74
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
75 $ make install
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
76
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
77
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
78 With X11:
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
79 ---------
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
80
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
81 WARNING: This instruction was not tested with Vim 7.3.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
82
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
83 There are two ways for building VIM with X11 support. The first way is simple
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
84 and results in a big executable (~13 Mb), the second needs a few additional
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
85 steps and results in a much smaller executable (~4.5 Mb). This examples assume
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
86 you want Motif.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
87
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
88 The easy way:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
89 $ export CC=cc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
90 $ export _CC_CCMODE=1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
91 $ ./configure --enable-max-features --enable-gui=motif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
92 $ cd src
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
93 $ make
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
94
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
95 With this VIM is linked statically with the X11 libraries.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
96
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
97 The smarter way:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
98 Make VIM as described above. Then create a file named 'link.sed' with the
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
99 following content (see src/link.390):
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
100
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
101 s/-lXext *//g
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
102 s/-lXmu *//g
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
103 s/-lXm */\/usr\/lib\/Xm.x /g
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
104 s/-lX11 */\/usr\/lib\/X11.x /g
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
105 s/-lXt *//g
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
106 s/-lSM */\/usr\/lib\/SM.x /g
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
107 s/-lICE */\/usr\/lib\/ICE.x /g
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
108
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
109 Then do:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
110 $ rm vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
111 $ make
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
112
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
113 Now Vim is linked with the X11-DLLs.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
114
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
115 See the Makefile and the file link.sh on how link.sed is used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
116
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
117