home *** CD-ROM | disk | FTP | other *** search
/ vim.ftp.fu-berlin.de / 2015-02-03.vim.ftp.fu-berlin.de.tar / vim.ftp.fu-berlin.de / mac / vim54rt.sit / runtime / doc / os_vms.txt < prev    next >
Encoding:
Text File  |  1999-08-14  |  5.2 KB  |  154 lines  |  [TEXT/ALFA]
  1. *os_vms.txt*   For Vim version 5.4.  Last change: 1999 Jul 25
  2.  
  3.  
  4.           VIM REFERENCE MANUAL
  5.  
  6.  
  7.                             *VMS*
  8. This file contains the particularities for the VMS version of Vim.
  9.  
  10. 1. VMS version of Vim 5.4    |VMS-5.4|
  11. 2. VMS version of Vim 5.3    |VMS-5.3|
  12. 3. Extra remarks        |VMS-SK|
  13.  
  14. ==============================================================================
  15. 1. VMS version of Vim 5.4                    *VMS-5.4*
  16.  
  17. by Charles E. Campbell, Jr.
  18.  
  19. You will need both the Unix and Extras distributions to build vim.exe for VMS.
  20. Please read |VMS-5.3|; much of its directions on how to build vms.exe still
  21. apply.
  22.  
  23. Vim v5.4 now uses a special directory structure to hold the document
  24. and runtime files:
  25.  
  26.    vim (or wherever)
  27.     |- tmp
  28.     |- vim54
  29.     |----- doc
  30.     |----- syntax
  31.  
  32. Use
  33.     assign/nolog dev:[leading-path-here.vim54] vimruntime
  34.     assign/nolog dev:[leading-path-here.vim54.tmp] tmp
  35.  
  36. to get vim.exe to find its document, filetype, and syntax files, and to
  37. specify a directory where temporary files will be located.  Copy the
  38. "runtime" subdirectory of the vim distribution to vimruntime:.
  39.  
  40. This version has been modified so that it will internally convert any
  41. unix-style paths and even mixed unix/VMS paths into VMS style paths.  Some
  42. typical conversions resemble:
  43.  
  44.     /abc/def/ghi          -> abc:[def]ghi.
  45.     /abc/def/ghi.j        -> abc:[def]ghi.j
  46.     /abc/def/ghi/jkl/mno  -> abc:[def.ghi.jkl]mno.
  47.     abc:[def.ghi]jkl/mno  -> abc:[def.ghi.jkl]mno.
  48.  
  49. In particular, $VIM_DOC is no longer used.
  50.  
  51. Notes:
  52.  
  53.   a) I used a home-grown make program to build vim.exe from a modified
  54.      <Makefile.manx>; hence I have not tested mms/mmk.
  55.  
  56.   b) This version supports filters; ie. if you have a sort program
  57.      that can handle input/output redirection like Unix (<infile >outfile),
  58.      you could use
  59.  
  60.     map \s 0!'aqsort<CR>
  61.  
  62.      and expect it to work.
  63.  
  64.   c) For some reason binary tag searching would not work properly,
  65.      hence the VMS version uses linear tag searching by default.
  66.  
  67. ==============================================================================
  68. 2. VMS version of Vim 5.3                    *VMS-5.3*
  69.  
  70. by Bruce Hunsaker
  71.  
  72. Here is some information about building VIM 5.3 for VMS.
  73. My experience is on DEC Alpha's running VMS 7.1.
  74.  
  75. 1) You will need VMS version of unzip to unpack the
  76.    distribution.  Trying to copy an already unpacked source tree
  77.    to VMS did not work well for me (via FTP).  Binaries for these
  78.    2 utilities are readily available on the WWW.
  79.  
  80. 2) You will need either the DECSET mms utility or the freely available
  81.    clone of it called mmk.  (VMS has no make utility in the standard
  82.    distribution.)  I found a binary of 'mmk' which worked well.
  83.  
  84. 3) I suggest unpacking the distribution to the location that will be
  85.    used at run-time.  This will avoid problems trying to decide
  86.    what to move to the final 'install' directory, since there is no
  87.    'install' target in the makefile.
  88.  
  89. 3) Once unpacked, change to the vim/src directory and do:
  90.         mmk/descrip=os_vms_x.mms
  91.    This builds a version of VIM with Terminal and X-windows support.
  92.  
  93.    To build just a character mode VIM do:
  94.         mmk/descrip=os_vms.mms
  95.    (or use 'mms' instead of 'mmk' if you have it)
  96.  
  97. 4) Copy the executable (vim.exe) to a common location. (I set up
  98.    a [usr.bin] directory for this.
  99.  
  100. 5) To run, I added the following lines in my LOGIN.COM:
  101.  
  102.         $ vi*m :== $lib_disk:[usr.bin]vim.exe
  103.         $ define tmp tmp_disk:[tmp]
  104.         $ define vim "/lib_disk/usr/lib/vim-5_1/"
  105.         $ define vim_hlp lib_disk:[usr.lib.vim-5_1.doc]
  106.  
  107.     Your names for devices and directories will need to be changed
  108.     to match your system.
  109.  
  110.     After the setup is complete I run VIM with either 'vi' or 'vi -g'.
  111.     Note: 'vi -g' will not start in the background.  In order to do
  112.           that I have to resort to: 'pipe vi -g &' WARNING, this
  113.           breaks ':sh', but you can do ':!create/term/detach' to
  114.           spawn a sub-shell.
  115.  
  116. 6) Create .vimrc and .gvimrc files in your home directory.  I suggest
  117.    copying the supplied example files in the distribution, and using
  118.    them as a starting point.
  119.  
  120. 7) There are backspace/delete key inconsistencies with VMS.
  121.     :fixdel dosen't do the trick. I had to add:
  122.  
  123.         " for terminal mode
  124.         inoremap ^? ^H
  125.  
  126.         " for gui mode
  127.         inoremap <Del> ^H
  128. For compiling Vim on alpha running VMS, just invoke
  129.     mms /descrip=os_vms.mms
  130.  
  131. I've worked (and compiled) only the console version, not the GUI. It's OK.
  132. The arrow keys didn't work, I've mapped them:
  133.     :map <^V + Left-arrow> <Left>
  134. and so on.
  135.  
  136. ==============================================================================
  137. 3. Extra remarks                        *VMS-SK*
  138.  
  139. Some remarks and changes from Sandor Kopanyi:
  140.  
  141. In fileio.c there was a VMS specific section regarding creation of temporary
  142. files ("mktemp not working..." etc., "use tempnam() instead...").  Well,
  143. tempnam didn't work (for me, at least), mktemp seems to work, so I removed
  144. that section.  It is still possible to use the "original" version, defining
  145. VMS_TEMPNAM; then tempnam() will be used (if only VMS is defined, then
  146. mktemp() will be compiled).
  147.  
  148. And a problem (nothing is perfect :-): I run ViM in an X-emulator; when I
  149. paste a lot of long rows (more than ~7 rows), Vim becomes "confused", and only
  150. some parts of the rows appears, but even that ones "mixed". There is no
  151. problem with short rows (less then ~25 chars).
  152.  
  153.  vim:ts=8:sw=8:tw=78:
  154.