vim: README_os390.txt annotate

annotate README_os390.txt @ 7730:80ce794827c4 v7.4.1163

commit https://github.com/vim/vim/commit/17a13437c9414a8693369a97f3be2fc8ad48c12e Author: Bram Moolenaar <Bram@vim.org> Date: Sun Jan 24 14:22:10 2016 +0100 patch 7.4.1163 Problem: Expressions "0 + v:true" and "'' . v:true" cause an error. Solution: Return something sensible when using a special variable as a number or as a string. (suggested by Damien)

author	Christian Brabandt <cb@256bit.org>
date	Sun, 24 Jan 2016 14:30:04 +0100
parents	359743c1f59a
children

rev	line source
5294 359743c1f59a release version 7.4 Bram Moolenaar <bram@vim.org> parents: 5247 diff changeset	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 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	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 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	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 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	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 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	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 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	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 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	27
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	28
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	29 Compiling:
2249 6d3d35ff2c2b Use full path in undofile(). Updated docs. Bram Moolenaar <bram@vim.org> parents: 2154 diff changeset	30 ==========
7 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	31
5146 6ec6b7ff2d43 Vim 7.4a BETA release. Bram Moolenaar <bram@vim.org> parents: 2577 diff changeset	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 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	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 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	38
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	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 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	43
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	44 # Don't use c89!
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	45 # Allow intermixing of compiler options and files.
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	46
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	47 $ export CC=cc
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	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 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	50 $ cd src
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	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 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	58 $ make test
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	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 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	74
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	75 $ make install
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	76
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	77
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	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 6ec6b7ff2d43 Vim 7.4a BETA release. Bram Moolenaar <bram@vim.org> parents: 2577 diff changeset	81 WARNING: This instruction was not tested with Vim 7.4.
7 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	82
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	83 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	84 and results in a big executable (~13 Mb), the second needs a few additional
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	85 steps and results in a much smaller executable (~4.5 Mb). This examples assume
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	86 you want Motif.
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	87
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	88 The easy way:
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	89 $ export CC=cc
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	90 $ export _CC_CCMODE=1
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	91 $ ./configure --enable-max-features --enable-gui=motif
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	92 $ cd src
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	93 $ make
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	94
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	95 With this VIM is linked statically with the X11 libraries.
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	96
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	97 The smarter way:
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	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 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	100
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	101 s/-lXext *//g
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	102 s/-lXmu *//g
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	103 s/-lXm */\/usr\/lib\/Xm.x /g
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	104 s/-lX11 */\/usr\/lib\/X11.x /g
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	105 s/-lXt *//g
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	106 s/-lSM */\/usr\/lib\/SM.x /g
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	107 s/-lICE */\/usr\/lib\/ICE.x /g
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	108
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	109 Then do:
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	110 $ rm vim
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	111 $ make
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	112
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	113 Now Vim is linked with the X11-DLLs.
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	114
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	115 See the Makefile and the file link.sh on how link.sed is used.
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	116
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	117

Mercurial > vim

annotate README_os390.txt @ 7730:80ce794827c4 v7.4.1163