(' ti. Macintosh' -----------Macintosh Programmer's Worksht>l' 3.0 Assembler Reference • ·~y_,.r· APPLE COMPUTER, INC. nm manual and the software described in it are copyrighted, with all rigbls reserved. Un:ier the copyright laws, this manual or the software may not be copied, in whole or part, wir.hout wrillen coosem of Apple, except in the nonnal use of the softw2.re ex to ma.lee a backup copy of the software. 1be same proprietary and copyright notices must be affixed to any permiaed copies as were aft"ixed to the original. This exception does not allow copies to be made for ochers, whether or nOl sold, but all of the material purchased (with all backup copies) may be sold, given. or loaned to another person. Under the law, copying includes tramlating 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. C 1985-88 Apple Computer, Inc. 20525 Mariani Ave. Cupertino, California 95014 (408) 996-1010 Pa.sal Compiler C 1982-88 Apple Computer, Inc. c 1981 svs, Inc. Apple, the Apple logo, AppleShare, AppleTalk, AIUX, lmageWriter, I.ascrWriter, Lisa, MacApp, Macintosh, and SANE, are registered trademarks of Apple Computer, Inc. MPW, Qui:kDraw, ResEdi, APDA, and SADE ate trademarks of Apple Computer, Inc. MacDraw, MacPaint, and MacWrile are iePtered trademarks of Caris Corporation. Microsoft Word is a trademark of Microsoft Corporation. rrc Garairond and rrc Zapf Dingbats are reg~tered trademarks of International Typeface Corporation. POSTSCRIPT is a registered trademark of the Adobe Syst~ Incorporated. Adobe mustrator 88 is a trademark of Adobe Systems Incorporated ImageStudio is a trademark of Esselte Pendaflex Corporation in the United States, of LetraSet Canada Limited in Canada, and of Esselte LetraSet Lim.i!ed elsewhere. Motorola is a trademark of Motorola, Inc. MathType is a trademark of Design Science, Inc. QMS is a registered trademark of QMS, Inc. UNIX is a trademark of AT&T Bell laboratories. Simultaneously published in the United States and Canada. MPW sample programs Apple Computer, Inc. granLS users of the Macintosh Programmer's Workshop a royalty-free license to incorporate Macintosh Programmer's Worltslwp sample programs into their own programs, or to modify the sample programs for use in their own progl'2rm, provided such use is exclusively on Apple computers. For any modified MadnttJSh Programmer's Workshop sample program, you may add your own copyright nOlice alongside the Apple copyright nOlicc. ( Contents Figures and tables xiii (. Preface About ThJs Manual xv What this manual contains xvii Other reference materials xviii Notation conventions xix Aids to understanding xix Courier typeface xx Italic xx Fields xxi Delimiter symbols xxi Braces xxii Brackets xxil Ellipses xxiii Underlining xxili For more information xxiv -.' .. Part I Using the Assembler 1 1 About the Assembler 3 General characteristics 5 Overview of the assembly proce…

(/ 9. Macintosh' Macintosh Programmer's Workshop 3(.0 Pascal ' ti APPLE COMPUM, INC. This manual and the software described in il are copyrishted, with all rights reserved. Under the copyrisbt laws, this manual or the software may not be copied, in whole or in part, without written consent of Apple, except in the normal use d the software or .to make a backup copy of the software. The same proprietary and copyright notices must be aff'JXed to any permitted copies as were affixed to the original. This exceptk>n does not allow copies to be made for others, whether or not sold, but all of the material purchased (with all backup copies) may be sold, given, or loaned to another peison. Under the law, copying includes uanslating into another language or format You may use the software oo any computer owned by you, but extra copies cannot be made for this purpose. The Apple logo is a registered trademark of Apple Ccmputer, Inc. Use of the "keyboard" logo (Option-Shift-IQ for coaimertial purposes without the prior written consent of Apple may constitute trademark infringement and unfair competition in violation of federal and stare laws. 0 1988 Apple Computer, Inc. 20525 Mariani Avenue Cupertim, CA 95014 (408) 996-1010 Apple, the Apple logo, laserWriter, Macimosh, and MacApp are registered trademarks of Apple Computer, Inc. ITC Garamond and ITC 1.apf Dingbats are registered trademarks of International Typeface Corporation. Microsoft is a registered trademarlc of Microsoft Corporation. POSTSCRIPT and Adobe Wustrator are registered trademarks of Adobe Systems Incorporated. Adobe Wustrator is a trademark of Adobe Systems Incorporated. IrnageStudio is a trademark of E,,selte Pendaflex Corporation in the United States, of LetraSet Canada Limiled in Canada, and of Falte IetraSet Limiled elsewhere. QMS is a registered trademark of QMS, Inc. llnotronic is a registered trademark of llnotype company. Smalltalk-SO is a registered trademark of the Xerox Corporation. Simultaneously published in the United States and Canada. Contents Tables and Figures :xvii Preface xix ., 1 About MPW Pascal 1 About MPW Pascal version 3.0 3 About SADE and MacsBug 4 Object Pascal 5 About the Pascal interface files 6 Using interface ftles 9 About the Pascal libraries 10 About the Pascal examples 13 Installing MPW Pascal 14 Segmentation control 15 Creating resourtes 16 Creating an application in MPW Pascal 16 Building an application 17 Compiling an application 17 Unking an application 18 Creating a tool in MPW Pascal 19 Building a tool 20 Compiling a tool 20 " Unking a tool 20 Creating a desk a~ry in MPW Pascal 21 Desk accessory restrictions 21 The DRVRRuntime library 21 Desk accessory routines 22 Building a desk accessory 23 linking a desk accessory 23 Creating code for different models of the Macintosh 24 Source code 24 Iii Interface files 24 Compiler options 25 SANE and the Macintosh II 25 Floating-point enhancements 25 MC68881 enhancements 26 MC68020 enh2ncements 27…

• Macintosh~ Macintosh Programmer's Workshop 3.0 Reference ( ' c C APPL! COMPUT!l, INC. nu, manual and the soCtwue described in i1 are a:ipyriahted, with ail POSTSCRIPT is a~ <i Adobe Systems Lncorponted. righrs reserved. Under the copyright laws, this manual er me soCtwue may net be copied, in whale er pan. wUhout wrillen ~ of Apple, · except in the ncnnal u.se <i the softwa.re or to make a mck:up copy of the soAwve. Tbe same proprietary and copyrigl& nctic:es must be affbed to any pem1ited copies as were alB:m1 to the origiml. lb.i.t excepcion does Del allow copies to be made fer ochm, whether or aot sold,· but ail of the material purchased (wilh all backup copies) may be sold, given, or loaned to aaother pmoa. Under the law, copyin8 includes tr:ulSlalins iitto aaother fan&uase er f~ LinoCronic is a registaed tracfermrk Of Linotype company. '•• You .may u.se the software on any computer owned by you, but extra copies c::umct be .made fer this purpose. 0 1985-88 Apple Computer, Inc. 20525 Mam.Di Ave. · . . ., .. Cupenjno, CaliComia 95()1.t' . (408) 996-1010 Pua1Compiler0 1982.a8 Apple Computer, Inc. 0 1981 svs, Im:. Apple, the Apple Ioso, Apple.Share, AppleTaJk, A/tJX. fmqeWrilet, tase:Writet, Usa, MacApp, Macimmh, and SAN! are regiseJed tm!emarks of Apple Computer, Inc. MPY, Quir:kDr.lw, la!dl, and SAD! are rncfemar!rs of Apple Computer, Inc. MacDraw, .MacPaill, aod MKWrire lie regiSered. uwtenndra of Caris CotpCll'llilL Adobe lllustrator 88 is a tr2.demaric of Adobe Systema &xorponted. ImageStudio is a tr2.demaric of Esselie Pm:laflex Corpot2tim1 in the Unired SWa; d I.araS« Camda Limited in Caaada, and d P.1selte Lett2Set Umited eJsewhere. Mororola is a trademark of Mctorola, Ice. QMS is a regiaeted uadamrk of QMS,Inc. UNIX ma trademark of • AT~T BeU laboratories. Simulw1eoUsly pub&hed in the United SWes and Camda. MP'W sample program · Apple Computer, Ice. gzmt.s users of the Ma&mm~ \Vori:rhq? '. a royalty-free liceme to incorpome . Macintosll ~ Wonis/q) sampM programs into their own · propims, or to modify the sample propims for u.se in their own prognms, provided such u.se is exdusiveiy on Apple c:ompurers. For any modfied Mactnlmh .Prop.mimer's \VOTishop sample progrim, you .may · add your own copyrip aotice aloapide the Apple copyrighl aotice. Contents Figures and 12bles xxvii Part I Shell Reference 1 Introduction: The New and the Neces.ury 3 · Power tools for Macintosh programmers 5 What's new in MPW 3.0 7 MPWC++ 7 Projector 8 Symbolic Application Debugging Environment (SAD;) g..:. New or enhanced tools 8 New or enhanced Shell commands 10 New Sheil editor capabilities 12 New st:lndan:i Shell wriabies 13 Changes to menus and dialogs 14 Miscellaneous Shell changes 14 Numeric libraries 15 MPW C and MPW C++ Include files 16 MPW Pascal 16 MPW tool libraries 17 What you'll need 17 Hardware and system requiremena 17 System Folder requirements 18 Documentation 18 About this reference 19 F"mding information fast 20 S…

( MPW 3.0A2 Document List MPW Overview • MPW 3.0A2 Release Notes Projector •Projector Apha 2 Release Notes • Converting Your Projects •Macintosh Programmers's Workshop Project Management System ERS ''Projector" SADE •Alpha 2 Release Notes •Macintosh SADE Reference Manual Alpha Draft #2 Libraries • A2 Libraries • Pre-A2 Libraries Linker Tools •Release Notes for MPW 3.0A2 - Linker and related tools Interfaces •Converting Between pre-3.0 Str255's and 3.0 Str25S's •Interface Release Notes • Pre-A2 Interfaces •Macintosh Technical Notes: Setting and Restoring AS MPW Shell •Macintosh Programmer's Workshop 3.0 Shell ERS Commando •Commando's Built-In Editor and other new features SetVersion • SetVersion manual page Choose • Choose manual page • Changes to Choose Dump File • DumpFile manual page Where ls • Whereis manual page Sort •Sort manual page Resource Tools • Rez & DeRez ERS •Macintosh ResEdit Reference Manual Beta Draft Parser Generator • MPW LL(l) Parse Table Generator ERS MacsBug •Macintosh MacsBug Reference APDA Final Draft ('" _/' ('\ / (\ ,. ) / MPW 3.0A2 Release Notes July 14, 1988 Overview This release note pertains to the following MPW products: • MPW Development Environment • MPWPascal •MPWC • MPW Assembler MPW C++ has its own separate release note. This release note, the MPW 3.0 ERS' s, and other tool-specific release notes are the documentation for this release. Differences between the ERS, previous 3.0 development releases, and this release are documented below. If no release note exists for something that has an ERS, assume that the piece has been implemented as documented in the ERS. MPW 3.0A2 highlights include a symbolic debugger, project management system, and new C compiler. All of the C pieces of MPW, were compiled with this new C. Since MPW 2.0, the C header files have three important changes: every function has a function prototype, the capitalization for routines that pass strings and points has changed, and the definition of Str255 has changed. The capitalization and Str255 changes will require changes to your C source. See the section below titled ''Interfaces." ( Another change in MPW 3.0A2 may require a change to your Makefiles. The Pascal compiler no longer uses the Load/Dump mechanism. Instead, the compiled object code for each unit is saved in the unit's resource fork. Therefore, dependency rules (in Makefiles) upon Pascal dump files are obsolete. See the section below titled "Pascal." The A2 C compiler now has function prototype checking turned on. Furthermore, the C compiler is very strict about type compatibility. Be forewarned ... Installation • Installation from floppies - MPW 3.0 now includes an installer disk for installing MPW from a set of floppy disks .. Here are the steps for automatically installing MPW on your disk: 1) drag the ''Installation Folder" onto the hard disk where you want MPWinstalled · 2) launch the MPW Shell found in the ''Installation Folder" App…