Installation of the ACE CubicIDE plugin.

The plugin offers the following functionality:
- syntax highlighting based on the standard "generic.parser" provided by
  Cubic-IDE
- quick navigation of ACE sources files ('.b' or '.bas') in the right
  sidebar
- toolbar commands for 'compile', 'compile&run', 'compile submod' and
  only 'run'

To install the plugin, copy the folders (etc, add-ons) in thew archive to
your CubicIDE installation into the assign 'golded:'.
This folder should already contain those folders.
The folder 'etc' and 'add-ons' in this archive only contain files related
to the AmigaE plugin and should not clash with any existing files.
But to make sure you should make backups of those folders.

When this is done you should start, or re-start CubicIDE.

When you open a ACE source file (.b) you should see the explorer in the
right sidebar and the toolbar buttons.
Also the source code should be syntax highlighted.
If it is not, make sure the syntax highlighting setting is attached to the
ACE plugin settings.
To check this:
- open the Cubic configuration (main menu "Extras"->"Customize...")
- there, open the "Filetypes" tab
- select and open the "ACE" type
- select "Settings" ("Einstellungen")

If there is no entry for "Colorcoding" ("Farbkodierung") you have to add
it:
- select "Settings" entry and click the "+" sign at the bottom toolbar
- in the next window select and open the entry for "Colorcoding"
  ("Farbkodierung")
- there choose the "amigae.syntax" entry
- comfirm by pressing "OK"
- back in the previous window, select "Save" ("Speichern")

Syntax highlighting should work now.


Some notes about compiling and a ACE installation.
The compiling script (ace:bin/bas), which is called from the toolbar
buttons, expects an ACE installation and ACE assigns.

More notes about the compilation process using the ace_wrapper script.
The script extracts the output name from the source file.
A source file named "foobar.b" produces an executable called "foobar".
This is a predefined process in order to allow to "run" the binary without
having specified the name of the executable.
However, it is possible to change the executable name if desired.

The plugin allows to develop with linking submod.
In order to know which submod .o files to link with one can specify:
REM #using <path-to-submod.o>

If installation went well it looks like in the screenshot.



Cheers


Versions:

- 0.1.0:
   + initial version

- 0.1.1:
   + don't run if compile failed

- 0.2:
   + use ace-basic's bas script for the heavy lifting

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                    749    1568  47.8% -lh5- 0205 Jan 27 19:30 CubicIDE-ACE/add-ons/ace/autocase/basic
[Amiga]                   1416    3738  37.9% -lh5- 10b6 Apr  2  2025 CubicIDE-ACE/add-ons/ace/etc/explorer.config
[Amiga]                   8663   21943  39.5% -lh5- 6d99 Jan 28 08:59 CubicIDE-ACE/add-ons/ace/quickinfo/ace.words
[Amiga]                   1353    3731  36.3% -lh5- 4d3a Feb  2 21:15 CubicIDE-ACE/add-ons/ace/scripts/ace_wrapper.rexx
[Amiga]                   5737   11484  50.0% -lh5- 6af8 May 11  2024 CubicIDE-ACE/add-ons/ace/syntax/basic.parser
[Amiga]                    542    1157  46.8% -lh5- 2a13 Jan 27 19:30 CubicIDE-ACE/add-ons/ace/syntax/dictionaries/commands
[Amiga]                    237     434  54.6% -lh5- 2e72 Jan 27 19:30 CubicIDE-ACE/add-ons/ace/syntax/dictionaries/functions
[Amiga]                     27      27 100.0% -lh0- 924d May 11  2024 CubicIDE-ACE/add-ons/ace/syntax/dictionaries/logical
[Amiga]                     44      50  88.0% -lh5- 9bea May 24  2024 CubicIDE-ACE/add-ons/ace/syntax/dictionaries/operators
[Amiga]                     92      96  95.8% -lh5- 8700 May 11  2024 CubicIDE-ACE/add-ons/ace/syntax/sample.b
[Amiga]                   1318    2785  47.3% -lh5- 07f1 Feb  3 15:38 CubicIDE-ACE/cubicide-ace.readme
[Amiga]                    266     515  51.7% -lh5- c6f9 Jan 28 08:59 CubicIDE-ACE/etc/registry/presets/ace.api
[Amiga]                   1147    2660  43.1% -lh5- 67bb Jan 28 08:59 CubicIDE-ACE/etc/registry/presets/ace.dictionary
[Amiga]                    421    1253  33.6% -lh5- 8a06 Feb  2 21:15 CubicIDE-ACE/etc/registry/presets/ace.gadgets
[Amiga]                     68      98  69.4% -lh5- e886 May 11  2024 CubicIDE-ACE/etc/registry/presets/ace.structure
[Amiga]                   1939    5020  38.6% -lh5- b333 Jan 28 08:59 CubicIDE-ACE/etc/registry/presets/ace.syntax
[Amiga]                    113     174  64.9% -lh5- 62c5 Jan 28 08:59 CubicIDE-ACE/etc/registry/presets/ace.tabs
[Amiga]                  23413  193060  12.1% -lh5- eadf Feb  3 15:35 CubicIDE-ACE/screenshot.ilbm
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        18 files   47545  249793  19.0%            Feb  3 23:44