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