Install vim73
[msysgit/mtrensch.git] / share / vim / vim73 / doc / os_390.txt
blob0140e20e8edc5d6e09b2c067ed68866b555f4bee
1 *os_390.txt*    For Vim version 7.3.  Last change: 2010 May 30
4                   VIM REFERENCE MANUAL    by Ralf Schandl
6                                         *zOS* *z/OS* *OS390* *os390* *MVS*
7 This file contains the particulars for the z/OS UNIX version of Vim.
9 1. ASCII/EBCDIC dependent scripts       |zOS-has-ebcdic|
10 2. Putty and Colors                     |zOS-PuTTY|
11 3. Motif Problems                       |zOS-Motif|
12 4. Bugs                                 |zOS-Bugs|
13 5. Limitations                          |zOS-limitations|
14 6. Open source on z/OS UNIX             |zOS-open-source|
16 Contributors: ~
17 The port to z/OS UNIX was done by Ralf Schandl for the Redbook mentioned
18 below.
20 Changes, bug-reports, or both by:
22         David Moore
23         Anthony Giorgio
24         and others
26 ==============================================================================
27 1. ASCII/EBCDIC dependent scripts       *OS390-has-ebcdic* *zOS-has-ebcdic*
29 For the internal script language the feature "ebcdic" was added.  With this
30 you can fix ASCII dependent scripts like this:
32     if has("ebcdic")
33         let space = 64
34     else
35         let space = 32
36     endif
39 ==============================================================================
40 2. PuTTY and Colors                     *OS390-PuTTY* *zOS-PuTTY*
42 If you see problems with syntax highlighting or screen corruptions when you
43 connect to z/OS using Putty, try the following:
45 - Configure Putty as "vt220" terminal (Connection->Data)
46 - Add the following 3 lines to your vimrc:
49     set t_AB=\e[4%p1%dm
50     set t_AF=\e[3%p1%dm
51     set t_CO=8
54 Note: \e is one character use <C-V><Esc> to enter it.
56 ==============================================================================
57 3. Motif Problems                       *OS390-Motif* *zOS-Motif*
59 Note: Seen with Vim 6.*, never tested since.
61 It seems that in porting the Motif library to z/OS, a translation from EBCDIC
62 to ASCII for the accelerator characters of the pull-down menus was forgotten.
63 Even after I tried to hand convert the menus, the accelerator keys continued
64 to only work for the opening of menus (like <Alt-F> to open the file menu).
65 They still do not work for the menu items themselves (like <Alt-F>O to open
66 the file browser).
68 There is no solution for this yet.
70 ==============================================================================
71 4. Bugs                                 *OS390-bugs* *zOS-Bugs*
73 - Vim will consistently hang when a large amount of text is selected in
74   visual block mode.  This may be due to a memory corruption issue.  Note that
75   this occurs in both the terminal and gui versions.
77 ==============================================================================
78 5. Limitations                          *OS390-limitations* *zOS-limitations*
80 - No binary search in tag files.
81   The program /bin/sort sorts by ASCII value by default.  This program is
82   normally used by ctags to sort the tags.  There might be a version of
83   ctags out there, that does it right, but we can't be sure.  So this seems to
84   be a permanent restriction.
86 - The cscope interface (|cscope|) doesn't work for the version of cscope
87   that we use on our mainframe.  We have a copy of version 15.0b12, and it
88   causes Vim to hang when using the "cscope add" command.  I'm guessing that
89   the binary format of the cscope database isn't quite what Vim is expecting.
90   I've tried to port the current version of cscope (15.3) to z/OS, without
91   much success.  If anyone is interested in trying, drop me a line if you
92   make any progress.
94 - No glib/gtk support.  I have not been able to successfully compile glib on
95   z/OS UNIX.  This means you'll have to live without the pretty gtk toolbar.
97 Disabled at compile time:
98     - Multibyte support         (|multibyte|)
99     - Right-to-left mode        (|rileft|)
100     - Farsi key map             (|Farsi|)
101     - Arabic language support   (|Arabic|)
102     - Spell checking            (|spell|)
104 Never tested:
105     - Perl interface            (|perl|)
106     - Hangul input              (|hangul|)
107     - Encryption support        (|encryption|)
108     - Langmap                   (|'langmap'|)
109     - Python support            (|Python|)
110     - Right-to-left mode        (|'rightleft'|)
111     - SNiFF+ interface          (|sniff|)
112     - TCL interface             (|tcl|)
113     ...
115 ==============================================================================
116 6. Open source on z/OS UNIX             *OS390-open-source* *zOS-open-source*
118 If you are interested in other Open Source Software on z/OS UNIX, have a
119 look at the following Redbook:
121     Mike MacIsaac et al
122     "Open Source Software for z/OS and OS/390 UNIX"
123     IBM Form Number: SG24-5944-01
124     ISBN: 0738424633
125     http://www-03.ibm.com/systems/resources/servers_eserver_zseries_zos_unix_redbook_sg245944.pdf
127 Also look at:
128     http://www.redbooks.ibm.com
129     http://www-03.ibm.com/systems/z/os/zos/features/unix/
130     http://www-03.ibm.com/systems/z/os/zos/features/unix/library/IBM+Redbooks/index.html
134 ------------------------------------------------------------------------------
135  vim:tw=78:fo=tcq2:ts=8:ft=help:norl: