
               ZapAsm, a Zap syntax colouring mode
               ====================================

1.0 Features
============

This module performs syntax colouring designed for Assembler documents.
It is designed to work with assemblers that act as preprocessors to the
BASIC assembler, such as JFPatch and SAsm.  It does not currently offer
support for files made with Acorn's ObjAsm assembler.  Nor does it have
anything to do with colouring assembler in BASIC files themselves.

It has bracket matching modelled after the old style C mode.

Although the author welcomes correspondence concerning this mode, he
makes no claim that it is bug-free and, it is not guaranteed to perform
any particular function.  It is to be used entirely at one's own risk.

This is Freeware, and may be distributed freely provided that all it is
redistributed intact.  If engaging in large-scale distribution, it is
requested that you contact one of the Zap developers before doing so 
so they can supply the latest version.


2.0 Installation
================

Copy the !ZapAsm application into Zap's Modules directory.

Zap will then need to be restarted.


3.0 Problems
============

% symbols may also cause confusion when used in labels.  Sasm's 0ABC hex
convention is not supported, nor its @ prefix for macros.

The bracket matching can get confused by brackets embedded in strings.

Large scale { ... } comments are ignored.

Help text in modules is miscoloured.


4.0 History
===========

v0.09 - (04-Mar-03)
      * 32 bit compatibility
      * Reworked Buttons code

v0.08 - (06-Jul-01)
      * Bugfix to Scripts loading code.

v0.07 - (30-Jun-2001) [cl]
      * Fix for a bug causing data aborts in new files

v0.06 - (24-Sep-1999)
      * Support for internationalised extension structure.

v0.05 - unknown

v0.04 - (13-Mar-97)
      * "!" comments given some support.
      * The mode options have started working again...
      * REM and REMP instructions' parameters are coloured more like strings.
      * Buttons menu added.
      * Numbers are now allowed in labels without affecting their colouring.

v0.03 - (27-Feb-97)
      * Better support for ZapButtons.
      * Improved bracket matching.
      * REM and REMP instructions' parameters are coloured more like comments.

v0.02 - (22-Feb-97)
      * Now no longer crashes when used with ZapButtons.

v0.01 - (18-Feb-97)
      * Very, very early release.


5.0 Contact
===========

If you have any comments or bug reports concerning Asm mode, we'd love to
hear from you. The best place to send messages to is the zap-users mailing
list at <zap-users@zap.tartarus.org> - you don't have to be subscribed to the
list to post to it. Alternatively, you could contact one of the Zap
developers directly - our addresses are in the Contact section of Zap's
website, which is at <http://zap.tartarus.org/>.
