Mercurial > vim
annotate README_os390.txt @ 6601:62d5e237962a
Added tag v7-4-626 for changeset 68e0e6bb8250
author | Bram Moolenaar <bram@vim.org> |
---|---|
date | Tue, 10 Feb 2015 18:47:59 +0100 |
parents | 359743c1f59a |
children |
rev | line source |
---|---|
5294 | 1 README_zOS.txt for version 7.4 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 | 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 | 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 | 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 | 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 | 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 | 27 |
28 | |
29 Compiling: | |
2249
6d3d35ff2c2b
Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents:
2154
diff
changeset
|
30 ========== |
7 | 31 |
5146 | 32 Vim can be compiled with or without GUI support. For 7.4 only the compilation |
2249
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 | 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 | 38 |
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 | 43 |
44 # Don't use c89! | |
45 # Allow intermixing of compiler options and files. | |
46 | |
47 $ export CC=cc | |
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 | 50 $ cd src |
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 | 58 $ make test |
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 | 74 |
75 $ make install | |
76 | |
77 | |
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 |
5146 | 81 WARNING: This instruction was not tested with Vim 7.4. |
7 | 82 |
83 There are two ways for building VIM with X11 support. The first way is simple | |
84 and results in a big executable (~13 Mb), the second needs a few additional | |
85 steps and results in a much smaller executable (~4.5 Mb). This examples assume | |
86 you want Motif. | |
87 | |
88 The easy way: | |
89 $ export CC=cc | |
90 $ export _CC_CCMODE=1 | |
91 $ ./configure --enable-max-features --enable-gui=motif | |
92 $ cd src | |
93 $ make | |
94 | |
95 With this VIM is linked statically with the X11 libraries. | |
96 | |
97 The smarter way: | |
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 | 100 |
101 s/-lXext *//g | |
102 s/-lXmu *//g | |
103 s/-lXm */\/usr\/lib\/Xm.x /g | |
104 s/-lX11 */\/usr\/lib\/X11.x /g | |
105 s/-lXt *//g | |
106 s/-lSM */\/usr\/lib\/SM.x /g | |
107 s/-lICE */\/usr\/lib\/ICE.x /g | |
108 | |
109 Then do: | |
110 $ rm vim | |
111 $ make | |
112 | |
113 Now Vim is linked with the X11-DLLs. | |
114 | |
115 See the Makefile and the file link.sh on how link.sed is used. | |
116 | |
117 |