comparison runtime/doc/os_vms.txt @ 2033:de5a43c5eedc

Update documentation files.
author Bram Moolenaar <bram@zimbu.org>
date Wed, 06 Jan 2010 20:52:26 +0100
parents 71eaeb69efe4
children 7c8c7c95a865
comparison
equal deleted inserted replaced
2032:592032e9e167 2033:de5a43c5eedc
1 *os_vms.txt* For Vim version 7.2. Last change: 2008 Aug 19 1 *os_vms.txt* For Vim version 7.2. Last change: 2009 Oct 28
2 2
3 3
4 VIM REFERENCE MANUAL 4 VIM REFERENCE MANUAL
5 5
6 6
137 137
138 define/nolog VIM device:[path.vim] 138 define/nolog VIM device:[path.vim]
139 define/nolog VIMRUNTIME device:[path.vim.vim60] 139 define/nolog VIMRUNTIME device:[path.vim.vim60]
140 define/nolog TMP device:[path.tmp] 140 define/nolog TMP device:[path.tmp]
141 141
142 to get vim.exe to find its document, filetype, and syntax files, and to 142 To get vim.exe to find its document, filetype, and syntax files, and to
143 specify a directory where temporary files will be located. Copy the "runtime" 143 specify a directory where temporary files will be located. Copy the "runtime"
144 subdirectory of the vim distribution to vimruntime. 144 subdirectory of the Vim distribution to vimruntime.
145 145
146 Logicals $VIMRUNTIME and $TMP are optional. 146 Logicals $VIMRUNTIME and $TMP are optional.
147 147
148 If $VIMRUNTIME is not set, Vim will guess and try to set up automatically. 148 If $VIMRUNTIME is not set, Vim will guess and try to set up automatically.
149 Read more about it at :help runtime 149 Read more about it at :help runtime
215 You just have to define the "whole" path: > 215 You just have to define the "whole" path: >
216 216
217 $ define VIM "<server_name>[""user password""]::device:<path>" 217 $ define VIM "<server_name>[""user password""]::device:<path>"
218 $ vi*m :== "mcr VIM:VIM.EXE" 218 $ vi*m :== "mcr VIM:VIM.EXE"
219 219
220 as for example: > 220 As for example: >
221 221
222 $ define VIM "PLUTO::RF10:[UTIL.VIM]" 222 $ define VIM "PLUTO::RF10:[UTIL.VIM]"
223 $ define VIM "PLUTO""ZAY mypass""::RF10:[UTIL.VIM]" ! if passwd required 223 $ define VIM "PLUTO""ZAY mypass""::RF10:[UTIL.VIM]" ! if passwd required
224 224
225 You can also use the $VIMRUNTIME logical to point to the proper version of Vim 225 You can also use the $VIMRUNTIME logical to point to the proper version of Vim
232 then add to the SYS$STARTUP:SYLOGICALS.COM > 232 then add to the SYS$STARTUP:SYLOGICALS.COM >
233 233
234 $ define/nolog/sys VIM device:<path> 234 $ define/nolog/sys VIM device:<path>
235 $ define/nolog/sys TMP SYS$SCRATCH 235 $ define/nolog/sys TMP SYS$SCRATCH
236 236
237 and to the SYS$STARTUP:SYLOGIN.COM > 237 And to the SYS$STARTUP:SYLOGIN.COM >
238 238
239 $ vi*m :== mcr VIM:VIM.EXE 239 $ vi*m :== mcr VIM:VIM.EXE
240 $ gv*im:== spawn/nowait/input=NLA0 mcr VIM:VIM.EXE -g -GEOMETRY 80x40 240 $ gv*im:== spawn/nowait/input=NLA0 mcr VIM:VIM.EXE -g -GEOMETRY 80x40
241 241
242 242
394 It is possible to use Vim as an internode editor. 394 It is possible to use Vim as an internode editor.
395 1. Edit some file from remote node: > 395 1. Edit some file from remote node: >
396 396
397 vi "<server>""username passwd""::<device>:<path><filename>;<version>" 397 vi "<server>""username passwd""::<device>:<path><filename>;<version>"
398 398
399 example: > 399 Example: >
400 vi "pluto""zay passwd""::RF10:<USER.ZAY.WORK>TEST.C;1" 400 vi "pluto""zay passwd""::RF10:<USER.ZAY.WORK>TEST.C;1"
401 401
402 Note: syntax is very important, otherwise VMS will recognize more parameters 402 Note: syntax is very important, otherwise VMS will recognize more parameters
403 instead of one (resulting with: file not found) 403 instead of one (resulting with: file not found)
404 404
416 $ write sys$output " Please enter username and password as a parameter." 416 $ write sys$output " Please enter username and password as a parameter."
417 $ write sys$output " Example: @SETVIM.COM username passwd" 417 $ write sys$output " Example: @SETVIM.COM username passwd"
418 $ end: 418 $ end:
419 419
420 Note: Never use it in a clustered environment (you do not need it), loading 420 Note: Never use it in a clustered environment (you do not need it), loading
421 could be very-very slow, but even faster then a local Emacs. :-) 421 could be very-very slow, but even faster than a local Emacs. :-)
422 422
423 (Zoltan Arpadffy, Vim 5.6) 423 (Zoltan Arpadffy, Vim 5.6)
424 424
425 425
426 8.6 Terminal problems 426 8.6 Terminal problems
573 ( Zoltan Arpadffy, Vim 6.1) 573 ( Zoltan Arpadffy, Vim 6.1)
574 574
575 575
576 8.12 diff-mode 576 8.12 diff-mode
577 577
578 Vim 6.0 and higher supports vim diff-mode (See |new-diff-mode|, |diff-mode| 578 Vim 6.0 and higher supports Vim diff-mode (See |new-diff-mode|, |diff-mode|
579 and |08.7|). This uses the external program 'diff' and expects a Unix-like 579 and |08.7|). This uses the external program 'diff' and expects a Unix-like
580 output format from diff. The standard VMS diff has a different output 580 output format from diff. The standard VMS diff has a different output
581 format. To use vim on VMS in diff-mode, you need to: 581 format. To use Vim on VMS in diff-mode, you need to:
582 1 Install a Unix-like diff program, e.g. GNU diff 582 1 Install a Unix-like diff program, e.g. GNU diff
583 2 Tell vim to use the Unix-like diff for diff-mode. 583 2 Tell Vim to use the Unix-like diff for diff-mode.
584 584
585 You can download GNU diff from the VIM-VMS website, it is one of the GNU 585 You can download GNU diff from the VIM-VMS website, it is one of the GNU
586 tools in http://www.polarhome.com/vim/files/gnu_tools.zip. I suggest to 586 tools in http://www.polarhome.com/vim/files/gnu_tools.zip. I suggest to
587 unpack it in a separate directory "GNU" and create a logical GNU: that 587 unpack it in a separate directory "GNU" and create a logical GNU: that
588 points to that directory, e.g: > 588 points to that directory, e.g: >
592 You may also want to define a symbol GDIFF, to use the GNU diff from the DCL 592 You may also want to define a symbol GDIFF, to use the GNU diff from the DCL
593 prompt: > 593 prompt: >
594 594
595 GDIFF :== $GNU:DIFF.EXE 595 GDIFF :== $GNU:DIFF.EXE
596 596
597 Now you need to tell vim to use the new diff program. Take the example 597 Now you need to tell Vim to use the new diff program. Take the example
598 settings from |diff-diffexpr| and change the call to the external diff 598 settings from |diff-diffexpr| and change the call to the external diff
599 program to the new diff on VMS. Add this to your .vimrc file: > 599 program to the new diff on VMS. Add this to your .vimrc file: >
600 600
601 " Set up vimdiff options 601 " Set up vimdiff options
602 if v:version >= 600 602 if v:version >= 600
613 silent execute "!mc GNU:diff.exe -a " . opt . v:fname_in . " " . v:fname_new . 613 silent execute "!mc GNU:diff.exe -a " . opt . v:fname_in . " " . v:fname_new .
614 \ " > " . v:fname_out 614 \ " > " . v:fname_out
615 endfunction 615 endfunction
616 endif 616 endif
617 617
618 You can now use vim in diff-mode, e.g. to compare two files in read-only 618 You can now use Vim in diff-mode, e.g. to compare two files in read-only
619 mode: > 619 mode: >
620 620
621 $ VIM -D/R <FILE1> <FILE2> 621 $ VIM -D/R <FILE1> <FILE2>
622 622
623 You can also define new symbols for vimdiff, e.g.: > 623 You can also define new symbols for vimdiff, e.g.: >
636 636
637 637
638 8.13 Allow '$' in C keywords 638 8.13 Allow '$' in C keywords
639 639
640 DEC C uses many identifiers with '$' in them. This is not allowed in ANSI C, 640 DEC C uses many identifiers with '$' in them. This is not allowed in ANSI C,
641 and vim recognises the '$' as the end of the identifier. You can change this 641 and Vim recognises the '$' as the end of the identifier. You can change this
642 with the |iskeyword|command. 642 with the |iskeyword|command.
643 Add this command to your .vimrc file: > 643 Add this command to your .vimrc file: >
644 644
645 autocmd FileType c,cpp,cs set iskeyword+=$ 645 autocmd FileType c,cpp,cs set iskeyword+=$
646 646
665 665
666 (Thomas.R.Wyant III, Vim 6.1) 666 (Thomas.R.Wyant III, Vim 6.1)
667 667
668 8.14 Slow start in console mode issue 668 8.14 Slow start in console mode issue
669 669
670 As GUI/GTK Vim works equally well in console mode, many administartors 670 As GUI/GTK Vim works equally well in console mode, many administrators
671 deploy those executables system wide. 671 deploy those executables system wide.
672 Unfortunately, on a remote slow connections GUI/GTK executables behave rather 672 Unfortunately, on a remote slow connections GUI/GTK executables behave rather
673 slow when user wants to run Vim just in the console mode - because of X environment detection timeout. 673 slow when user wants to run Vim just in the console mode - because of X environment detection timeout.
674 674
675 Luckily, there is a simple solution for that. Administrators need to deploy 675 Luckily, there is a simple solution for that. Administrators need to deploy
678 |- vim72 678 |- vim72
679 |----- doc 679 |----- doc
680 |----- syntax 680 |----- syntax
681 vimrc (system rc files) 681 vimrc (system rc files)
682 gvimrc 682 gvimrc
683 gvim.exe (the remaned GUI or GTK built vim.exe) 683 gvim.exe (the renamed GUI or GTK built vim.exe)
684 vim.exe (the console only executable) 684 vim.exe (the console only executable)
685 685
686 Define system symbols like below in for ex in LOGIN.COM or SYLOGIN.COM: > 686 Define system symbols like below in for ex in LOGIN.COM or SYLOGIN.COM: >
687 687
688 $ define/nolog VIM RF10:[UTIL.VIM72] ! where you VIM directory is 688 $ define/nolog VIM RF10:[UTIL.VIM72] ! where you VIM directory is
711 ¦ TOR ¦ VMS V7.3-2 ¦ MEMBER ¦ 711 ¦ TOR ¦ VMS V7.3-2 ¦ MEMBER ¦
712 ¦ TITAN2 ¦ VMS V8.3 ¦ MEMBER ¦ 712 ¦ TITAN2 ¦ VMS V8.3 ¦ MEMBER ¦
713 ¦ ODIN ¦ VMS V7.3-2 ¦ MEMBER ¦ 713 ¦ ODIN ¦ VMS V7.3-2 ¦ MEMBER ¦
714 +---------------------------------+ 714 +---------------------------------+
715 715
716 It is convinient to have a common VIM directory but execute different 716 It is convenient to have a common VIM directory but execute different
717 executables. 717 executables.
718 There are more solutions for this problem: 718 There are more solutions for this problem:
719 719
720 solution 1. all executables in the same directory with different names 720 Solution 1. All executables in the same directory with different names
721 This is easily done with the following script that can be added 721 This is easily done with the following script that can be added
722 to the login.com or sylogin.com: > 722 to the login.com or sylogin.com: >
723 723
724 $ if f$getsyi("NODE_HWTYPE") .eqs. "VAX" 724 $ if f$getsyi("NODE_HWTYPE") .eqs. "VAX"
725 $ then 725 $ then
735 $ then 735 $ then
736 $ say "IA64 platform" 736 $ say "IA64 platform"
737 $ vi*m :== mcr vim:VIM.EXE_IA64 737 $ vi*m :== mcr vim:VIM.EXE_IA64
738 $ endif 738 $ endif
739 739
740 solution 2. different directories: > 740 Solution 2. Different directories: >
741 741
742 $ if f$getsyi("NODE_HWTYPE") .eqs. "VAX" 742 $ if f$getsyi("NODE_HWTYPE") .eqs. "VAX"
743 $ then 743 $ then
744 $ say "VAX platform" 744 $ say "VAX platform"
745 $ define/nolog VIM RF10:[UTIL.VAX_EXE] ! VAX executables 745 $ define/nolog VIM RF10:[UTIL.VAX_EXE] ! VAX executables
755 $ define/nolog VIM RF10:[UTIL.IA64_EXE] ! IA64 executables 755 $ define/nolog VIM RF10:[UTIL.IA64_EXE] ! IA64 executables
756 $ endif 756 $ endif
757 $! VIMRUNTIME must be defined in order to find runtime files 757 $! VIMRUNTIME must be defined in order to find runtime files
758 $ define/nolog VIMRUNTIME RF10:[UTIL.VIM72] 758 $ define/nolog VIMRUNTIME RF10:[UTIL.VIM72]
759 759
760 A good examle for this approach is the [GNU]gnu_tools.com script from GNU_TOOLS.ZIP 760 A good example for this approach is the [GNU]gnu_tools.com script from
761 package downloadable from http://www.polarhome.com/vim/ 761 GNU_TOOLS.ZIP package downloadable from http://www.polarhome.com/vim/
762 762
763 (Zoltan Arpadffy, Vim 7.2) 763 (Zoltan Arpadffy, Vim 7.2)
764 764
765 ============================================================================== 765 ==============================================================================
766 766