share/vim/vim74/doc/os_amiga.txt

   1 *os_amiga.txt*  For Vim version 7.4.  Last change: 2010 Aug 14
   2
   3
   4                   VIM REFERENCE MANUAL    by Bram Moolenaar
   5
   6
   7                                                         *Amiga*
   8 This file contains the particularities for the Amiga version of Vim.
   9 There is also a section specifically for |MorphOS| below.
  10
  11 NOTE: The Amiga code is still included, but has not been maintained or tested.
  12
  13 Installation 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
  25 If you have sufficient memory you can avoid startup delays by making Vim and
  26 csh 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
  28 version 0.5.
  29
  30 If you do not use digraphs, you can save some memory by recompiling without
  31 the |+digraphs| feature.  If you want to use Vim with other terminals you can
  32 recompile with the TERMCAP option.  Vim compiles with Manx 5.x and SAS 6.x.
  33 See the makefiles and feature.h.
  34
  35 If you notice Vim crashes on some files when syntax highlighting is on, or
  36 when using a search pattern with nested wildcards, it might be that the stack
  37 is too small.  Try increasing the stack size.  In a shell use the Stack
  38 command before launching Vim.  On the Workbench, select the Vim icon, use the
  39 workbench "Info" menu and change the Stack field in the form.
  40
  41 If 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
  52 Standard ANSI escape sequences are used.  The codes are:
  53 30 grey char   40 grey cell   >0 grey background    0 all attributes off
  54 31 black char  41 black cell  >1 black background   1 boldface
  55 32 white char  42 white cell  >2 white background   2 faint
  56 33 blue char   43 blue cell   >3 blue background    3 italic
  57 34 grey char   44 grey cell   >4 grey background    4 underscore
  58 35 black char  45 black cell  >5 black background   7 reverse video
  59 36 white char  46 white cell  >6 white background   8 invisible
  60 37 blue char   47 blue cell   >7 blue background
  61
  62 The codes with '>' must be the last.  The cell and background color should be
  63 the same.  The codes can be combined by separating them with a semicolon.  For
  64 example 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
  75 When using multiple commands with a filter command, e.g. >
  76   :r! echo this; echo that
  77 Only the output of the last command is used.  To fix this you have to group the
  78 commands.  This depends on the shell you use (that is why it is not done
  79 automatically in Vim).  Examples: >
  80   :r! (echo this; echo that)
  81   :r! {echo this; echo that}
  82
  83 Commands that accept a single file name allow for embedded spaces in the file
  84 name.  However, when using commands that accept several file names, embedded
  85 spaces need to be escaped with a backslash.
  86
  87 ------------------------------------------------------------------------------
  88 Vim for MorphOS                                                 *MorphOS*
  89
  90 [this section mostly by Ali Akcaagac]
  91
  92 For the latest info about the MorphOS version:
  93         http://www.akcaagac.com/index_vim.html
  94
  95
  96 Problems ~
  97
  98 There are a couple of problems which are not MorphOS related but more Vim and
  99 UN*X related.  When starting up Vim in ram: it complains with a nag requester
 100 from MorphOS please simply ignore it.  Another problem is when running Vim as
 101 is some plugins will cause a few problems which you can ignore as well.
 102 Hopefully someone will be fixing it over the time.
 103
 104 To pass all these problems for now you can either run:
 105
 106         vim <file to be edited>
 107
 108 or if you want to run Vim plain and enjoy the motion of Helpfiles etc. it then
 109 would be better to enter:
 110
 111         vim --noplugins <of course you can add a file>
 112
 113
 114 Installation ~
 115
 116 1) Please copy the binary 'VIM' file to c:
 117 2) 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
 126 3) 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
 133 4) Copy the '.vimrc' file to s:
 134
 135 5) 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: