Installation of the FreePascal Cubic-IDE plugin.

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

To install the plugin, copy the folders (etc, add-ons) in thew archive to your
Cubic-IDE 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
Pascal 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 Cubic-IDE.

When you open a Pascal source file (.pas) 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
Pascal plugin settings.
To check this:
- open the Cubic configuration (main menu "Extras"->"Customize...")
- there, open the "Filetypes" tab
- select and open the "Pascal" type
- select "Settings" ("Einstellungen")
(see screenshot "CubicIDE_Pascal_2.ilbm")

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 "Pascal.syntax" entry
- comfirm by pressing "OK"
(see screenshot: "CubicIDE_Pascal_1.ilbm")
- back in the previous window, select "Save" ("Speichern")

Syntax highlighting should work now.


Some notes about compiling and your FreePascal installation.
The compiling script, which is called from the toolbar buttons, expects a
"FreePascal:" assign to find the FreePascal compiler (fpc).
You may have to check the script (fpc_wrapper.rexx) and modify the "FPC"
variable near the top of the script to match
your Free Pascal installation.
This script also works on MorphOS when this FPC variable was configured
appropriately.

More notes about the compilation process using the fpc_wrapper script.
The script extracts the output name from the source file.
A source file named "foobar.pas" 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.
After the first compile the script will generate a ".fpcout-foobar" file within
the folder where your source file resides.
The content of this file is actually the output file and can be changed.



Cheers

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                 1328    3259  40.7% -lh5- aa16 Jan  1  2018 CubicIDE-FreePascal-0.1.0/add-ons/pascal/etc/explorer.config
[unknown]                 1063    2969  35.8% -lh5- 892f Mar  7  2018 CubicIDE-FreePascal-0.1.0/add-ons/pascal/scripts/fpc_wrapper.rexx
[unknown]                   72      99  72.7% -lh5- 689b Mar  1  2018 CubicIDE-FreePascal-0.1.0/add-ons/pascal/syntax/dictionaries/commands
[unknown]                   10      10 100.0% -lh0- adbe Mar  2  2018 CubicIDE-FreePascal-0.1.0/add-ons/pascal/syntax/dictionaries/functions
[unknown]                 3625   11903  30.5% -lh5- 3b92 Sep 20  2012 CubicIDE-FreePascal-0.1.0/add-ons/pascal/syntax/dictionaries/mos-functions
[unknown]                 6548   20175  32.5% -lh5- 46b7 Sep 20  2012 CubicIDE-FreePascal-0.1.0/add-ons/pascal/syntax/dictionaries/os3-functions
[unknown]                   48      55  87.3% -lh5- 87f0 Mar  2  2018 CubicIDE-FreePascal-0.1.0/add-ons/pascal/syntax/dictionaries/qualifier
[unknown]                   56      57  98.2% -lh5- d3f6 Jan 13  2017 CubicIDE-FreePascal-0.1.0/add-ons/pascal/syntax/HelloWorld.pas
[unknown]                 1330    2952  45.1% -lh5- 4e99 Oct 27 11:20 CubicIDE-FreePascal-0.1.0/addon.readme
[unknown]                16797  149974  11.2% -lh5- da22 Mar  7  2018 CubicIDE-FreePascal-0.1.0/CubicIDE_Pascal_1.ilbm
[unknown]                22864  199742  11.4% -lh5- b71d Mar  7  2018 CubicIDE-FreePascal-0.1.0/CubicIDE_Pascal_2.ilbm
[unknown]                  272     512  53.1% -lh5- a50c Mar  6  2018 CubicIDE-FreePascal-0.1.0/etc/registry/presets/pascal.api
[unknown]                  255     557  45.8% -lh5- 3169 Mar  6  2018 CubicIDE-FreePascal-0.1.0/etc/registry/presets/pascal.gadgets
[unknown]                14648   44927  32.6% -lh5- 0133 Mar  6  2018 CubicIDE-FreePascal-0.1.0/etc/registry/presets/pascal.syntax
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        14 files   68916  437191  15.8%            Oct 28 21:41