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


Versions:

- 0.1.0:
   + initial version

- 0.1.1:
   + fix compile&run where run was executed even if there were compile errors.

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                 1328    3259  40.7% -lh5- aa16 Jan  1  2018 CubicIDE-FreePascal/add-ons/pascal/etc/explorer.config
[unknown]                 1081    2994  36.1% -lh5- 6daa Nov 25 21:01 CubicIDE-FreePascal/add-ons/pascal/scripts/fpc_wrapper.rexx
[unknown]                   72      99  72.7% -lh5- 689b Mar  1  2018 CubicIDE-FreePascal/add-ons/pascal/syntax/dictionaries/commands
[unknown]                   10      10 100.0% -lh0- adbe Mar  2  2018 CubicIDE-FreePascal/add-ons/pascal/syntax/dictionaries/functions
[unknown]                 3625   11903  30.5% -lh5- 3b92 Sep 20  2012 CubicIDE-FreePascal/add-ons/pascal/syntax/dictionaries/mos-functions
[unknown]                 6548   20175  32.5% -lh5- 46b7 Sep 20  2012 CubicIDE-FreePascal/add-ons/pascal/syntax/dictionaries/os3-functions
[unknown]                   48      55  87.3% -lh5- 87f0 Mar  2  2018 CubicIDE-FreePascal/add-ons/pascal/syntax/dictionaries/qualifier
[unknown]                   56      57  98.2% -lh5- d3f6 Jan 13  2017 CubicIDE-FreePascal/add-ons/pascal/syntax/HelloWorld.pas
[unknown]                 1412    3150  44.8% -lh5- 615c Nov 29 20:23 CubicIDE-FreePascal/addon.readme
[unknown]                16797  149974  11.2% -lh5- da22 Mar  7  2018 CubicIDE-FreePascal/CubicIDE_Pascal_1.ilbm
[unknown]                22864  199742  11.4% -lh5- b71d Mar  7  2018 CubicIDE-FreePascal/CubicIDE_Pascal_2.ilbm
[unknown]                  272     512  53.1% -lh5- a50c Mar  6  2018 CubicIDE-FreePascal/etc/registry/presets/pascal.api
[unknown]                  255     557  45.8% -lh5- 3169 Mar  6  2018 CubicIDE-FreePascal/etc/registry/presets/pascal.gadgets
[unknown]                14648   44927  32.6% -lh5- 0133 Mar  6  2018 CubicIDE-FreePascal/etc/registry/presets/pascal.syntax
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        14 files   69016  437414  15.8%            Dec  5 23:55