030-3621-A MPW3.2 Release Notes Erratum Due to an oversight, an erroneous comment symbol was used in lines 20 through 24 of the source file: {MPW}PExamples:TESampleGlue.a The character"#" was incorrectly written where the character";" should have been written. MPW3.2 Release Notes i Copyright Apple Computer, Inc. 1990-1991. All rights reserved. MPW3.2 Release Notes This release note summarizes the differences between MPW 3.2 and MPW 3.0, the last version for which a reference manual exists. Details beyond those given in this note are to be found in separate release notes entitled MPW 3.2 Shell, MPW 3.2 Object Pascal, MPW 3.2 C, MPW 3.2 Assembler, MPW 3.2 Libraries & Interfaces, MPW 3.2 "411" Help, MPW 3.2 Run-Time Architecture, MPW 3.2 SIOW, and MPW 3.2 Tools & Scripts. Three of the above: "411" Help, Run-Time Architecture, and SIOW describe completely new features. Principal Changes Shell • Projector has a number of enhancements. • The Editor provides split windows. • A marker browser has been provided. • There are additional commands for the faccess function. • The save command, when scripted, saves the resource fork of a file if any resource has changed. • MPW can now be run under A/UX. • New System 7 .0 error codes have been added to the file SysErrs.err. c • A variety of new object code optimizations have been implemented. • There are new compiler options to control optimization level. MPW3.2 Release Notes 1 Copyright Apple Computer, Inc. 1990-1991. All rights reserved. • Support is provided for the MacApp debugger and code profilers (generating a preamble and postamble for functions). • A new pragma is provided for passing parameters to functions via registers. • A new pragma is provided to force the generation of MC68020 code. • A new pragma is provided to prevent the multiple inclusion of header files. • There is a new option for invoking the "32-bit everything'' run-time architecture. • A new pragma is provided to prevent dead code stripping by the linker. • An option is provided for machines having the MC68020 and up that allows stand-alone code segments greater than 32K. Object Pascal • Further object code optimizations, including an optional two-pass code generation phase which allocates unused scratch registers for local data. • An option to control optimization level. • An option for invoking the "32-bit everything'' run-time architecture. • A new syntax for declaring forward and external objects • Enhancements to the Object Pascal declaration handling to support MacApp. • Support for USES clauses in the implementation section of a unit. • Support for external C functions with arbitrary numbers of arguments,. • The ability to omit static links for nested procedures that don't need them. • Increase in the number of nested include files, the maximum number of nested compiletime conditionals, and in the number of long identifiers. ASM • New optimizations. • Longer identifiers to support C++ name mangling. • MC68040 s…

Glossary of Copland Terminology The terms defined in this glossary are preliminary and subject to change. action The objects and activities that make a human interface task unique, such as the names of folders to back up or a list of people to whom a message should be sent. See also task. activation model The tasking and synchronization model mandated by an I/O family. It consists of the code that provides the runtime environment to the family and its plug-ins. See family, plug-in. active assistance General term for Copland features that allow the computer to assist the user actively. See also automation, delegation, task, task definition, assistant. active window The frontmost window on the desktop; the window where the next action will take place. The active window is identified by distinctive details that aren’t visible for inactive windows. address space The set of addresses that a process can reference. alert box An arrangement of panels within a modal window that an application displays on the screen to warn the user or to report an error. An alert box typically consists of text describing the situation and buttons that require the user to acknowledge or rectify the problem. An alert box may or may not be accompanied by an alert sound. See also dialog box, modal window. area A logical extent of memory with common attributes. Areas never overlap; a particular address in an address space is included in at most one area. See also global area. assistant An entity that provides a specific kind of active assistance in a given context by asking the user questions and then taking actions or creating human interface tasks based on the answers. automation Automatically controlled operations. In Copland, features that allow the computer to create a series of actions, or a human interface task, in a form that can be repeated. See also task. backing provider A server process responsible for transferring memory between backing storage (for example, a hard disk) and physical memory in response to page faults. bus expert See low-level expert. cell A rectangular part of a list displaying information about one item in the list. CFM-based software Software compiled for execution in a runtime environment that uses Code Fragment Manager (CFM) fragments to organize executable code and data in memory. GL-1 Draft. Confidential.  Apple Computer, Inc. 10/17/95 This document was created with FrameMaker 4.0.4 G L O S S A RY close box The box on the left end of the title bar of an active window. Clicking it closes the window. code fragment See fragment. Code Fragment Manager The part of the Mac OS that loads fragments into memory and prepares them for execution. collapse box The box on the right end of the title bar of an active window. Clicking it collapses or expands the window. condition The set of events or states that trigger a human interface task. See also task. cooperative process A process that has a cooperative task created by the Process Manager. The …

(' 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 ti APPLE COMPUTER, INC. This manual and the software described in it are copyrighted, with all rights reserved. Under the copyright laws, this manual or the software may not be copied, in whole or in part, without written consent of A!Jple, except in the normal use of the software or to make a backup copy of the software. The same proprietary and copyright notices must be affixed to any permitted copies as were affixed to the original. This exception 00es not allow copies to be made for othe.is, whether or not sold, but all of the material purchased (with all backup copies) may be sold, given, or loaned to another pe.ison. 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. The Apple logo is a registered trademark of Apple Computer, Inc. Use of the "keyboard• logo (Option-Shift-K) for conunercial purposes without the prior written consent of Apple may constitute trademark infringement and unfair competition in violation of federal and state laws. © 1988 Apple Computer, Inc. 20525 Mariani Avenue Cupertino, CA 95014 (408) 996-1010 Apple, the Apple logo, I.aserWriter, Macintosh, and MacApp are registered trademarks of Apple Computer, Inc. ITC Garamond and ITC Zapf Dingbats are registered trademarks of International Typeface Corporation. Microsoft is a registered trademark of Microsoft Corporation. POSTSCRIPT and Adobe illustrator are registered trademarks of Adobe Systems Incorporated. Adobe illustrator is a trademark of Adobe Systems Incorporated. IrnageStudio is a trademark of Esselte Pendaflex Corporation in the United States, of LetraSet Canada Limited in Canada, and of F.sselte LetraSet Llmited elsewhere. QMS is a registered trademark of QMS, Inc. Llnotronic is a registered trademark of Linotype company. Smalltallc-80 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 files 9 About the Pascal libraries 10 About the Pascal examples 13 Installing MPW Pascal 14 Segmentation control 1S Creating resoun:es 16 Creating an application in MPW Pascal 16 Building an application 17 Compiling an application 17 linking an application 18 Creating a tool in MPW Pascal 19 Building a tool 20 Compiling a tool 20 '" linking a tool 20 Creating a desk accessory 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 ill Interface files 24 Compiler options 25 SANE and the Macintosh II 25 Floating-point enhancements 25 MC68881 enhancements 26 MC680/0 t:1LJC'.ncen1ent.:i 27 Othe…

Part II Command Reference Part II Command Reference Part II is a conunand dictionary that describes each of the tools, scripts, and built-in conunands of the Macintosh Programmer's Workshop 3.0. When you have become sufficiently familiar with the material in Part I, you can move Part II to a smaller separate binder for convenient desktop reference. (You may also want to include frequently used appendixes or tables in the separate binder.) Please be sure to read the next section, "Conunand Prototype," which explains the format for all conunand deSCriptions and defines the basic behavior of all conunands .• Contents Conunand Prototype 6 AddMenu-add menu item 9 Adjust-adjust lines 13 Alert---display an alert box 14 Alias---define or write conunand aliases 15 Align-align text to left margin 17 Asm-MC68xxx Macro Assembler 18 Backup-folder file backup 25 Beep-generate tones 34 Begin ... End-group conunands 36 Break-break from For or Loop 38 BuildConunands-show Build commands 40 BuildMenu-create the Build menu 42 BuildProgram-build the specified program 43 C-C Compiler 45 Canon-canonical spelling tool 49 Catenate-concatenate files 52 CheckIn-check in files to a project 54 CheckOut-check out files from a project 57 CheckOutDir-set checkout directory 61 Choose-choose or list network volumes and printers 64 Clear-clear the selection 68 Close-close specified windows 69 1 Conunando-display dialog for a command 71 Compare-compare text files 73 CompareFiles-show file differences 79 CompareRevisions-compare revisions 81 Confirm-display confirmation dialog box 83 Continue-continue with next iteration of For or Loop 85 Copy-copy selection to Clipboard 87 Count-count lines and characters 89 CPlus-C++ compiling system 91 CreateMake-create a simple makefile 96 Cut-copy selection to Clipboard and delete it 99 Date-write the date and time 100 Delete-delete files and directories 102 DeleteMenu-delete user-defined menus and items 104 DeleteNames--delete symbolic names 105 DeleteRevisions--delete revisions and branches 107 DeRez-Resource decompiler 109 Directory-set or write the default directory 113 DirectoryMenu-create the Directory menu 115 Dolt-highlight and execute a series of conunands 117 DumpCode-write formatted resources 119 DumpFile-display contents of an arbitrary file 122 DumpObj-write formatted object file 125 Duplicate-duplicate files and directories 128 Echo-echo parameters 130 Eject-eject volumes 132 Entab-<:onvert runs of spaces to tabs 133 Equa1-compare files and directories 136 Erase-initialize volumes 139 Evaluate-evaluate an expression 140 Execute-execute a script in the current scope 145 Exists-<onfirm the existence of a file or directory 146 Exit-exit from a script 147 Export-make variables available to programs 148 FileDiv-divide a file into several smaller files 150 Files-list files and directories 152 Find-find and select a text pattern 155 Flush-<:lear the conunand cache 157 For...-repeat conunands once per parameter 158 2 MPW 3.0 Refer…

• 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…

ti* Macintosh"' Extended Discipline Users Manual Working Draft 3 12May1988 Rob Dearborn ( Table of Contents 1. lnttcxluction •.••.........•..•.•.••..•................•.......•••.......•...•...•••.............•. 1 Extended Discipline ..................•..........•••..•.•........•.....................•.•. 2 This Dc:x:ument ...•.•..•.•...........•...••.••.••.•....••.•......•...••..•....•.•.•........ 2 2. Becoming Disciplined .....•.•.....•......•.........•.......•.•..•..••••••.....•...•............ 3 Installation •.••••.••.•..•.•..•..••..••••..•....••••••..••.•.••.••••.••.••.•.•.•••••.•..••••.4 How It Works ........................................•................•...................4 Par81lleter Pass~g ................................ ~ .................•............4 3. Applying Extended Discipline .................................................................6 Tlmling It On ..............................................................................7 The Desk Acce.ssory ....•..........•..............•....•...................•..•.....••....7 The Extended Discipline Menu ..........................................................9 Revert to Saved Configuration .................................................9 Save Configuration ..•.....•..............•..•......•..•....•...•................9 Show Traps/Parameter Types .................................................. 1O Show Calling Application On Enor ........................................... 10 ROM Result Code Checking ................................................... 10 Q.D.t ••••••••••••••••••.••••••••••••••••••••••••••••••••••••.••••••••••••••••••.••.•• 10 4. Extended Discipline Reports .•..........•.....•.......•....•....••.....•..•....••••.•......... 11 Error Messages ............................................................................ 12 Stack-based Paraineter EITors .................................................. 12 Register-based Paran:ieter Enors ............................................... 12 Tra.shed. Register ...........•...................••....•..............••........... 13 En-OJ" Return fto.m Trap .................•..•••.•.•..•.•......•... ~ •...•......... 13 Warnings ................................................................................... 13 Appendix ..............................................................................•............. 15 Index ................................................................................................ 17 Discipline Users Manual c. Chapter 1 Introduction 1 Discipline Users Manual Working Draft 3 Extended Discipline Extended Discipline™ is a programming utility that allows the user to monitor the parameters passed to Macintosh Toolbox and Operating System routines. Upon encountering a Toolbox call with an invalid or inappropriate parameter, Discipline calls on Macsbug (or any Discipline-friendly debugger) to display information about the intercepted call. Aside from the memory it uses, D…

ti® Macintosh® Macintosh Programmer's Workshop 3.0 Assembler Reference ti APPLE COMPUTER, INC. This manual and the software described in it are copyrighted, with all rights reserved. Under the copyright laws, this manual or the software may not be copied, in whole or part, without written consenr of Apple, except in the normal use of the software or to make a backup copy of the software. The same proprietary and copyright notices must be affixed to any permitted copies as were affixed to the original. This exception 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 person. 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. © 1985-88 Apple Computer, Inc. 20525 Mariani Ave. Cupertino,Caluornia 95014 (408) 996-1010 Pascal Compiler © 1982-88 Apple Computer, Inc. © 1981 SYS, Inc. Apple, the Apple logo, AppleShare, AppleTalk, A/UX, ImageWriter, I.aserWriter, Lisa, MacApp, Macintosh, and SANE, are registered trademarks of Apple Computer, Inc. MPW, QuickDraw, ResEdi!, APDA, and SADE are trademarks of Apple Computer, Inc. MacDraw, MacPaint, and MacWrite are registered trademarks of Claris Corporation. Microsoft Word is a trademark of Microsoft Corporation. ITC Garamond and ITC Zapf Dingbats are registered trademarks of International Typeface Corporation. POSTSCRIPT is a registered trademark of the Adobe Systems Incorporated. Adobe Illustrator 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 Limited 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. grants users of the Macintosh Programmer's Workshop a royalty-free license to incorporate Macintosh ~rammer's Workshop sample programs into their own programs, or to modify the sample programs for use in their own programs, provided such use is exclusively on Apple computers. For any modified Macintosh Programmer's Workshop sample program, you may add your own copyright notice alongside the Apple copyright notice. Contents Figures and tables xiii Preface About This 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 xxii Ellipses xxiii Underlining xxiii For more information xxiv Part I Using the Assembler 1 1 About the Assembler 3 General characteristics 5 Overview of the assembly process 6 Assembly files 7 Programming for the …