vim: runtime/doc/os_vms.txt comparison

comparison runtime/doc/os_vms.txt @ 3082:3502a7f991fc

Updated runtime files.

author	Bram Moolenaar <bram@vim.org>
date	Wed, 14 Sep 2011 17:55:08 +0200
parents	e8a482a7fa6c
children	6ec6b7ff2d43

comparison

equal deleted inserted replaced

-:1e50bdaa24f8
+:3502a7f991fc
-*os_vms.txt*    For Vim version 7.3.  Last change: 2010 Aug 16
+*os_vms.txt*    For Vim version 7.3.  Last change: 2011 Aug 14
 		  VIM REFERENCE MANUAL
 You can download the Vim source code by ftp from the official Vim site:
 	ftp://ftp.vim.org/pub/vim/
 Or use one of the mirrors:
 	ftp://ftp.vim.org/pub/vim/MIRRORS
-You will need both the Unix and Extra archives to build vim.exe for VMS.
-For using Vim's full power you will need the runtime files as well.
 You can download precompiled executables from:
 	http://www.polarhome.com/vim/
 	ftp://ftp.polarhome.com/pub/vim/
 To use the precompiled binary version, you need one of these archives:
 ==============================================================================
 4. Problems						*vms-problems*
 The code has been tested under Open VMS 6.2 - 8.2 on Alpha, VAX and IA64
-platforms with the DEC C compiler.  It should work without bigger problems.
+platforms with the DEC C compiler.  It should work without big problems.
 If your system does not have some include libraries you can tune up in
 OS_VMS_CONF.H file.
 If you decided to build Vim with +perl, +python, etc. options, first you need
 to download OpenVMS distributions of Perl and Python.  Build and deploy the
 Also GTK, XPM library paths should be configured in MAKE_VMS.MMS
 Note: Under VAX it should work with the DEC C compiler without problems.  The
 VAX C compiler is not fully ANSI C compatible in pre-processor directives
-semantics, therefore you have to use a converter program what will do the lion
+semantics, therefore you have to use a converter program that will do the lion
 part of the job.  For detailed instructions read file INSTALLvms.txt
-MMS_VIM.EXE is build together with VIM.EXE, but for XD.EXE you should
+MMS_VIM.EXE is build together with VIM.EXE, but for XXD.EXE you should
-change to subdirectory and build it separately.
+change to a subdirectory and build it separately.
 CTAGS is not part of the Vim source distribution anymore, however the OpenVMS
 specific source might contain CTAGS source files as described above.
 You can find more information about CTAGS on VMS at
 http://www.polarhome.com/ctags/
 You may want to create .vimrc and .gvimrc files in your home directory
 (SYS$LOGIN) to overwrite default settings.
 The easiest way is just rename example files.  You may leave the menu file
 (MENU.VIM) and files vimrc and gvimrc in the original $VIM directory.  It will
-be default setup for all users, and for users it is enough just to have their
+be the default setup for all users, and for users it is enough to just have
-own additions or resetting in their home directory in files .vimrc and .gvimrc.
+their own additions or resetting in their home directory in files .vimrc and
-It should work without problems.
+.gvimrc.  It should work without problems.
 Note: Remember, system rc files (default for all users) don't have a leading
 ".".  So, system rc files are: >
 	$VIM:vimrc
 and user customized rc files are: >
 	sys$login:.vimrc
 	sys$login:.gvimrc
-You can check that everything is on the right place with the :version command.
+You can check that everything is at the right place with the :version command.
 Example LOGIN.COM: >
 	$ define/nolog VIM RF10:[UTIL.VIM]
 	$ vi*m :== mcr VIM:VIM.EXE
 	$ gv*im:== spawn/nowait/input=NLA0 mcr VIM:VIM.EXE -g -GEOMETRY 80x40
 	$ set disp/create/node=192.168.5.223/trans=tcpip
-Note: This set-up should be enough, if you are working on standalone server or
+Note: This set-up should be enough, if you are working on a standalone server or
-clustered environment, but if you want to use Vim as internode editor in
+clustered environment, but if you want to use Vim as an internode editor in
 DECNET environment, it will satisfy as well.
 You just have to define the "whole" path: >
 	$ define VIM "<server_name>[""user password""]::device:<path>"
 	$ vi*m :== "mcr VIM:VIM.EXE"
-As for example: >
+For example: >
 	$ define VIM "PLUTO::RF10:[UTIL.VIM]"
 	$ define VIM "PLUTO""ZAY mypass""::RF10:[UTIL.VIM]" ! if passwd required
 You can also use the $VIMRUNTIME logical to point to the proper version of Vim
 3) Another elegant solution is XDM if you have installed on OpenVMS box.
 It is possible to work from XDM client as from GUI console.
 4) If you are working on MS-Windows or some other non X/Window environment
 you need to set up one X server and run Vim as in point 2.
