summaryrefslogtreecommitdiff
path: root/mnv/runtime/doc/os_amiga.txt
blob: 05752a6376533a918c16a82ba3a594108db7aeb8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
*os_amiga.txt*	For MNV version 10.0.  Last change: 2026 Feb 14


		  MNV REFERENCE MANUAL	  by Bram Moolenaar


							*Amiga*
This file contains the particularities for the Amiga version of MNV.
There is also a section specifically for |MorphOS| below.

NOTE: The Amiga code is still included, but has not been maintained or tested.

Installation on the Amiga:
- Assign "MNV:" to the directory where the MNV "doc" directory is.  MNV will
  look for the file "MNV:doc/help.txt" (for the help command).
  Setting the environment variable $MNV also works.  And the other way around:
  when $MNV used and it is not defined, "MNV:" is used.
- With DOS 1.3 or earlier: Put "arp.library" in "libs:".  MNV must have been
  compiled with the |+ARP| feature enabled.  Make sure that newcli and run are
  in "C:" (for executing external commands).
- Put a shell that accepts a command with "-c" (e.g. "Csh" from Fish disk
  624) in "c:" or in any other directory that is in your search path (for
  executing external commands).

If you have sufficient memory you can avoid startup delays by making MNV and
csh resident with the command "rez csh mnv".  You will have to put
"rezlib.library" in your "libs:" directory.  Under 2.0 you will need rez
version 0.5.

If you do not use digraphs, you can save some memory by recompiling without
the |+digraphs| feature.  If you want to use MNV with other terminals you can
recompile with the TERMCAP option.  MNV compiles with Manx 5.x and SAS 6.x.
See the makefiles and feature.h.

If you notice MNV crashes on some files when syntax highlighting is on, or
when using a search pattern with nested wildcards, it might be that the stack
is too small.  Try increasing the stack size.  In a shell use the Stack
command before launching MNV.  On the Workbench, select the MNV icon, use the
workbench "Info" menu and change the Stack field in the form.

If you want to use different colors set the termcap codes:
	t_mr (for inverted text)
	t_md (for bold text)
	t_me (for normal text after t_mr and t_md)
	t_so (for standout mode)
	t_se (for normal text after t_so)
	t_us (for underlined text)
	t_ue (for normal text after t_us)
	t_ZH (for italic text)
	t_ZR (for normal text after t_ZH)

Standard ANSI escape sequences are used.  The codes are:
30 grey char   40 grey cell   >0 grey background    0 all attributes off
31 black char  41 black cell  >1 black background   1 boldface
32 white char  42 white cell  >2 white background   2 faint
33 blue char   43 blue cell   >3 blue background    3 italic
34 grey char   44 grey cell   >4 grey background    4 underscore
35 black char  45 black cell  >5 black background   7 reverse video
36 white char  46 white cell  >6 white background   8 invisible
37 blue char   47 blue cell   >7 blue background

The codes with '>' must be the last.  The cell and background color should be
the same.  The codes can be combined by separating them with a semicolon.  For
example to get white text on a blue background: >
  :set t_me=^V<Esc>[0;32;43;>3m
  :set t_se=^V<Esc>[0;32;43;>3m
  :set t_ue=^V<Esc>[0;32;43;>3m
  :set t_ZR=^V<Esc>[0;32;43;>3m
  :set t_md=^V<Esc>[1;32;43;>3m
  :set t_mr=^V<Esc>[7;32;43;>3m
  :set t_so=^V<Esc>[0;31;43;>3m
  :set t_us=^V<Esc>[4;32;43;>3m
  :set t_ZH=^V<Esc>[3;32;43;>3m

When using multiple commands with a filter command, e.g. >
  :r! echo this; echo that
Only the output of the last command is used.  To fix this you have to group
the commands.  This depends on the shell you use (that is why it is not done
automatically in MNV).  Examples: >
  :r! (echo this; echo that)
  :r! {echo this; echo that}

Commands that accept a single file name allow for embedded spaces in the file
name.  However, when using commands that accept several file names, embedded
spaces need to be escaped with a backslash.

------------------------------------------------------------------------------
MNV for MorphOS							*MorphOS*

[this section mostly by Ali Akcaagac]

For the latest info about the MorphOS version:
	(dead link) akcaagac.com/index_mnv.html


Problems ~

There are a couple of problems which are not MorphOS related but more MNV and
UN*X related.  When starting up MNV in ram: it complains with a nag requester
from MorphOS please simply ignore it.  Another problem is when running MNV as
is some plugins will cause a few problems which you can ignore as well.
Hopefully someone will be fixing it over the time.

To pass all these problems for now you can either run:

	mnv <file to be edited>

or if you want to run MNV plain and enjoy the motion of Helpfiles etc. it then
would be better to enter:

	mnv --noplugins <of course you can add a file>


Installation of a binary archive ~

1) Please copy the binary 'MNV' file to c:
2) Get the MNV runtime package from (Note: that server is no longer updated):

	https://ftp.nluug.nl/pub/mnv/amiga/mnv90src.tgz

   and unpack it in your 'Apps' directory of the MorphOS installation.  For me
   this would create following directory hierarchy:

	MorphOS:Apps/MNV/MNV62/...

3) Add the following lines to your s:shell-startup (Important!).

	;Begin MNV
	Set MNV=MorphOS:Apps/MNV/MNV62
	Assign HOME: ""
	;End MNV

4) Copy the '.mnvrc' file to s:

5) There is also a file named 'color-sequence' included in this archive.  This
   will set the MorphOS Shell to show ANSI colors.  Please copy the file to s:
   and change the s:shell-startup to:

	;Begin MNV
	Set MNV=MorphOS:Apps/MNV/MNV62
	Assign HOME: ""
	Execute S:Color-Sequence
	Cls
	;End MNV

Compiling~

You can download the MNV source code from the official MNV site:
	https://github.com/Project-Tick/Project-Tick/archive/refs/heads/master.zip
Or using git: >
	git clone https://github.com/Project-Tick/Project-Tick.git

For compiling see "src/INSTALLami.txt"

 mnv:tw=78:ts=8:noet:ft=help:norl: