1*os_amiga.txt*  For Vim version 7.3.  Last change: 2010 Aug 14
2
3
4		  VIM REFERENCE MANUAL    by Bram Moolenaar
5
6
7							*Amiga*
8This file contains the particularities for the Amiga version of Vim.
9There is also a section specifically for |MorphOS| below.
10
11NOTE: The Amiga code is still included, but has not been maintained or tested.
12
13Installation on the Amiga:
14- Assign "VIM:" to the directory where the Vim "doc" directory is.  Vim will
15  look for the file "VIM:doc/help.txt" (for the help command).
16  Setting the environment variable $VIM also works.  And the other way around:
17  when $VIM used and it is not defined, "VIM:" is used.
18- With DOS 1.3 or earlier: Put "arp.library" in "libs:".  Vim must have been
19  compiled with the |+ARP| feature enabled.  Make sure that newcli and run are
20  in "C:" (for executing external commands).
21- Put a shell that accepts a command with "-c" (e.g. "Csh" from Fish disk
22  624) in "c:" or in any other directory that is in your search path (for
23  executing external commands).
24
25If you have sufficient memory you can avoid startup delays by making Vim and
26csh resident with the command "rez csh vim".  You will have to put
27"rezlib.library" in your "libs:" directory.  Under 2.0 you will need rez
28version 0.5.
29
30If you do not use digraphs, you can save some memory by recompiling without
31the |+digraphs| feature.  If you want to use Vim with other terminals you can
32recompile with the TERMCAP option.  Vim compiles with Manx 5.x and SAS 6.x.
33See the makefiles and feature.h.
34
35If you notice Vim crashes on some files when syntax highlighting is on, or
36when using a search pattern with nested wildcards, it might be that the stack
37is too small.  Try increasing the stack size.  In a shell use the Stack
38command before launching Vim.  On the Workbench, select the Vim icon, use the
39workbench "Info" menu and change the Stack field in the form.
40
41If you want to use different colors set the termcap codes:
42	t_mr (for inverted text)
43	t_md (for bold text)
44	t_me (for normal text after t_mr and t_md)
45	t_so (for standout mode)
46	t_se (for normal text after t_so)
47	t_us (for underlined text)
48	t_ue (for normal text after t_us)
49	t_ZH (for italic text)
50	t_ZR (for normal text after t_ZH)
51
52Standard ANSI escape sequences are used.  The codes are:
5330 grey char   40 grey cell   >0 grey background    0 all attributes off
5431 black char  41 black cell  >1 black background   1 boldface
5532 white char  42 white cell  >2 white background   2 faint
5633 blue char   43 blue cell   >3 blue background    3 italic
5734 grey char   44 grey cell   >4 grey background    4 underscore
5835 black char  45 black cell  >5 black background   7 reverse video
5936 white char  46 white cell  >6 white background   8 invisible
6037 blue char   47 blue cell   >7 blue background
61
62The codes with '>' must be the last.  The cell and background color should be
63the same.  The codes can be combined by separating them with a semicolon.  For
64example to get white text on a blue background: >
65  :set t_me=^V<Esc>[0;32;43;>3m
66  :set t_se=^V<Esc>[0;32;43;>3m
67  :set t_ue=^V<Esc>[0;32;43;>3m
68  :set t_ZR=^V<Esc>[0;32;43;>3m
69  :set t_md=^V<Esc>[1;32;43;>3m
70  :set t_mr=^V<Esc>[7;32;43;>3m
71  :set t_so=^V<Esc>[0;31;43;>3m
72  :set t_us=^V<Esc>[4;32;43;>3m
73  :set t_ZH=^V<Esc>[3;32;43;>3m
74
75When using multiple commands with a filter command, e.g. >
76  :r! echo this; echo that
77Only the output of the last command is used.  To fix this you have to group the
78commands.  This depends on the shell you use (that is why it is not done
79automatically in Vim).  Examples: >
80  :r! (echo this; echo that)
81  :r! {echo this; echo that}
82
83Commands that accept a single file name allow for embedded spaces in the file
84name.  However, when using commands that accept several file names, embedded
85spaces need to be escaped with a backslash.
86
87------------------------------------------------------------------------------
88Vim for MorphOS							*MorphOS*
89
90[this section mostly by Ali Akcaagac]
91
92For the latest info about the MorphOS version:
93	http://www.akcaagac.com/index_vim.html
94
95
96Problems ~
97
98There are a couple of problems which are not MorphOS related but more Vim and
99UN*X related.  When starting up Vim in ram: it complains with a nag requester
100from MorphOS please simply ignore it.  Another problem is when running Vim as
101is some plugins will cause a few problems which you can ignore as well.
102Hopefully someone will be fixing it over the time.
103
104To pass all these problems for now you can either run:
105
106	vim <file to be edited>
107
108or if you want to run Vim plain and enjoy the motion of Helpfiles etc. it then
109would be better to enter:
110
111	vim --noplugins <of course you can add a file>
112
113
114Installation ~
115
1161) Please copy the binary 'VIM' file to c:
1172) Get the Vim runtime package from:
118
119	ftp://ftp.vim.org/pub/vim/amiga/vim62rt.tgz
120
121   and unpack it in your 'Apps' directory of the MorphOS installation.  For me
122   this would create following directory hierarchy:
123
124	MorphOS:Apps/Vim/Vim62/...
125
1263) Add the following lines to your s:shell-startup (Important!).
127
128	;Begin VIM
129	Set VIM=MorphOS:Apps/Vim/Vim62
130	Assign HOME: ""
131	;End VIM
132
1334) Copy the '.vimrc' file to s:
134
1355) There is also a file named 'color-sequence' included in this archive.  This
136   will set the MorphOS Shell to show ANSI colors.  Please copy the file to s:
137   and change the s:shell-startup to:
138
139	;Begin VIM
140	Set VIM=MorphOS:Apps/Vim/Vim62
141	Assign HOME: ""
142	Execute S:Color-Sequence
143	Cls
144	;End VIM
145
146
147 vim:tw=78:ts=8:ft=help:norl:
148