vim

Fork of vim, an acceptable text editor
git clone git://git.laack.co/vim.git
Log | Files | Refs | README | LICENSE

README_os390.txt (3410B)


      1 README_os390.txt for version 9.2 of Vim: Vi IMproved.
      2 
      3 This readme explains how to build Vim on z/OS.  Formerly called OS/390.
      4 See "README.txt" for general information about Vim.
      5 
      6 Most likely there are not many users out there using Vim on z/OS. So chances
      7 are good, that some bugs are still undiscovered.
      8 
      9 Getting the source to z/OS:
     10 ==========================
     11 
     12 First get the source code in one big tar file and ftp it a binary to z/OS. If
     13 the tar file is initially compressed with gzip (tar.gz) or bzip2 (tar.bz2)
     14 uncompress it on your PC, as these tools are (most likely) not available on
     15 the mainframe.
     16 
     17 To reduce the size of the tar file you might compress it into a zip file. On
     18 z/OS Unix you might have the command "jar" from java to uncompress a zip. Use:
     19         jar xvf <zip file name>
     20 
     21 Unpack the tar file on z/OS with 
     22         pax -o from=ISO8859-1,to=IBM-1047 -rf vim.tar
     23 
     24 Note: The Vim source contains a few bitmaps etc which will be destroyed by
     25 this command, but these files are not needed on zOS (at least not for the
     26 console version).
     27 
     28 
     29 Compiling:
     30 ==========
     31 
     32 Vim can be compiled with or without GUI support. For 7.4 only the compilation
     33 without GUI was tested. Below is a section about compiling with X11 but this
     34 is from an earlier version of Vim.
     35 
     36 Console only:
     37 -------------
     38 
     39 If you build VIM without X11 support, compiling and building is nearly
     40 straightforward. 
     41 
     42 Change to the vim directory and do:
     43 
     44     # Don't use c89!
     45     # Allow intermixing of compiler options and files.
     46 
     47     $ export CC=cc
     48     $ export _CC_CCMODE=1
     49     $./configure --with-features=normal --without-x --enable-gui=no
     50     $ cd src
     51     $ make
     52 
     53       There may be warnings:
     54         - include files not found (libc, sys/param.h, ...)
     55         - Redeclaration of ... differs from ...
     56         -- just ignore them.
     57 
     58     $ make test
     59 
     60       This will produce lots of garbage on your screen (including error
     61       messages). Don't worry.
     62 
     63       If the test stops at one point in vim (might happen in test 11), just
     64       press :q!
     65 
     66       Expected test failures:
     67         11: If you don't have gzip installed
     68         24: test of backslash sequences in regexp are ASCII dependent
     69         42: Multibyte is not supported on z/OS
     70         55: ASCII<->EBCDIC sorting
     71         57: ASCII<->EBCDIC sorting
     72         58: Spell checking is not supported with EBCDIC
     73         71: Blowfish encryption doesn't work
     74 
     75     $ make install
     76 
     77 
     78 With X11:
     79 ---------
     80 
     81 WARNING: This instruction was not tested with Vim 7.4 or later.
     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). These examples
     86 assume 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
     99     following content (see src/link.390):
    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