annotate runtime/doc/os_amiga.txt @ 11:4424b47a0797

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