runtime/doc/os_amiga.txt

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