-For MS-Windows there are available free X servers as MIX , Omni X etc.,
+For MS-Windows there are available free X servers as MIX, Omni X etc.,
 as well as excellent commercial products as eXcursion or ReflectionX with
 built-in DEC support.
 Please note, that executables without GUI are slightly faster during startup
-then with enabled GUI in character mode. Therefore, if you do not use GUI
+than with enabled GUI in character mode. Therefore, if you do not use GUI
 features, it is worth to choose non GUI executables.
 ==============================================================================
 8. Useful notes						*vms-notes*
 8.10 Setting up the symbols
 8.11 diff and other GNU programs
 8.12 diff-mode
 8.13 Allow '$' in C keywords
 8.14 VIMTUTOR for beginners
 8.15 Slow start in console mode issue
 8.16 Common VIM directory - different architectures
 8.1 Backspace/delete
 There are backspace/delete key inconsistencies with VMS.
 :fixdel doesn't do the trick, but the solution is: >
 	:set nobackup	     " does not create *.*_ backup files
 	:set nowritebackup   " does not have any purpose on VMS.  It's the
 			     " default.
-Recovery is working perfect as well from the default swap file.
+Recovery is working perfectly as well from the default swap file.
 Read more with :help swapfile
 (Claude Marinier <ClaudeMarinier@xwavesolutions.com> Vim 5.5, Zoltan Arpadffy
 Vim 5.6)
 Note: You may use <,> brackets as well (device:<path>file.ext;version) as
 rf10:<user.zay.work>test.c;1
 (David Elins <delins@foliage.com>, Jerome Lauret
-<JLAURET@mail.chem.sunysb.edu> Vim 5.6 )
+<JLAURET@mail.chem.sunysb.edu> Vim 5.6)
 8.5 Remote host invocation
 It is possible to use Vim as an internode editor.
 builtin_iris-ansi
 builtin_debug
 builtin_dumb
 defaulting to 'vt320'
 ---
-The solution is to define default terminal name: >
+The solution is to define the default terminal name: >
 	$ ! unknown terminal name.  Let us use vt320 or ansi instead.
 	$ ! Note: it's case sensitive
 	$ define term "vt320"
-Terminals from VT100 to VT320 (as V300, VT220, VT200 ) do not need any extra
+Terminals from VT100 to VT320 (as V300, VT220, VT200) do not need any extra
-keyboard mappings.  They should work perfect as they are, including arrows,
+keyboard mappings.  They should work perfectly as they are, including arrows,
 Ins, Del buttons etc., except Backspace in GUI mode.  To solve it, add to
 .gvimrc: >
 	inoremap <Del> <BS>
 If you have some annoying line jumping on the screen between windows add to
 your .vimrc file: >
 	set ttyfast	" set fast terminal
-Note: if you're using Vim on remote host or through very slow connection, it's
+Note: if you're using Vim on remote host or through a very slow connection, it's
-recommended to avoid fast terminal option with: >
+recommended to avoid the fast terminal option with: >
 	set nottyfast   " set terminal to slow mode
 (Zoltan Arpadffy, Vim 5.6)
 	RUN <path>filename
 	MCR <path>filename <parameters>
 OpenVMS users always have to be aware that the Vim command :! "just" drop them
 to DCL prompt.  This feature is possible to use without any problem with all
-DCL commands, but if we want to execute some program as XXD, CTAGS, JTAGS etc.
+DCL commands, but if we want to execute some programs such as XXD, CTAGS, JTAGS,
-we're running into trouble if we follow the Vim documentation (see: help
+etc.  we're running into trouble if we follow the Vim documentation (see: help
 xxd).
 Solution: Execute with the MC command and add the full path to the executable.
 Example: Instead of :%!xxd command use: >
 SYS$PRINT to your default print queue.
 Example: >
 	$define SYS$PRINT HP5ANSI
-You can print out whole buffer or just the marked area.
+You can print out the whole buffer or just the marked area.
 More info under :help hardcopy
 (Zoltan Arpadffy, Vim 6.0c)
 8.11 diff and other GNU programs
 From 6.0 diff functionality has been implemented, but OpenVMS does not use
 GNU/Unix like diff therefore built in diff does not work.
 There is a simple solution to solve this anomaly.  Install a Unix like diff
-and Vim will work perfect in diff mode too.  You just have to redefine your
+and Vim will work perfectly in diff mode too.  You just have to redefine your
 diff program as: >
 	define /nolog diff <GNU_PATH>diff.exe
 Another, more sophisticated solution is described below (8.12 diff-mode)
-There are some other programs as patch, make etc that may cause same problems.
+There are other programs such as patch, make etc that may cause the same
-At www.polarhome.com is possible to download an GNU package for Alpha and VAX
+problems.  At www.polarhome.com is possible to download an GNU package for
-boxes that is meant to solve GNU problems on OpenVMS.
+Alpha and VAX boxes that is meant to solve GNU problems on OpenVMS.
-( Zoltan Arpadffy, Vim 6.1)
+(Zoltan Arpadffy, Vim 6.1)
 8.12 diff-mode
 Vim 6.0 and higher supports Vim diff-mode (See |new-diff-mode|, |diff-mode|
 1. VMS  diff:  $ DIFF     <FILE1> <FILE2>
 2. GNU  diff:  $ GDIFF    <FILE1> <FILE2>
 3. VIM  diff:  $ VIMDIFF  <FILE1> <FILE2>
 4. GVIM diff:  $ GVIMDIFF <FILE1> <FILE2>
-( Coen Engelbarts, Vim 6.1)
+(Coen Engelbarts, Vim 6.1)
 8.13 Allow '$' in C keywords
 DEC C uses many identifiers with '$' in them.  This is not allowed in ANSI C,
 Now word-based commands, e.g. the '*'-search-command and the CTRL-]
 tag-lookup, work on the whole identifier.  (Ctags on VMS also supports '$' in
 C keywords since ctags version 5.1.)
-( Coen Engelbarts, Vim 6.1)
+(Coen Engelbarts, Vim 6.1)
 8.14 VIMTUTOR for beginners
-It exits VIMTUTOR.COM DCL script that can help Vim beginners to learn/make
+The VIMTUTOR.COM DCL script can help Vim beginners to learn/make their first
-first steps with Vim on OpenVMS.  Depending of binary distribution you may
+steps with Vim on OpenVMS.  Depending of binary distribution you may start it
-start it with: >
+with: >
 	@vim:vimtutor
 (Thomas.R.Wyant III, Vim 6.1)
-8.14 Slow start in console mode issue
+8.16 Slow start in console mode issue
 As GUI/GTK Vim works equally well in console mode, many administrators
 deploy those executables system wide.
 Unfortunately, on a remote slow connections GUI/GTK executables behave rather
-slow when user wants to run Vim just in the console mode - because of X environment detection timeout.
+slow when user wants to run Vim just in the console mode - because of X
+environment detection timeout.
 Luckily, there is a simple solution for that. Administrators need to deploy
 both GUI/GTK build and just console build executables, like below: >
 |- vim73
 |----- doc
 |----- syntax
 vimrc    (system rc files)
 gvimrc
 gvim.exe (the renamed GUI or GTK built vim.exe)
 vim.exe  (the console only executable)
 Define system symbols like below in for ex in LOGIN.COM or SYLOGIN.COM: >
 	$ define/nolog VIM RF10:[UTIL.VIM73] ! where you VIM directory is
 	$ vi*m  :== mcr VIM:VIM.EXE
 	$ gvi*m :== mcr VIM:GVIM.EXE
 	$ ! or you can try to spawn with
 	$ gv*im :== spawn/nowait/input=NLA0 mcr VIM:GVIM.EXE -g -GEOMETRY 80x40
 Like this, users that do not have X environment and want to use Vim just in
 console mode can avoid performance problems.
 (Zoltan Arpadffy, Vim 7.2)
 8.15 Common VIM directory - different architectures
 � TITAN2 � VMS V8.3     � MEMBER  �
 � ODIN   � VMS V7.3-2   � MEMBER  �
 +---------------------------------+
 It is convenient to have a common VIM directory but execute different
 executables.
-There are more solutions for this problem:
+There are several solutions for this problem:
 Solution 1.  All executables in the same directory with different names
 This is easily done with the following script that can be added
 to the login.com or sylogin.com: >
 9. VMS related changes					*vms-changes*
 Version 7.3
 - CTAGS 5.8 included
 - VMS compile warnings fixed - floating-point overflow warning corrected on VAX
-- filepath completition corrected - too many chars were escaped in filename
+- filepath completion corrected - too many chars were escaped in filename
 and shell commands
 - the following plugins are included into VMS runtime:
 	genutils 2.4, multiselect 2.2, multvals 3.1, selectbuf 4.3,
 	bufexplorer 7.1.7, taglist 4.5
 - minor changes in vimrc (just in VMS runtime)
 - os_vms.txt updated
 Version 7.2 (2008 Aug 9)
 - VCF files write corrected
 - CTAGS 5.7 included
 - corrected make_vms.mms (on VAX gave syntax error)
 Version 7.1 (2007 Jun 15)
 - create TAGS file from menu
 Version 7 (2006 May 8)
 - Improved low level char input (affects just console mode)
 - Fixed plugin bug
 - CTAGS 5.6 included

Mercurial > vim

comparison runtime/doc/os_vms.txt @ 3082:3502a7f991fc