{DANSK > ENGLISH with manual correction, modification}
{Editing by www.lived.ch, Misel Zivanovic, 2025}


AmigaCOMAL version 2.03.
==========================

Compared to previous versions of AmigaCOMAL, version 2.03 has a number of
important changes and additions.


THESE INCLUDE:

     - more installation options

     - change of the meaning of certain special keys

     - greatly improved editing facilities

     - addition of a "file requester"

     - option to choose whether a SAVE file should have an icon

     - names in a COMAL package can be exported under a different name

     - greatly improved graphics and turtle packages


The following describes all the changes except for the new graphics and 
turtle packages, which are described in the special "ReadMe" 
file Graphics.doc.



1. INSTALLATION.
=================

A number of new features have been added to the installation program:

     1. Previously, the Execute window remained in the foreground when 
        a program stopped. This could often be inconvenient, as you were
        not always aware that a program had stopped. Now you can choose
        whether the command window should be automatically brought to 
        the foreground when a program stops.

     2. You can now choose whether AmigaCOMAL should start in insert or
        overwrite mode.

     3. As before, you can switch between insert and overwrite modes using
        the <INS> key, but in the installation program you can now also 
        choose whether you should stay in the current writing mode or 
        whether you should switch to the one selected in point 2 after
        <CR> or <ESC>.

     4. You can choose whether an icon should be automatically created every
        time a program is saved using the SAVE command. However, the 
        selection made can always be overridden with the new SAVE parameters
       (see below).

The installation program is equipped with an ON LINE help function, which is
triggered by pressing the <HELP> key.

The values ​​you choose during installation are saved as before in a file named AmigaCOMAL.Preferences (unless otherwise selected). When AmigaCOMAL itself is
started, this file is searched for. The directories in which it is searched 
have been slightly changed compared to what is specified in the manual. 

Now the following directories are searched (in the order mentioned):

     1. The current directory
     2. The directory in which AmigaCOMAL itself is located
     3. DEVS:



2. NEW KEYBOARD LAYOUT.
========================

To bring the use of the keyboard more in line with other Amiga programs, 
the meaning of some special keys has been changed, and new key functions
have been added.

Below is a brief description of the new key functions:

     <SHIFT> + <RIGHT ARROW>  Move cursor to end of line.
     <SHIFT> + <LEFT ARROW>   Move cursor to start of line.
     <SHIFT> + <UP ARROW>     Move cursor to top of window.

If the cursor is already at the top or of the window, and there is a program
line at the top of the window, the entire <PGUP> previous program page is
displayed.

     <SHIFT> + <DOWN ARROW>   Move cursor to bottom of window.

If the cursor is already at the bottom or of the window, and there is a
program line at the bottom of the window, the entire <PGDN> next program page
is displayed.


     <ALT> + <UP ARROW>       Show the first page of the program or <HOME>

     <ALT> + <DOWN ARROW>     Show the last page of the program or <END>

     <INS>                    Switch between overwrite and insert mode.

     <ALT> + <DEL>            Delete line.

     <ALT> + <INS>            Insert line.


NOTE: 
The <PGUP>, <PGDN>, <HOME>, <END> and <INS> keys are located on the 
numeric keypad and that you need to press <SHIFT> to use them.



3. THE EDIT COMMAND.
====================

When you issue the command EDIT, the entire first program page is listed on 
the screen, and you are put into edit mode.

In edit mode, a program line will be checked for syntax errors and placed in 
the program memory each time you leave a line 
(just like when you press <ENTER>). <ALT>+<INS> inserts a new line with the 
appropriate line number between the surrounding lines, and the new line is 
immediately placed in the program memory. Similarly, <ALT>+<DEL> will delete
the cursor line both on the screen and in the program memory.

In short: When you are in edit mode, the lines that are on the screen will be
the same as those that are in the program memory.



4. NEW SAVE PARAMETERS.
=======================

When issuing the SAVE command, you can decide whether to create an icon for 
the program being saved.

With the command:

     SAVE "name",i

an icon will always be created; even if you have
installed the program not to create an icon automatically. 
In contrast to this, the command:

     SAVE "name",n

will NOT create an icon!
(again, regardless of what you have installed AmigaCOMAL for).

The usual command:

     SAVE "name"

on the other hand will only create an icon if you have installed COMAL to 
create an icon automatically.



5. NEW "FILE REQUESTER".
=========================

AmigaCOMAL ver. 2.03 is equipped with a new 'file-requester' with a wide
range of facilities.

This file-requester is operated using the mouse. For the ordinary Amiga 
user it should not require any further explanation.

The file-requester is put into operation by writing the commands SAVE and
LOAD without a name or by writing the commands ENTER and LIST with the 
empty text as parameter, e.g.

     LIST ""



6. NEW EXPORT FACILITY IN COMAL PACKAGES.
===========================================

When exporting a name in a COMAL package, you can now export the name under
a different name.

Example:

     EXPORT alfa() AS beta

     EXPORT fd(), fd() AS forward // EXPORT under two names

The new Turtle package provides a number of examples of the use of this new
facility, which provides access to unimaginable application possibilities.


7. NEW COMAL PACKAGE EXTENSION.
==============================

To better distinguish between COMAL packages and machine-coded packages when
using a DIR command, COMAL packages are now provided with the type "cmp", 
e.g. Turtle.cmp and System.cmp, while the machine-coded packages still have 
the old type "pck".

The USE command/statement

     USE name

will now search for the following files until it finds one:

     name.cmp
     Packages/name.cmp
     name.pck
     Packages/name.pck

where "Packages" is the path you chose during installation.



8. NEW PACKAGES.
==============

In addition to the packages mentioned in the manual, there are the following
new packages:

     POTGO_LIBRARY

A machine coded package that interfaces to the Amiga's Potgo routines.

     IFF_LIBRARY

A machine coded package that interfaces to a public domain library
"IFF.library" that ships with AmigaCOMAL.



9. Other.
=========

In the REPORT statement, you can now specify a text, for example:

     REPORT 899,"A bad error!"

If no error text is found for the specified error number, the specified text
will be selected.

In text constants, codes can be specified as numbers by writing a quotation 
mark before the number, for example:

     PRINT "Uha!"7" // Blink the screen
