|
7
|
1 README_os_390.txt for version 7.0aa of Vim: Vi IMproved.
|
|
|
2
|
|
|
3 Welcome to the OS/390 Unix port of VIM.
|
|
|
4
|
|
|
5 ATTENTION: THIS IS AN _ALPHA_ VERSION!!!
|
|
|
6 I expect you to know how to handle alpha software!
|
|
|
7
|
|
|
8 This port was done by Ralf Schandl <schandl@de.ibm.com>.
|
|
|
9 This port is not maintained or supported by IBM!!
|
|
|
10
|
|
|
11
|
|
|
12 For the list of changes see runtime/doc/os_390.txt.
|
|
|
13
|
|
|
14
|
|
|
15 Compiling:
|
|
|
16 ----------
|
|
|
17
|
|
|
18 Note: After the file configure was created via autoconf, it had been
|
|
|
19 handedited, to make the test for ICEConnectionNumber work.
|
|
|
20 DO NOT run autoconf again!
|
|
|
21
|
|
|
22 Without X11:
|
|
|
23
|
|
|
24 If you build VIM without X11 support, compiling and building is nearly
|
|
|
25 straightforward. The only restriction is, that you can't call make from the
|
|
|
26 VIM toplevel directory. Change to the src directory first and call make from
|
|
|
27 there. Here is a what to do:
|
|
|
28
|
|
|
29 # Don't use c89!
|
|
|
30 # Make additional symbols visible.
|
|
|
31 # Allow intermixing of compiler options and files.
|
|
|
32
|
|
|
33 $ export CC=cc
|
|
|
34 $ export CFLAGS=-D_ALL_SOURCE
|
|
|
35 $ export _CC_CCMODE=1
|
|
|
36 $./configure --enable-max-features --without-x --enable-gui=no
|
|
|
37 $ cd src
|
|
|
38 $ make
|
|
|
39 $ make test
|
|
|
40
|
|
|
41 Note: Test 28 will be reported as failed. This is because diff can't
|
|
|
42 compare files containing '\0' characters. Test 11 will fail if you
|
|
|
43 don't have gzip.
|
|
|
44
|
|
|
45 $ make install
|
|
|
46
|
|
|
47
|
|
|
48 With X11:
|
|
|
49
|
|
|
50 There are two ways for building VIM with X11 support. The first way is simple
|
|
|
51 and results in a big executable (~13 Mb), the second needs a few additional
|
|
|
52 steps and results in a much smaller executable (~4.5 Mb). This examples assume
|
|
|
53 you want Motif.
|
|
|
54
|
|
|
55 The easy way:
|
|
|
56 $ export CC=cc
|
|
|
57 $ export CFLAGS="-D_ALL_SOURCE -W c,dll"
|
|
|
58 $ export LDFLAGS="-W l,dll"
|
|
|
59 $ export _CC_CCMODE=1
|
|
|
60 $ ./configure --enable-max-features --enable-gui=motif
|
|
|
61 $ cd src
|
|
|
62 $ make
|
|
|
63
|
|
|
64 With this VIM is linked statically with the X11 libraries.
|
|
|
65
|
|
|
66 The smarter way:
|
|
|
67 Make VIM as described above. Then create a file named 'link.sed' with the
|
|
|
68 following contense:
|
|
|
69
|
|
|
70 s/-lXext *//g
|
|
|
71 s/-lXmu *//g
|
|
|
72 s/-lXm */\/usr\/lib\/Xm.x /g
|
|
|
73 s/-lX11 */\/usr\/lib\/X11.x /g
|
|
|
74 s/-lXt *//g
|
|
|
75 s/-lSM */\/usr\/lib\/SM.x /g
|
|
|
76 s/-lICE */\/usr\/lib\/ICE.x /g
|
|
|
77
|
|
|
78 Then do:
|
|
|
79 $ rm vim
|
|
|
80 $ make
|
|
|
81
|
|
|
82 Now Vim is linked with the X11-DLLs.
|
|
|
83
|
|
|
84 See the Makefile and the file link.sh on how link.sed is used.
|
|
|
85
|
|
|
86
|
|
|
87 Hint:
|
|
|
88 -----
|
|
|
89 Use the online help! (See weaknesses below.)
|
|
|
90
|
|
|
91 Example:
|
|
|
92 Enter ':help syntax' and then press <TAB> several times, you will switch
|
|
|
93 through all help items containing 'syntax'. Press <ENTER> on the one you are
|
|
|
94 interested at. Or press <Ctrl-D> and you will get a list of all items printed
|
|
|
95 that contain 'syntax'.
|
|
|
96
|
|
|
97 The helpfiles contains cross-references. Links are between '|'. Position the
|
|
|
98 cursor on them and press <Ctrl-]> to follow this link. Use <Ctrl-T> to jump
|
|
|
99 back.
|
|
|
100
|
|
|
101 Known weaknesses:
|
|
|
102 -----------------
|
|
|
103
|
|
|
104 - You can't call make from the toplevel directory, you have to do a 'cd src'
|
|
|
105 first. If you do it, make will call configure again. I don't know why and
|
|
|
106 didn't investigate it, there were more important things to do. If you can
|
|
|
107 make it work drop me a note.
|
|
|
108
|
|
|
109 - The documentation was not updated for this alpha release. It contains lot of
|
|
|
110 ASCII dependencies, especially in examples.
|
|
|
111
|
|
|
112 - Digraphs are dependent on code page 1047. Digraphs are used to enter
|
|
|
113 characters that normally cannot be entered by an ordinary keyboard.
|
|
|
114 See ":help digraphs".
|
|
|
115
|
|
|
116 - Using 'ga' to show the code of the character under the cursor shows the
|
|
|
117 correct dec/hex/oct values, but the other informations might be missing or
|
|
|
118 wrong.
|
|
|
119
|
|
|
120 - The sed syntax file doesn't work, it is ASCII dependent.
|
|
|
121
|
|
|
122 Bugs:
|
|
|
123 -----
|
|
|
124 If you find a bug please inform me (schandl@de.ibm.com), don't disturb Bram
|
|
|
125 Moolenaar. It's most likely a bug I introduced during porting or some ASCII
|
|
|
126 dependency I didn't notice.
|
|
|
127
|
|
|
128 Feedback:
|
|
|
129 ---------
|
|
|
130 Feedback welcome! Just drop me a note.
|
