C.A.P.E. 68k Version 2.5 Release 1.0 02/27/90 Thank you for purchasing C.A.P.E. 68k for the Amiga! We hope that this is the best assembler you have ever used and that if you have any problems in its use or any questions, that you will call us and let us help. We will make every effort to assist you. You can reach our technical support staff at (214) 340-4992. We also have a computer BBS at (214) 357-8511, online 24 hours a day at 300/1200/2400 baud. If you are a BIX user, join our conference: inovatronics. On this disk you will find the following files: CAPE the editor and integrated assembler CASM the standalone assembler HLINK our Amiga Linker HProf Amiga runtime profiler PMD a program module dismemberer ARexx (dir) some sample REXX macros for use with CAPE examples (dir) several example programs' source code, including: alert generate alerts (as if that weren't easy enough to do on the Amiga already!) Fcomp file compare utility QView super-small file viewer program Stars looks like you are flying through a star field ud unlock a locked directory wc word counter IntuitionTutor example of using various Intuition constructs, such as gadgets and menus, and how to process IDCMP events includes (dir) the official 1.3 includes from Commodore-Amiga LinkFiles (dir) needed files for linking programs on the Amiga, including: amiga.lib from Commodore-Amiga for linking small.lib from Bryce Nesbitt, this just has the _LVO offsets defined in it Our update policy is very simple: for non-major updates, we simply ask that you return your original CAPE disk and we will return it, free-of-charge, with the latest version of the software. For major updates, we usually charge a nominal fee. For example, when version 2.0 of PowerWindows came out, it cost our users of 1.x versions $22.50. However, when PW2.5 shipped, it was a free update to all 2.0 owners. Please send in your original CAPE 68k disk any time it is convenient for you (we'll put it on file for a future update) Or, if you know there is an update you need, send it (and the fee, if applicable) and we will ship out the latest version. Once again, thank you for purchasing CAPE 68k, and let us help if we can. Tim Martin Vice-President, Customer Support Inovatronics, Inc. 8499 Greenville Ave, Suite 209B Dallas, TX 75231 Main: (214) 340-4991 BBS: (214) 357-8511 Tech support: (214) 340-4992 FAX (214) 340-8514 CIS: 73270,3600 BIX: inovatronics -- join our conference. ERRATA: There is a new optimization bit to use with the OPTIMON directive. It is BIT 21 or $00400000 and optimizes the move.l to a moveq followed by a rol.l as described on page 80 of the manual. If this bit is not set, this optimization will no longer occur. ABOUT THE EXAMPLES: Each example is designed to assemble from the CAPE2.5 disk, from within CAPE, or using CASM. They will save their object files to the ram disk. Any file which ends in .o will need to be linked. Therefore, within the example directory for each of the files, I have included a file ending in .link which you can execute to automatically generate the final code. For example, after assembling the alert.asm file, you can go to the alert directory and type the following: execute alert.link and the executable file, alert, will be created to the ram disk. I have added the OPTIMON directive to each of the files, which may be incompatible with other assemblers which do not support code optimization. That line may be commented out if you plan to use another assembler.