Compileit! •••.••....•.••.••••.•.•..•...••.•.....•.• 119
Total Page:16
File Type:pdf, Size:1020Kb
Compilelt! The XCMD Development System The XCMD Development System User Manual For Technical Support Call 510-943-7667 Monday-Friday, 9 am - 5 pm Pacific time Helzer Software Compilelt! User Manual ©1990-94 Heizer Software. All Rights Reserved. Rev. 5/95 Copyright Notice You are permitted, even encouraged, to make one backup copy of the enclosed programs. Beyond that is piracy and illegal. The software (computer programs) you purchased are copyrighted by the author with all rights reserved. Under the copyright laws, the programs may not be copied, in whole or part, without the written consent of the copyright holder, except in the normal use of the software or to make a backup copy. This exception does not allow copies to be made for others, whether or not sold, but the material purchased (together with all backup copies) may be sold, given, or loaned to another party. Under the law, copying includes translating into another language or format. You may use the software on any computer owned by you, but extra copies cannot be made for this purpose. If you have several computers requiring the use of this software, we are prepared to discuss a multi-use or site license with you. Compilelt! ©1989-1994 Tom Pittman. All Rights Reserved. Debuglt! ©1991-1994 Tom Pittman. All Rights Reserved. Compilelt! User Manual ©1990-94 Heizer Software. All Rights Reserved. No part of this document and the software product that it documents may be photocopied, reproduced, or translated to another language without the express, written consent of the copyright holders. The information contained in this document is subject to change without notice. Heizer Software makes no warranty of any kind with regard to this written material. Heizer Software shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this manual. Compilelt! and Debuglt! are trademarks of Heizer Software. HyperTalk, HyperCard, Macintosh, Inside Macintosh, SANE, MPW, MacsBug, and StackWare are trademarks or registered trademarks of Apple Computer, Inc. SuperCard and SuperTalk are registered trademarks of Silicon Beach Software, Inc. TMON is a registered trademark of Icom Simulations, Inc. America Online is a registered trademark of Quantum Computer Corp. Compuserve is a registered trademark of Compuserve, Inc. All other brand or product names are trademarks or registered trademarks of their respective holders. CREDITS Project Team Tom Pittman Developer Alan Pabst Product Manager Gerald Schmalzried Software Engineer Steve Michel Documentation Review Ray Heizer Publisher Acknowledgements Extra special thanks to: Mark Thowe, Jerry Daniels, Andrew Meit, and Bryan McCormick for suggestions, killer beta testing, and encouragement. Also to Steve Michel for writing the Compilelt! 1.5 manual which served as a basis for this manual. Thanks also to all our beta testers, especially: J.P. Adams, James Beldock, Brian Benison, Kevin Calhoun, Jack Carr, Peter Cleaveland, Jeff Close, Keith DeLong, Brad Doster, Danny Goodman, Tom Gruman, Mark Hanrek, David Johnson, Greg Kearney, John Kindschi, Binky Melnik, John Miskimins, Scott Neufeld, Paul Pearson, George Pytlik, Dan Shafer, David Smith, Robertson Reed Smith, Gary Stanoulis, Michel Swain, David Veeneman, Christopher Watson, Dean Wette, Robert Williamson, Roger Wood. And also, thanks to our customers. Your suggestions and support are greatly appreciated. 3 4 TABLE OF CONTENTS CHAPTER 1 INTRoouCTioN .................................................................... 9 What Is Compilelt! .............................................................................. 10 Four Reasons for Using Compilelt! ........................................... 10 How to Use This Manual ............................................................ 10 What Is a Compiler? .................................................................... 11 What Are Externals? .................................................................... 12 Who Should Use Compilelt! ....................................................... 13 What Compilelt! Does and Does Not Do ................................. 13 CHAPTER 2 CoMPILElT! BASICS ........................................................... 15 Quick Start Guide ................................................................................ 15 A Short Guided Tour ................................................................... 16 Options ................................................................................................. 19 Editing Scripts .............................................................................. 20 Compiling ...................................................................................... 20 Indicators ....................................................................................... 20 Dialogs ........................................................................................... 21 Installing into Another Stack ...................................................... 22 Background Operation ....................................................................... 22 CHAPTER 3 UNDERSTANDING CoMPILElT! ............................................ 25 Limitations of Compilelt! ................................................................... 25 Mathematics .................................................................................. 25 Accessing Data in HyperCard Fields ........................................ 26 Data Types ............................................................................................ 26 Boolean .......................................................................................... 28 Integer ............................................................................................ 28 SANE .............................................................................................. 28 String .............................................................................................. 29 Record ............................................................................................ 29 Types of Code Produced by Compilelt! ........................................... 32 Native Inline Code ....................................................................... 32 Library Code ................................................................................. 33 Callbacks ....................................................................................... 34 Purging Your Scripts of Text Callbacks ............................ ;....... 36 Using ROM Toolbox Routines .......................................................... 40 Procedures and Functions .......................................................... 41 5 Debugging ............................................................................................ 42 Debuglt! ......................................................................................... 42 Invoking Debuglt! ........................................................................ 42 The Debuglt! Window ................................................................. 45 The Source Code Listing ............................................................. 45 The Variable Monitor .................................................................. 47 The Controls .................................................................................. 49 Some Things You Should Know about Debuglt! .................... 51 Distributing Externals with Debuglt! Attached ...................... 53 Analysis ................................................................................................ 53 CHAPTER 4 THE SYMBOL TABLE .......................................................... 57 Compilelt! Names for Toolbox Access ............................................. 60 Useful ToolBox Commands and Functions ..................................... 61 ToolBox Variables and Fields ............................................................ 61 High-Level File Manager Routines ................................................... 62 HyperCard 2.0 Names ........................................................................ 62 SuperCard Commands and CallBacks ............................................. 62 Color QuickDraw Commands and Functions ................................ 63 Custom Symbol Edit ........................................................................... 63 K Constant ..................................................................................... 63 V ROM Global Variable .............................................................. 64 R Record Field .............................................................................. 64 XExtemal (XCMD/XFCN) ......................................................... 64 H Text Callback ............................................................................ 66 * Binary Callback .......................................................................... 66 $ Raw Inline Code ........................................................................ 67 CHAPTER 5 GEITING TO l<Now THE TooLBox ..................................... 69 Bridging The Gap to Inside Macintosh ............................................... 69 Safe Pointers for Faster Strings .......................................................... 75 Pointers and Handles .................................................................. 79 The Times .................. ~ ..................................................................