Macro68 Copyright ©1990 DigiSoft INSTALLING MACRO68 Use the installation script provided to install Macro68 onto your hard drive, or onto another floppy. This script, InstallMacro68, is in the root directory of disk M68_1. To use it you should boot your computer normally, insert the disk M68_1 into any drive and type "InstallMacro68" at the CLI or double click on the "InstallMacro68" icon. You do not have to change to any particular directory nor do anything else before running the script. Unlike most other installation scripts, ours gives you total control of the installation. It will NOT DO ANYTHING without first telling you what it is about to do and seeking your permission to continue. In all cases where a choice is possible you are then asked to type in the directory path that you want the file or files copied to. If you choose not to install macro68.library and digisoftSupport.library to your LIBS: directory then you will have to copy SpecialLoadLib (from the C directory of disk #1) to your hard drive and include the following lines in your startup-sequence: SpecialLoadLib "path/digisoftSupport.library" SpecialLoadLib "path/macro68.library" where "path" is the directory path to which you have installed the respective libraries. Note that in this case digisoftSupport.library MUST be loaded into memory first. Note also that SpecialLoadLib is written to do no command line error checking and the quotes (") MUST be present. DISTRIBUTION OF FILES Blink may be freely distributed subject to the conditions imposed by "The Software Distillery" in the BLink documentation. The example files (those found in the Examples directory of disk #3 may be distributed subject to the conditions set out in each individual example source file. The digisoftSupport.library may be distributed only with the example files in this distribution that require it, and not individually or with any other file, without the prior written permission of DigiSoft. ALL other files supplied with this distribution are NOT distributable without the prior written permission of DigiSoft. ENHANCEMENTS IN RELEASE 2 (Not in manual) 1) RARG -- New pseudo-op. Similar in operation to the NARG pseudo-op. Unlike NARG, RARG returns the "real" number of arguments passed. Following the convention established by Assem (tm of Metacomco) NARG returns the number of arguments passed to a macro and includes null arguments in this count. The new RARG pseudo-op only counts the non-null arguments passed. example: macroname 1,2,,4,5 In the example NARG would return 5 while RARG would return 4 since the third argument is null. 2) OLDSYNTAX --- New directive The OLDSYNTAX directive can be used to allow Macro68 to assemble files which use the original Motorola syntax for 68000 and 68010 addressing modes. While this mode of addressing is fully compattible with that of most other Amiga assemblers, users are encouraged to use the NEW Motorola standard in all new code. This is now the DEFAULT mode of operation. The new command template is:- OLDSYNTAX The following additional addressing modes are supported under the old Motorola syntax:- d16(An) d8(An,dn.SIZE) d16(PC) d8(PC,dn.SIZE) xxx xxx.w xxx.l The index to be used in the custom file is "oldsyntaxIndex" 3) NEWSYNTAX --- New directive The NEWSYNTAX directive has been provided as a complement to the OLDSYNTAX directive. Users who write their new code using the new Motorola standard syntax or use the NewSyntax tool to convert their old code and include the NEWSYNTAX directive at the beginning of their source file (or in the Macro68.config file) will be rewarded with faster assemblies. Users are also reminded that typing mistakes are more thoroughly trapped when using the new syntax. For instance, leaving the # character off of immediate data is an error in the new syntax, whereas the old syntax would see this as an absolute address. 4) INCBIN --- Enhancement The INCBIN directive will now search the include path lists that have been established with either the INCDIR or INCPATH commands. The new command template is:- INCBIN 5) MACLIB --- Enhancement The MACLIB directive will now search the include path lists that have been established with either the INCDIR or INCPATH commands. The new command template is:- MACLIB 6) INCBIN --- New optional parameters The new command template is:- INCBIN [,,] The first optional is the offset from the beginning of the file at which to begin reading. The second is the length to be read. If you supply the first optional then you MUST also supply the second. If Macro68 detects an error (seek or read beyond file bounds) then a fatal error report will be generated and assembly will terminate. 7) PURE --- New directive The command template is:- PURE This directive can be used to cause the pure bit to be set in the output file. This will only occur if the output file is exeobj. No error will be generated if this directive is used with any other file type, but the pure bit will not be set. NO checking is done to ensure that the code is in fact pure. 8) FAILAT --- New directive The command template is:- FAILAT This directive serves the same function as the -f flag on the command line, allowing you to specify the maximum number of errors that are to be reported before the assembler aborts the assembly. 9) MC68040 --- New directive This directive is to be used in the same manner as the MC68000, etc. directives to inform Macro68 to accept opcodes from the Motorola 68040 instruction set. 10) FRAME OFFSET --- New group of directives Decrement counter and assign FO value to symbol