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 / amiga / vim46bin.lha / vim-4.6 / doc / vim_os2.txt < prev    next >
Encoding:
Text File  |  1997-03-12  |  5.4 KB  |  134 lines
  1. *vim_os2.txt*   For Vim version 4.6.  Last modification: 1997 Feb 17
  2.  
  3. This file contains the particularities for the OS/2 version of Vim.
  4.  
  5.  
  6. NOTE
  7.  
  8. This OS/2 port works well for me and a couple of other OS/2 users; however,
  9. since I haven't had much feedback, that either means no (OS/2-specific) bugs
  10. exist (besides the ones mentioned below), or no one has yet created a
  11. situation in which any bugs are apparent.  Report any problems or other
  12. comments to <paul@murphy.nl> or <paulS@toecompst.nl>.  Textmode/notextmode,
  13. binary mode, and FAT handling all seem to work well, which would seem to be
  14. the most likely places for trouble.
  15.  
  16. A known problem is that files opened by Vim are inherited by other programs
  17. that are started via a shell escape from within Vim.  This specifically means
  18. that Vim won't be able to remove the swap file(s) associated with buffers open
  19. at the time the other program was started, until the other program is stopped.
  20. At that time, the swap file may be removed, but if Vim could not do that the
  21. first time, it won't be removed at all. You'll get warnings that some other
  22. Vim session may be editing the file when you start Vim up again on that file.
  23. This can be reproduced with ":!start epm". Now quit Vim, and start Vim again
  24. with the file that was in the buffer at the time epm was started.  I'm working
  25. on this!
  26.  
  27. A second problem is that Vim doesn't understand the situation when using it
  28. when accessing the OS/2 system via the network, e.g. using telnet from a Unix
  29. system, and then starting Vim. The problem seems to be that OS/2 =sometimes=
  30. recognizes function / cursor keys, and tries to convert those to the
  31. corresponding OS/2 codes generated by the "normal" PC keyboard. I've been
  32. testing a workaround (mapping the OS/2 codes to the correct functions), but so
  33. far I can't say anything conclusive (this is on Warp 3, by the way). In the
  34. meantime any help will be appreciated.
  35.  
  36.  
  37. PREREQUISITES
  38.  
  39. To run Vim, you need the emx runtime environment (at least rev. 0.9b).  This
  40. is generally available as (ask Archie about it):
  41.  
  42.     emxrt.zip     emx runtime package
  43.  
  44. I've included a copy of emx.dll, which should be copied to one of the
  45. directories listed in your LIBPATH. Emx is GPL'ed, but the emx.dll library is
  46. not (read COPYING.EMX to find out what that means to you).
  47.  
  48. This emx.dll is from the emxfix04.zip package, which unfortunately has a bug,
  49. eh, I mean a POSIX feature, in select().  Versions of Vim before 3.27 will
  50. appear to hang when starting (actually, while processing vimrc). Hit return a
  51. couple of times until Vim starts working if this happens.  Next, get an up to
  52. date version of Vim!
  53.  
  54.  
  55. HELP AND VIMRC FILE
  56.  
  57. The VIM environment variable is used to find the location of the help files
  58. and the system .vimrc. Place an entry such as this in CONFIG.SYS:
  59.  
  60. SET VIM=c:/local/lib/vim
  61.  
  62. and copy all the vim_*.txt files and .vimrc to that directory. Vim will then
  63. be able to find them.
  64.  
  65. Note: .vimrc may also be called _vimrc to accommodate those who have chosen to
  66. install OS/2 on a FAT file system. Vim first tries to find .vimrc and if that
  67. fails, looks for _vimrc in the same place.
  68.  
  69. If you're using network drives with OS/2, then you can install Vim on a
  70. network drive (including .vimrc; this is then called the "system" vimrc file),
  71. and then use a personal copy of .vimrc (the "user" vimrc file). This should be
  72. located in a directory indicated by the HOME environment variable.
  73.  
  74.  
  75. ENVIRONMENT VARIABLES IN FILE NAMES
  76.  
  77. This HOME environment variable is also used when using ~ in file names, so
  78. ":e ~/textfile" will edit the file "textfile" in the directory referred to by
  79. HOME.  Additionally you can use other environment variables in file names, as
  80. as ":n $SRC/*.c".
  81.  
  82. The HOME environment variable is also used to locate the .viminfo file
  83. (see |viminfo_file|).  There is no support yet for .viminfo on FAT file
  84. systems yet, sorry.  You could try the -i startup flag (as in "vim -i
  85. $HOME/_viminfo") however.
  86.  
  87. If the HOME environment variable is not set, the value "C:/" is used as a
  88. default.
  89.  
  90.  
  91. BACKSLASHES
  92.  
  93. Using slashes ('/') and backslashes ('\') can be a bit of a problem (see
  94. vim_dos.txt for more explanation), but in almost all cases Vim does "The Right
  95. Thing".  Vim itself uses backslashes in file names, but will happily accept
  96. forward slashes if they are entered (in fact, sometimes that works better!).
  97.  
  98.  
  99. TEMP FILES
  100.  
  101. Temporary files (for filtering) are put in the first directory in the next
  102. list that exists and where a file can be created:
  103.     $TMP
  104.     $TEMP
  105.     C:\TMP
  106.     C:\TEMP
  107.     current directory
  108.  
  109.  
  110. TERMINAL SETTING
  111.  
  112. Use "os2ansi" as the TERM environment variable (or don't set it at all, as the
  113. default is the correct value). You can set term to os2ansi in the .vimrc, in
  114. case you need TERM to be a different value for other applications.  The
  115. problem is that OS/2 ANSI emulation is quite limited (it doesn't have insert /
  116. delete line, for example).
  117.  
  118. If you want to use a different value for TERM (because of other programs, for
  119. example), make sure that the termcap entry for that TERM value has the
  120. appropriate key mappings. The termcap.dat distributed with emx does not always
  121. have them.  Here are some suitable values to add to the termcap entry of your
  122. choice; these allow the cursor keys and the named function keys (such as
  123. pagedown) to work.
  124.  
  125.     :ku=\316H:kd=\316P:kl=\316K:kr=\316M:%i=\316t:#4=\316s:\
  126.     :kD=\316S:kI=\316R:kN=\316Q:kP=\316I:kh=\316G:@7=\316O:\
  127.     :k1=\316;:k2=\316<:k3=\316=:k4=\316>:k5=\316?:k6=\316@:\
  128.     :k7=\316A:k8=\316B:k9=\316C:k;=\316D:
  129.  
  130.  
  131. Paul Slootman
  132.  
  133. vim:ts=8:tw=78:
  134.