GitLab

Also strip dependencies in `!MkClean` now that we create some, and set up
`.gitignore` appropriately.

Requires RiscOS/BuildSys!32

This prevents Squish from outputting an initial line containing `REM>` and
the output filename - in other words, the default pathname for the `SAVE`
statement. This is useful for a number of reasons:

* It is arguably a waste of space, since a Squished version of a program
  should ideally never be hand-edited.

* The output pathname used in ROM builds bears no relationship to anything
  on the target device (currently, the installed version of the Alarm and
  Chars programs both start with `REM>Resources.!RunImage` which relates to
  the layout of the source component directory tree).

* It is desirable for cross-compilation and native builds to be binary
  identical, so having a host pathname embedded in the output is unhelpful.
  We could have added an option to override the pathname used, to ensure
  consistency, but it's easier simply to omit the relevant line.

Detail:
* Detect interpreter by scanning `REPORT$` on entry
* When running on Brandy:
  + Memory allocation is done using `DIM` instead of assembler
  + Token lookup is achieved using hard-coded `DATA` statements rather than
    calling the interpreter
  + Linked-list assembly code reimplemented in BASIC
  + Arguments are fetched from `ARGV$()` rather than SWI `OS_GetEnv`
  + Whole-file operations are achieved using repeated `BGET` or `BPUT` due to
    absence of any portable method
  + Numbers are parsed from `swis.h` using `EVAL` rather than SWI
    `OS_ReadUnsigned`

Admin:
  Requires Matrix Brandy 1.22.9 or later

Also correct the comments describing the meaning of `adr` and `fadr`

When the `-literal` switch was not given, one `IF` statement would attempt to
evaluate `PTR#0` (i.e. the pointer of an invalid file handle). This is
reported as an error when running under Brandy BASIC.

The source code had erroneous space characters before the `#` character. This
was removed during the `CRUNCH` that happened during the build process, but
this meant that the behaviour of the raw source code could not be compared
because it could not be run.

In the process of unrelated archiving an unsquished copy of Squish from 1989 was unearthed, allowing many of the variable names to be made meaningful after the sources were lost. Also created a document detailing operation from a large block comment.
Tested by comparing the output with Squish 1.15 from several heavyweight uses, eg. Alarm HForm Chars.

Version 1.16. Tagged as 'Squish-1_16'

Squish will now make a list of SWI names from CLib:h.swis (or some override header file provided by the -SYSFROM switch) before falling back to using OS_SWINumberFromString. This avoids the need to have all the modules in the world loaded when squishing a BASIC program.

Version 1.15. Tagged as 'Squish-1_15'

Use things from StdTools where possible.
Bumped the version number string up by hand.

Version 1.14. Tagged as 'Squish-1_14'

Detail:
  This is some reconstructed sources for the Squish tool, formed by running the 1.12 binary through Beebug's/ProAction's !BasFormat, and then fixing up a few extra bits by hand.
  Most of FNs and PROCs have had meaningful names applied to them, making the sources more readable. However only a couple of the variables have been renamed.
  The test script (Test/Squish,feb) was used to verify that this new squish (after being re-squished) produces identical output to the original binary.
  Note that squishing these sources won't produce a binary identical to the original, as the original appears to have been modified post-squishing in order to add PROCknockoutkept.
Admin:
  Tested against original Squish binary for Disc & BCM2835 builds
  Version number is currently hardcoded in sources; build procedure needs updating to take it from VersionNum


Version 1.13. Tagged as 'Squish-1_13'