vim

Fork of vim, an acceptable text editor
git clone git://git.laack.co/vim.git
Log | Files | Refs | README | LICENSE

os_amiga.txt (5763B)


      1 *os_amiga.txt*	For Vim version 9.2.  Last change: 2026 Feb 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
     78 the 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 	(dead link) 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 of a binary archive ~
    115 
    116 1) Please copy the binary 'VIM' file to c:
    117 2) Get the Vim runtime package from (Note: that server is no longer updated):
    118 
    119 	https://ftp.nluug.nl/pub/vim/amiga/vim90src.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 Compiling~
    147 
    148 You can download the Vim source code from the official Vim site:
    149 	https://github.com/vim/vim/archive/refs/heads/master.zip
    150 Or using git: >
    151 	git clone https://github.com/vim/vim.git
    152 
    153 For compiling see "src/INSTALLami.txt"
    154 
    155  vim:tw=78:ts=8:noet:ft=help:norl: