README_os390.txt

   1 README_os_390.txt for version 7.1 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.