annotate README_os390.txt @ 634:1c586ee8dd45 v7.0183

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