Inside Macintosh X-Ref 1988
Inside Macintosh X-Ref 1988
3LOSSAR
ccess path: A desc
file is opened.
ccess .path buffer:
Job Titles
Charges
••
•
§0 Accounts
Inside Macintosh® X Ref
A
~
Addison-Wesley Publishing Company, Inc.
Reading, Massachusetts Menlo Par~ California New York
Don Mills, Ontario Wokingham, England Amsterdam Bonn
Sydney Singapore Tokyo Madrid San Juan
S APPLE COMPUTER, INC.
Copyright© 1988 by Apple Computer, Inc.
All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or
transmitted, in any fonn or by any means, electronic, mechanical, photocopying, recording, or
otherwise, without prior written pennission of Apple Computer, Inc. Printed in the United States
of America.
Apple, the Apple logo, AppleTalk, A/UX, HyperCard, ImageWriter, MacApp, and Macintosh, are
registered trademarks of Apple Computer, Inc.
APDA, Apple Desktop Bus, :t::'inder, and Stackware are trademarks of Apple Computer, Inc.
Helvetica and Times are registered trademarks of Linotype Co.
Microsoft is a registered trademark of Microsoft Corporation.
NuBus is a trademark of Texas Instruments.
POSTSCRIPT is a registered trademark of Adobe Systems Incorporated.
UNIX is a registered trademark of AT&T lnfonnation Systems.
ISBN 0-201-13694-5
ISBN 0-201-19265-9
CDEFGH-AL-898
Third'printing, July 1988
Inside Macintosh X-Ref
WARRANTY INFORMATION
Even though Apple has reviewed this manual, APPLE MAKES NO WARRANTY OR
REPRESENTATION, EITHER EXPRESS OR IMPLIED, WITH RESPECT TO THIS
MANUAL, ITS QUALITY, ACCURACY, MERCHANTABILITY, OR FITNESS FOR A
PARTICULAR PURPOSE. AS A RESULT, THIS MANUAL IS SOLD "AS IS," AND
YOU, THE PURCHASER, ARE ASSUMING THE ENTIRE RISK AS TO ITS
QUALITY AND ACCURACY.
THE WARRANTY AND REMEDIES SET FORTH ABOVE ARE EXCLUSIVE AND IN
LIEU OF ALL OTHERS, ORAL OR WRITTEN, EXPRESS OR IMPLIED. No Apple
dealer, agent. or employee is authorized to make any modification, extension, or addition to this warranty.
Some states do not allow the exclusion or limitation of implied warranties or liability for incidental or
consequential damages, so the above limitation or exclusion may not apply to you. This warranty gives
you specific legal rights, and you may also have other rights which vary from state to state.
Contents
1 Preface: About This Book
3 Index I: General Index
49 Index Il: Constants and Field Names
59 Appendix A: Routines That May Move or Purge Memory
63 Appendix B: System Traps
63 Sorted by Name
72 Sorted by Trap Word
83 Appendix C: Global Variables
89 Glossary
This book was written, edited, and composed on a desktop publishing system using
Apple® Macintosh® computers and Microsof~ Word. Proof and final pages were
produced on the Apple LaserWritei4 Plus Printer. POSTSCRJPT'l'M, the LaserWriter page-
description language, was developed by Adobe Systems Incorporated. The text is set in
Times• and the display type in Helvetica•.
PREFACE: ABOUT THIS BOOK
The Inside Macintoshf> X-Ref is your key to Apple's official programming books for the
Macintosh family of computers. The X-Ref gives you:
• a general index to eight books: all five volumes of Inside Macintosh, the Programmer's
Introduction to the Macintosh Family, the Technical Introduction to the Macintosh
Family, and Designing Cards and Drivers for the Macintosh II and Macintosh SE. The
general index also contains references to the Macintosh Technical Notes for
1984-1987.
• a complete list of routines that may move or purge memory
• a list of all Macintosh system traps
• a list of all Macintosh global variables
• a comprehensive Macintosh glossary
In addition, the Inside MacintoshX-Refcontains a new index, never before published,
listing all constants and field names in Inside Macintosh.
a
The books for which the Inside MacintoshX-Refis cross-reference are published by
Addison-Wesley as part of the Apple Technical Library. Macintosh Technical Notes may
be ordered from APDA, the Apple Programmer's and Developer's Association. For
information about APDA, see the inside back cover of this book.
The text of the Inside Macintosh X-Ref is also available from APDA in the form of
Macintosh text files on a 3.5-inch disk.
The General Index lists page references for eight books plus theMacintosh Technical Notes for
1984-1987. The eight books include all five volumes of Inside Macintosh, the Programmer's
Introduction to the Macintosh Family, the Technical Introduction to the Macintosh Family, and
Designing Cards and Drivers for the Macintosh II and Macintosh SE.
The index entries for the different books are distinguished by letter codes, as follows:
Code Book Sample listing
I, II, m, IV, V Inside Macintosh 11-276 =Volume II, page 276
p Programmer's Introduction to the
Macintosh Family P-103 = page 103
T Technical Introduction to the
Macintosh Family T-78 =page78
c Designing Cards and Drivers for the
Macintosh II and Macintosh SE C8-12 = chapter 8, page 12
N Macintosh Technical Notes N2 = Technical Note 2
Index I: Generallndex 3
Inside Macintosh X-Ref
8 Index I: Generallndex
Index I: General Index
Index/: Generallndex 11
Inside MacintoshX-Re/
Desktop file m-10, IV-243, N29, N48, T- dialog record I-403, 407, T-57
124, 127, 129 dialog template 1-402, 403, T-57
destination rectangle I-374, P-116 resource format 1-425
DetachPH function 11-308, V-513 dialog window I-401
DetachResomce procedure I-120 dialogs, modeless NS
Developer Services (Apple) P-157 DialogPeek data type I-408
development tools P-136 DialogPtr data type 1-407
device 11-175, T-167 DialogRecord data type 1-408
Device~ V-366 DialogSelect function 1-417, N34, P-108, 168
device control entry Il-189, IV-215 DialogTemplate data type 1-423
device driver I-13, ll-175, N56, T-22, 168 DialogTilndl data type I-424
event I-244, T-38, 39 DialogTPtr data type 1-424
for a desk accessory I-443 Dmad.Mount function 11-396, N70, P-34, 168
structure Il-187 DiffRgn procedure 1-184
writing your own II-193 DIFonnat function 11-398
device handler ID V-365 DILoad procedure 11-396
device information, in graphics port record P-68 dimmed
deviceID IV-217 control I-313
devicel/O menu item 1-342, 343
Macintosh SE C12-6 menu tide 1-342
Macintosh II Cl-5 Dlnfo data type IV-105
Device Manager I-13, Il-173, IV-213, V-421, DiICreate function IV-146
T-22, 168, 189 direct devices V-134
routines 11-177, V-427 directory IV-89, T-155
device control entry access Il-189 ID IV-92
for writing drivers 11-194 name IV-90
high-level 11-178 record IV-172
low-level 11-180 Directoiy()ffset field C8-8
device package IV-217 dirID N77
device partition map IV-292 disabled
device resource file T-133 dialog/alert item I-405
Device Servers N20 menu 1-342, 358
DeviceList V-118 menu item I-349, 358
diaeresis T-158 Disableitem procedure 1-358, V-245, P-104,
dial I-312, T-54 168
dialog box I-66, 399, P-105, T-14, 47, 53, 56 Discipline Nll7
Close IV-10 discontinuous selection 1-40
closing P-107 disk controller card (for Macintosh SE) Cl6-2.
creating your own IV-74 See also cards (Macintosh SE); Macintosh
color in P-106 SE
editing text in P-110 address allocation C16-9
handling events in P-107 block diagram C16-3
opening P-107 bus control signals C16-5
types of P-106 device select decode~ C16-9
dialog color table V-278 DMA operations C16-8
dialog filter N34 Macintosh SE interface logic C16-5
dialog hook N47 PIO timing C16-7
dialog item list V-279 system configuration C16-2
Dialog Manager I-12, 397, IV-59, V-277, disk controller card (for Macintosh Il) Cl0-15.
P-105, 107, T-20,48,54,56,97, 188 See also cards (NuBus); Macintosh II;
routines I-411, IV-59, V-283 NuBus
dialog pointer 1-407 block diagram Cl0-17
FMOutPtr data type 1-227 four-tone synthesizer U-223, 226, T-170, 172
FMOutput data type 1-227 FPMove N137
FMSwapFont function 1-223 FP68K See Floating-Point Arithmetic Package
FmtDefaults global variable IV-241 FracCos function IV-64
'FOBJ' resource N29 FracDiv function IV-64
folder Il-85, IV-105, T-155 FracMul function IV-64
'FOND' resource IV-29, V-181, 185 FracSin function IV-64
font T-69, 78,93, 102 FracSqrt function IV-64
font association table IV-38, T-105 Fract type IV-63
font characterimtion table 1-225 FractEnable global variable IV-32, N72, N92
Font/DA Mover IV-31, N6, N23, T-77, 103, fractional character widths IV-33, T-104, 107
105 fractional pen positioning V-84
Font Manager 1-11, 215, IV-27, V-179, T-19, Frac2Fix function IV-65
72, 102, 187 Frac2X function IV-65
communication with QuickDraw 1-224, IV- fragmentation N39, P-47, 49
33 fmme T-177
data sttuctures IV-34 ALAP Il-264
routines 1-222, IV-31, V-180 check sequence Il-265
Font menu 1-60, 353 header Il-264
'FONT' resource IV-29, 44, V-181, N30 picture 1-158
fonts 1-60, 151, 217, IV-29, N92 pointer (stack) 1-96
characters 1-220 serial communication 11-246
family IV-29, T-104 stack 1-96, 11-17
format 1-227 trailer 11-264
height 1-228, ·T-109 window 1-271
number 1-217, 219, IV-30, T-102 FrameArc procedure 1-180
QuickDraw and P-82 FrameOval procedure 1-177
record 1-230, IV-35 FramePoly procedure 1-192
rectangle 1-228 FrameRect procedure 1-176
resource IV-42, T-104 FrameRgn procedure 1-186
format 1-234 FrameRoundRect procedme 1-178
ID 1-234 framing error 11-246
scaling 1-220, IV-33, T-104, 106, 119 free block T-147
script V-298 free memory block 11-10
size 1-153, 217, T-103 free-fonn synthesizer 11-223, 228, T-170, 172
variable IV-56 free-form wave T-171
Fontinfo data type 1-173 FreeAlert procedure 1-420, V-285
FontMetrics procedure IV-32 FreeDialog procedure 1-415, V-284
FontRec data type 1-231 FreeMem function 11-38
FontScript function V-314 FreeWave data type 11-228
FontSize menu 1-61 'FREF cdev resource V-327
Font2Script function V-315 'FREF resource N29, N48
ForeColor procedure 1-173, N73 frequency 11-223, T-171
fork 1-105, Il-81, IV-93, T-68 FrontWindow function 1-286
format block V-437, CS-4, 5 FScaleDisable global variable 1-222, IV-32,
Format field CS-7 N92
fonnauing hierarchical volumes IV-240 FSClose function 11-94, IV-112, P-132, 133,
Forttan T-245 171
Fortran-77 T-245 FSCreate P-131, 171
400Kdisk T-163 FSDelete function 11-97, IV-113
400K volume T-162 FSFCBLen global variable IV-97, N66
four-tone record Il-227 FSOpen function 11-91, IV-109, P-131, 171
K
L
KanjiTalk Nl38, T-111
KbdLast variable V-367
KbdType variable V-367 LActivate procedure IV-276
'KCHR' resource V-190, N160 LAddColumn function IV-271
26 Index I: Generalindex
Index/: Genera/Index
multita.Wng T-206, 238 NewPtr function 1-75, 79, 11-36, P-51, 177
Munger function 1-468 NewRgn function 1-181, P-85, 177
Musical Instrument Digital Interface (MIDI) V- NewString function 1-468
475, 496, T-173 NewWindow function 1-282, P-95, 178
MyCallBack procedure V-480 'NFNT resource IV-30, V-181, 183
MyModifier fwiction V-480 NGetTrapAddress function IV-234, Nl56
Nil pointers P-165
96-pin connector
Macintosh SE and Cl4-6
N Macintosh n and C7-3
/NMRQ C2-4, S, C3-3, 11, C6-2
node 11-263, T-179
name lookup Il-266 ID 11-263
Name-Binding Protocol 11-266, N9, T-183 noErr P-40, 129
assembly language 11-319 noGrowDocProc P-92
Pascal Il-298 non-aligned MC68020 access C3-16
names directory Il-266 non-aligned reads C3-16
names infonnation socket Il-266 non-aligned writes C3-16
names table 11-266, 321 nonblind transfer T-227
NBP See Name-Binding Protocol nonbreaking space 1-246
NBP tuple Il-266 non-master request C3-3
NBPConfirm function Il-301, N9 nonrelocatable block 1-75, Il-10, P-47, T-147
NBPExtract function Il-300 allocating II-36
NBPExtract function V-515 out-of-memory conditions and P-57
NBPLoad function 11-301 reltming II-36
NBPLookup function Il-300, N9, N20 note alen P--106, 107, T-59
NBPRegister function Il-299, N20 note synthesizer V-475, T-173
NBPRemove function 11-301 NoteAlen function 1-420, V-284, P-109, 178
NBPSetEntity procedure V-514 'nrct' cdev resource V-327
NBPSetNTE procedure V-515 'nrct' resoun:e V-329
NBPUnload function 11-301 NSendRequest function V-514
neg7£bFreeErr Nl51 NSetTrapAddress procedure IV-234
network event 1-244, 11-275, T-38, 39 nsvErr N24
NetworkFtle'System (NFS) T-247 NuBus T-5, 20'J See also cards (NuBus);
network number 11-265 Macintosh II
networkEvt Nl42 address space C4-3
network-visible entity Il-265, T-181 arbitration CS-2
New command 1-56 bit and byte structure C4-7
NewCDialog function V-283 block read ttansaction C3-13
NewControl function 1-319, P-112, 114, 177 block write ttansaction C3-14
NewCWindow function V-207 connector pin assignments C6-5
NewDialog function 1-412, P-107, 177 data ttansfer C3-2
NewEmptyHandle function IV-78 defmitions C2-7
NewGDevice function V-122 design examples CI0-2
NewHandle function 1-76, 80, 11-32, N7, implementation rules C3-l l
Nl17, P-51, 177 interface architecture C 1-8
newline character Il-84, IV-95 interrupt mechanism C3-l l
newline mode 11-84, IV-95 interrupt operations C3-l l
NewMenu function 1-351, P-102, 103 licensing requirements CI-4
NewPalette function V-161 overview C2-2
NewPixMap function V-70 power budget C6-6
NewPixPat function V-72 read 1ransaction C3-7
Index.I: Generallndex 29
Inside Macintosh X-Ref
30 Index I: Generallndex
Index/: Generallndex
36 Index I: Generallndex
Index I: General Index
38 Index I: Generallndex
Index I: General Index
111is appendix lists all the routines that may move or purge blocks in the heap. As described in
Inside Macintosh, Volume II, chapter l, calling these routines may cause problems if a handle has
been dereferenced. None of these routines may be called from within an interrupt, such as in a
completion routine or a VBL task.
The Pascal name of each routine is shown, except for a few cases where there's no Pascal interface
corresponding to a particular trap; in those cases, the trap macro name is shown instead (without its
initial underscore character).
SetWmColor TECut
SetWiide TEDeactivate
sExec 1EDelete
SFGetFile TEDispose
SFPGetFile TEFromScrap
SFPPutFile TEGetHeight
SFPutFile TEGetOffset
sGetBlock TEGetPoint
sGetcString TEGetStyle
sGetDriver TEGetrext
ShowControl TEidle
ShowDitem 1Elnit
ShowHide TElnsert
ShowWindow TEKey
ShutDwnlnstall TENew
ShutDwnRemove TEPaste
SizeControl TEPinScroll
Si7.CWmdow TEReplaceStyle
Smal1Fract2Fix TEScroll
SndAddModifier TESelView
SndDisposeChannel TESetJust
SndNewChannel TESetSelect
sPrimarylnit TESetStyle
StartSound TESetrext
Status TestControl
StdArc TEStyllnsert
StdBits TEStylNew
StdComment TEStyIPaste
StdLine TEToScrap
StdOval TEUpdate
StdPoly TextBox
StdPutPic TextWidth
StdRect TickCount
StdRgn TrackBox
StdRRect TrackControl
StdText TrackGoAway
StdTxMeas Transliterate
StillDown UnionRgn
StopAlert UnloadScrap
StopSound UnloadSeg
StringToNum UpdtControl
StringWidth UpdtDialog
SysBeep ValidRect
SysEnor ValidRgn
SystemClick WaitMouseUp
SystemEdit XorRgn
SystemMenu ZeroScrap
TEActivate ZoomWindow
TEAutoView
TECalText
TEQick
TECopy
This appendix lists the trap macros for the Toolbox and Operating System routines and their
corresponding trap word values in hexadecimal. The "Name" column gives the trap macro name
(without its initial underscore character). In those cases where the name of the equivalent Pascal call
is different, the Pascal name appears indented under the main entry. The routines in Macintosh
packages are listed under the macros they invoke after pushing a routine selector onto the stack; the
routine selector follows the Pascal routine name in parentheses.
There are two tables. The first is ordered alphabetically by name; the second is ordered numerically
by trap number, for use when debugging. The trap number is the last two digits of the trap word
unless the trap word begins with A9, in which case the trap number is 1 followed by the last two
digits of the trap word, or AA, in which case the trap number is 2 followed by the last two digits of
the trap word.
Note: The Operating System Utility routines GetTrapAddress and SetTrapAddress take a trap
number as a parameter, not a trap word.
Warning: Traps that aren't currently used by the system are reserved for future use.
System Traps 63
Inside Macintosh X-Ref
64 System Traps
System Traps
System Traps 65
Inside MacintoshX-Ref
66 System Traps
System Traps
System Traps 67
Inside MacintoshX-Ref
68 System Traps
System Traps
System Traps 69
Inside MacintoshX-Ref
70 System Traps
System Traps
System Traps 71
Inside MacintoshX-Ref
72 System Traps
System Traps
System Traps 73
Inside Macintosh X-Re/
74 System Traps
System Traps
System Traps 75
Inside Macintosh X-Re/
76 System Traps
System Traps
System Traps 77
Inside MacintoshX-Ref
78 System Traps
System Traps
System Traps 79
Inside Macintosh X-Ref
80 System Traps
System Traps
System Traps 81
Inside Macintosh X-Ref
82 System Traps
APPENDIX C: GLOBAL VARIABLES
This appendix gives an alphabetical list of all system global variables described in Inside
Macintosh, along with their locations in memory.
Name Location Contents
ABusVars $2D8 Pointer to AppleTalk variables
ACmmt $A9A Stage number (0 through 3) oflast alert (word)
ANumber $A98 Resource ID oflast alert (word)
ApFontID $984 Font number of application font (word)
ApplLlmit $130 Application heap limit
ApplScratch $A78 12-byte scratch area resetved for use by applications
ApplZone $2AA Address of application heap zone
AppPannHandle $AEC Handle to Fmder infonnation
AtMenuBottom $AOC Flag for menu scrolling (word)
AuxWmHead $COO Auxiliary window list header (long)
BootDrive $210 Working directory reference number for system startup volume
(word)
BufPtr $10C Address of end of jump table
BuffgDate $304 File tags buffer: date and time of last modification (long)
BuITgFBkNum $302 File tags buffer: logical block number (word)
BuITgFFlg $300 File tags buffer: flags (word: bit l=l if resource fork)
BuffgFNum $2FC File tags buffer: file number (long)
CaretTune $2F4 Caret-blink intetval in ticks (long)
CPUflag $12F Microprocessor in use (word)
Crst'fhresh $8EC Mouse-scaling threshold (word)
CurActivate $A64 Pointer to window to receive activate event
CurApName $910 Name of current application (length byte followed by up to 31
characters)
CurApRefNum $900 Reference number of current application, s resource file (word)
CurDeactive $A68 Pointer to window to receive deactivate event
CurDirStore $398 Directory ID of directory last opened (long)
CurITOffset $934 Offset to jump table from location pointed to by AS (word)
CurMap $ASA Reference number of current resource file (word)
CurPageOption $936 Sound/screen buffer configuration passed to Chain or Launch
(word)
Global Variables 83
Inside Macintosh X-Re/
84 Global Variables
Global Variables
Global Variables 85
Inside Macintosh X-Ref
86 Global Variables
Global Variables
Global Variables 87
Inside MacintoshX-Ref
88 Global Variables
GLOSSARY
access path: A description of the route that the File Manager follows to access a file; created when
a file is opened.
access path buffer: Memory used by the File Manager to ttansfer data between an application
and a file.
acknowledge cycle: For the NuBus: Last period of a transaction during which I ACK is asserted
by a slave responding to a master. Often shortened to ack cycle.
action procedure: A procedure, used by the Control Manager function TrackControl, that
defines an action to be perfonned repeatedly for as long as the mouse button is held down.
activate event: An event generated by the Window Manager when a window changes from active
to inactive or vice versa.
active control: A control that will respond to the user's actions with the mouse.
active end: In a selection, the location to which the insertion point moves to complete the
selection.
active window: The fronttnost window on the desktop.
ADD device table: A structure in the system heap that lists all devices cormected to the Apple
DeskTop Bus.
address: A number used to identify a location in the computer's address space. Some locations are
allocated to memory, others to 1/0 devices.
address mark: In a sector, infonnation that's used internally by the Disk Driver, including
infonnation it uses to detennine the position of the sector on the disk.
ALAP: See AppleTalk Link Acc~ss Protocol
ALAP frame: A packet of data transmitted and received by ALAP.
ALAP protocol type: An identifier used to match particular kinds of packets with a particular
protocol handler.
alert: A warning or report of an error, in the fonn of an alert box, sound from the Macintosh's
speaker, or both.
alert box: A box that appears on the screen to give a warning or report an error during a
Macintosh application.
alert template: A resource that contains infonnation from which the Dialog Manager can create an
alert.
alert window: The window in which an alert box is displayed.
alias: A different name for the same entity.
Glossary 89
Inside Macintosh X-Ref
90 Glossary
Glossary
ascent line: A horizontal line that coincides with the tops of the tallest characters in a font.
asynchronous communication: A method of data transmission where the receiving and
sending devices don't share a common timer, and no timing data is transmitted.
asynchronous execution: After calling a routine asynchronously, an application is free to
perfonn other tasks until the routine is completed.
at-least-once transaction: An ATP transaction in which the requested operation is perfonned at
least once, and possibly several times.
ATP: See AppleTalk Transaction Protocol
auto-key event: An event generated repeatedly when the user presses and holds down a character
key on the keyboard or keypad.
auto-key rate: The rate at which a character key repeats after it's begun to do so.
auto-key threshold: The length of time a character key must be held down before it begins to
repeat
auxiliary control record: A Control Manager data structure containing the infonnation needed
for drawing controls in color.
auxiliary window record: A Window Manager data structure that stores the color infonnation
needed for each color window.
background activity: A program or process that runs while the user is engaged with another
application.
background procedure: A procedure passed to the Printing Manager to be run during idle times
in the printing process.
base line: A horizontal line that coincides with the bottom of each character in a font, excluding
descenders (such as the tail of a "p").
baud rate: The measure of the total number of bits sent over a transmission line per second.
Binary-Decimal Conversion Package: A Macintosh package for converting integers to
decimal strings and vice versa.
bit image: A collection of bits in memory that have a rectilinear representation. The screen is a
visible bit image.
bit map: A set of bits that represent the position and state of a corresponding set of items; in
QuickDraw, a pointer to a bit image, the row width of that image, and its boundary rectangle.
BIU (bus interface unit): For the Macintosh II: The electronics connecting the MC68020 bus
to the NuBus.
block: A group regarded as a unit; usually refers to data or memory in which data is stored. See
allocation block and memory block.
block contents: The area that's available for use in a memory block.
Glossary 91
Inside Macintosh X-Ref
block device: A device that reads and writes blocks of bytes at a time. It can read or write any
accessible block on demand
block header: The internal "housekeeping" info1D1ation maintained by the Memory Manager at
the beginning of each block in a heap zone.
block map: Same as volume allocation block map.
board sResource list: A standard Apple sResource list that must be present in every NuBus slot
card that communicates with the Paris.
boundary rectangle: A rectangle, defined as pan of a QuickDraw bit map, that encloses the
active area of the bit image and imposes a coordinate system on it Its top left comer is always
aligned around the fust bit in the bit image.
break table: A list of templates that determine the general rules for making word divisions in a
particular script
break: 1be condition resulting when a device maintains its transmission line in the space state for
at least one frame.
bridge: An intelligent link between two or more AppleTal.k networlcs.
broadcast service: An ALAP seIVice in which a frame is sent to all nodes on an AppleTalk
network.
bundle: A resource that maps local IDs of resources to their actual resource IDs; used to provide
mappings for file references and icon lists needed by the Finder.
bus free phase: The phase in which no SCSI device is actively using the bus.
button: A standard Macintosh control that causes some immediate or continuous action when
clicked or pressed with the mouse. See also radio button
byte lane: Any of the four bytes that make up the NuBus data width. NuBus slot cards may use
any or all of the byte lanes to communicate with each other or with the Paris.
byte swapping: The process by which the order of bytes in each 4-byte NuBus word is changed
to confonn to the byte order of certain processors.
card-generic driver: A driver that is designed to work with a variety of plug-in cards.
card-specific driver: A driver that is designed to work with a single model of plug-in card.
caret-blink time: The inteJVal between blinks of the caret that marks an insertion point.
caret: A generic tenn meaning a symbol that indicates where something should be inserted in text.
The specific symbol used is a vertical bar ( I ).
catalog tree file: A file that maintains the relationships between the files and directories on a
hieran:hical directory volume. It corresponds to the file directory on a flat directory volume.
cdev: A resource file containing device infonnation, used by the Control PaneL
92 Glossary
Glossary
cell: The basic component of a list from a strucwral point of view; a cell is a box in which a list
element is displayed.
cGrafPort: The drawing environment in Color QuickDraw, including elements such as a pixel
map, pixel patterns, transfer modes, and arithmetic drawing modes.
channel: A queue that's used by an application to send commands to the Sound Manager.
character code: An integer representing the character that a key or combination of keys on the
keyboard or keypad stands for.
character device: A device that reads or writes a stream of characters, one at a time. It can neither
skip characters nor go back to a previous character.
character image: An arrangement of bits that defines a character in a font
character key: A key that generates a keyboard event when pressed; any key except Shift, Caps
Lock, Command, or Option.
character offset: 1be horizontal separation between a character rectangle and a font rectangle.
character origin: The point on a base line used as a reference location for drawing a character.
character position: An index into an array containing text, starting at 0 for the first character.
character rectangle: A rectangle enclosing an entire character image. Its sides are defined by the
image width and the font height
character style: A set of stylistic variations, such as bold, italic, and underline. 1be empty set
indicates plain text (no stylistic variations).
character width: 1be distance to move the pen from one character's origin to the next character's
origin.
check box: A standard Macintosh control that displays a setting, either checked (on) or unchecked
(off). Clicking inside a check box reverses its setting.
Chooser: A desk accessory that provides a standard interface for device drivers to solicit and
accept specific choices from the user.
chunky: A pixel image in which all of a pixel's bits are stored consecutively in memory, all of a
row's pixels are stored consecutively, and rowBytes indicates the offset from one row to the next
clipping: Limiting drawing to within the bounds of a particular area.
clipping region: Same as clipRgn.
clipRgn: The region to which an application limits drawing in a grafPort.
clock chip: A special chip in which are stored parameter RAM and the current setting for the date
and time. This chip is powered by a battery when the system is off, thus preseiving the infonnation
close routine: The part of a device driver's code that implements Device Manager aose calls.
closed driver: A device driver that cannot be read from or written to.
Glossary 93
Inside MacintoshX-Re/
closed file: A me without an access path. Cosed files cannot be read from or written to.
clump: A group of contiguous allocation blocks. Space is allocated to a new file in clumps to
promote me contiguity and avoid fragmentation.
clump size: The number of allocation blocks to be allocated to a new me.
Color Look-Up Table (CLUT): A data suucture that maps color indices, specified using
QuickDraw, into actual color values. Color Look-Up Tables are internal to certain types of video
cards.
Color Look-Up Table device: This kind of video device contains hardware that converts an
arbitrary pixel value stored in the frame buffer to some actual ROB video value, which is
changeable.
Color Manager: The part of the Toolbox that supplies color-selection support for Color
QuickDraw on the Macintosh n.
Color QuickDraw: The part of the Toolbox that performs color graphics operations on the
Macintosh n.
color table animation: Color table animation involves changing the index entries in the video
device's color table to achieve a change in color, as opposed to changing the pixel vaJ.ues
themselves. All pixel values corresponding to the altered index entries suddenly appear on the
display device in the new color.
color table: A set of colors is grouped into a QuickDraw data suucture called a color table.
Applications can pass a handle to this color table in order to use color entries.
command phase: The phase in which the SCSI initiator tells the target what operation to
perfonn.
compaction: The process of moving allocated blocks within a heap zone in order to collect the
free space into a single block.
complement: The numerical amount that must be added to a number to give the least number
containing one more digit
completion routine: Any application-defined code to be executed when an asynchronous call to
a routine is completed.
content region: The area of a window that the application draws in.
control: An object in a window on the Macintosh screen with which the user, using the mouse,
can cause instant action with visible results or change settings to modify a future action.
Control Manager: The partofthe Toolbox that provides routines for creating and manipulating
controls (such as buttons, check boxes, and scroll bars).
control definition function: A function called by the Control Manager when it needs to perfonn
type-dependent operations on a particular type of control, such as drawing the control.
control dermition ID: A number passed to control-creation routines to indicate the type of
control. It consists of the control definition function's resource ID and a variation code.
94 Glossary
Glossary
Glossary 95
Inside Macintosh X-Ref
default button: In an alert box or modal dialog, the button whose effect will occur if the user
presses Return or Enter. In an alert box, it's boldly outlined; in a modal dialog, it's boldly outlined
or the OK button.
default directory: A directory that will be used in Flle Manager routines whenever no other
directory is specified. It may be the root directory, in which case the default directory is equivalent
to the default volume.
default volume: A volume that will receive 1/0 during a File Manager routine call, whenever no
other volume is specified.
deny modes: Ftle access modes that include both the access rights of that path and denial of
access to others.
dereference: To refer to a block by its master pointer instead of its handle.
descent: The vertical distance from a font's base line to its descent line.
descent line: A horizontal line that coincides with the bottoms of the characters in a font that
extend funhest below the base line.
Desk Manager: The part of the Toolbox that supports the use of desk accessories from an
application.
desk accessory: A "mini-application", implemented as a device driver, that can be run at the
same time as a Macintosh application.
desk scrap: The place where data is stored when it's cut (or copied) and pasted among
applications and desk accessories.
desktop: The screen as a surface for doing work on the Macintosh.
Desktop tile: A resource file in which the Finder stores the version data, bundle, icons, and file
references for each application on the volume.
destination rectangle: In TextEdit, the rectangle in which the text is drawn.
device: A part of the Macintosh, or a piece of external equipment, that can transfer infonnation
into or out of the Macintosh.
device address: A value in the range $00-$0F assigned to each device connected to the Apple
DeskTop Bus.
device control entry: A 40-byte relocatable block of heap space that tells the Device Manager the
location of a driver's routines, the location of a driver's 1/0 queue, and other information.
device driver event: An event generated by one of the Macintosh's device drivers.
device driver: A program that controls the exchange of infolDlation between an application and a
device.
device handler ID: A value that identifies the kind of device connected to the Apple DeskTop
Bus.
96 Glossary
Glossary
DeviceList: A linked list containing the gDevice records for a system. One handle to a gDevice
record is allocated and initialized for each video card found by the system.
Device Manager: The part of the Operating System that supports device 1/0.
device partition map: A data structure that must be placed at the start of physical block 1 of an
SCSI device to enable it to perfonn Macintosh system startup. It describes the allocation of blocks
on the device.
device resource rde: An extension of the printer resource file, this file contains all the resources
needed by the Chooser for operating a particular device (including the device driver code).
dial: A control with a moving indicator that displays a quantitative setting or value. Depending on
the type of dial, the user may be able to change the setting by dragging the indicator with the mouse.
dialog: Same as dialog box.
dialog box: A box that a Macintosh application displays to request infonnation it.needs to
complete a colllllland, or to report that it's waiting for a process to complete.
Dialog Manager: 1be part of the Toolbox that provides routines for implementing dialogs and
alerts.
dialog record: The intemal representation of a dialog, where the Dialog Manager stores all .the
infonnation it needs for its operations on that dialog.
dialog template: A resowce that oontains infonnation from which the Dialog Manager can create
a dialog.
dialog window: The window in which a dialog box is displayed.
dimmed: Drawn in gray rather than black
direct device: A video device that ha$ a direct correlati()n between the value placed in the video
card and the color you see on the screen.
directory ID: A unique n\Ullbcr assigned to a directory, which the Flle Manager uses to
distinguish it from other directories on the volume. (It's functionally equivalent to the file number
assigned to a file; in fact, both directory IDs and file numbers are assigned from the same set of
numbers.)
directory: A subdivision of a volume that can contain files as well as other directories; equivalent
to a folder.
disabled: A disabled menu item or menu is one that cannot be chosen; the menu item or menu title
appears dimmed. A diS.abled iteQl Qi a dialog or alert box has no effect when clicked.
Disk Driv~r: The device driver that controls data storage ~d retrieval on 3 1/2-inch disks.
Disk Initialization Package: A Macintosh package for initializing and naming new disks; called
by the Standard Ftle Package.
disk-Inserted event: An event generated when the user inserts a disk in a disk drive or takes any
other action that requires a volume to be mounted.
Glossary 97
Inside MacintoshX-Ref
display rectangle: A rectangle that determines where an item is displayed within a dialog or alert
box.
dithering: A technique for mixing existing colors together to create the illusion of a third color
that may be unavailable on a particular device.
document window: The standard Macintosh window for presenting a document
double-click time: The greatest interval between a mouse-up and mouse-down event that would
qualify two mouse clicks as a double-click.
draft printing: Printing a document immediately as it's drawn in the printing grafPort.
drag delay: A length of time that allows a user to drag diagonally aero~ a main menu, moving
from a submenu title into the submenu itself without the submenu disappearing.
drag region: A region in a window frame. Dragging inside this region moves the window to a
new location and makes it the active window unless the Command key was down.
drive number: A number used to identify a disk drive. The internal drive is number l, the
external drive is number 2, and any additional drives will have larger numbers.
drive queue: A list of disk drives connected to the Macintosh.
drive queue: A list of disk drives connected to the Macintosh.
driver descriptor map: A data structure that must be placed at the start of physical block 0 of an
SCSI device to enable it to perfonn Macintosh system startup. It identifies the various device drivers
on the device.
driver VO queue: A queue containing the parameter blocks of all 1/0 requests for one device
driver.
driver name: A sequence of up to 255 printing characters used to refer to an open device driver.
Driver names always begin with a period (.).
driver reference number: A number from -1 to -32 that uniquely identifies an individual device
driver.
Echo Protocol: An echoing service provided on static socket number 4 (the echoer socket) by
which any correctly-fonned packet will be echoed back to its sender.
edit record: A complete editing environment in TextEdit, which includes the text to be edited, the
grafPort and rectangle in which to display the text, the arrangement of the text within the rectangle,
and other editing and display infonnation.
empty handle: A handle that points to a NIL master pointer, signifying that the underlying
relocatable block has been purged.
empty shape: A shape that contains no bits, such as one defined by only a single point.
end-of-file: See logical end-of-file or physical end-of-file.
entity name: An identifier for an entity, of the fonn object:type@zone.
98 Glossary
Glossary
event: A notification to an application of some occurrence that the application may want to
respond to.
event code: An integer representing a particular type of event
Event Manager: See Toolbox Event Manager or Operating System Event Manager.
event mask: A parameter passed to an Event Manager routine to specify which types of events the
routine should apply to.
event message: A field of an event record containing infonnation specific to the particular type of
event
event queue: The Operating System Event Manager's list of pending events.
event record: 1be internal representation of an event, through which your program learns all
pertinent infonnation about that event.
exactly-once transaction: An ATP transaction in which the requested operation is perfonned
only once.
exception: An error or abnonnal condition detected by the processor in the course of program
execution; includes interrupts and traps.
exception vector: One of 64 vectors in low memory that point to the routines that are to get
control in the event of an exception.
extent: A series of contiguous allocation blocks.
extent descriptor: A description of an extent, consisting of the number of the first allocation
block of the extent followed by the length of the extent in blocks.
extent record: A data record, stored in the leaf nodes of the extents tree file, that contains three
extent descriptors and a key identifying the record.
extents tree file: A file that contains the locations of the files on a volume.
external reference: A reference to a routine or variable defined in a separate compilation or
assembly.
family record: A data structure, derived from a family resource, that contains all the infonnation
describing a font family. ·
tile: A named, ordered sequence of bytes; a principal means by which data is stored and
transmitted on the Macintosh.
file catalog: A hierarchical file directory.
file control block: A fixed-length data strucrure, contained in the file-control-block buffer, where
infonnation about an access path is stored.
file directory: The part of a volume that contains descriptions and locations of all the files and
directories on the volume. There are two types of file directories: hierarchical file directories and flat
file directories.
Glossary 99
Inside Macintosh X-Ref
file VO queue: A queue containing parameter blocks for all J/0 requests to the File Manager.
File Manager: The part of the Operating System that supports file J/O.
file name: A sequence of up to 255 printing characters, excluding colons (:), that identifies a file.
file number: A unique number assigned to a file, which the File Manager uses to distinguish it
from other files on the volume. A me number specifies the file's entry in a file directory.
file reference: A resource that provides the Fmder with file and icon infonnation about an
application
file tags: Information associated with each logical block, designed to allow reconsnuction of files
on a volume whose directory or other file-access infonnation has been destroyed.
file tags bufTer: A location in memory where file tags are read from and written to.
file type: A four-character sequence, specified when a file is created, that identifies the type of
file.
file-control-block bufTer: A nonrelocatable block in the system heap that contains one file
control block for each access path.
Finder Information: Information that the Finder provides to an application upon starting it up,
telling it which documents to open or print.
fixed device: A video device that converts a pixel value to some actual RGB video value, but the
hardware colors can't be changed.
fixed-point number: A signed 32-bit quantity containing an integer pan in the high-order word
and a fractional part in the low-order word.
fixed-width font: A font whose characters all have the same width.
Floating-Point Arithmetic Package: A Macintosh package that supports extended-precision
arithmetic according to IEEE Standard 754.
font: A complete set of characters of one typeface, which may be restricted to a particular size and
style, or may comprise multiple sizes, or multiple sizes and styles, as in the context of menus.
font characteri7.ation table: A table of parameters in a device driver that specifies how best to
adapt fonts to that device.
font family: A group of fonts of one basic design but with variations like weight and slant
font height: The vertical distance from a font's ascent line to its descent line.
Font Manager: The part of the Toolbox that supports the use of various character fonts for
QuickDraw when it draws text
font number: The number by which you identify a font to QuickDraw or the Font Manager.
font record: A data structure, derived from a font resource, that contains all the infonnation
describing a font
100 Glossary
Glossary
font rectangle: The smallest rectangle enclosing all the character images in a font, if the images
were all superimposed over the same character origin.
font script: The script used by the font currently designated by thePort; hence the system that
detennines in what fonn text characters are displayed to the user.
font size: The size of a font in points; equivalent to the distance between the ascent line of one line
of text and the ascent line of the next line of single-spaced text
for~: One of the two parts of a file; see data fork and resource fork
format block: A structure in a declaration ROM that provides a standard entry point for other
structures in the ROM. ·
four-tone record: A data structure describing the tones produced by a four-tone synthesizer.
four-tone synthesizer: The part of the Sound Driver used to make simple hannonic tones, with
up to four "voices" producing sound simultaneously.
frame: The time elapsed from the start bit to the last stop bit during serial communication.
frame butTer: A buffer memory in which is stored all the picture elements (pixels) of a frame of
video infonnation.
Frame Buffer Controller (FBC): A register-controlled CMOS gate array used to generate and
control video data and timing signals.
frame check sequence: A 16-bit value generated by the AppleTalk hardware, used by the
receiving node to detect transmission errors.
frame header: Infomiation at the beginning of a packet.
frame pointer: A pointer to the end of the local variables within a routine's stack frame, held in
an address register and manipulated with the LINK and UNLK instructions.
frame trailer: Infonnation at the end of an ALAP frame.
framed shape: A shape that's drawn outlined and hollow.
framing error: The condition resulting when a device doesn't receive a stop bit when expected.
free block: A memory block containing space available for allocation.
free-form synthesizer: The part of the Sound Driver used to make complex music and speech.
frequency: The number of cycles per second (also called hertz) at which a wave oscillates.
full pathname: A pathname beginning from the root directory.
full-duplex communication: A method of data transmission where two devices transmit data
simultaneously.
gamma table: A table that compensates for nonlinearities in a monitor's color response.
Glossary 101
Inside MacintoshX-Ref
gDevice: A QuickDraw data structure that allows an application to access a given device. A
gDevice is a logical device, which the software treats the same whether it is a video card, a display
device, or an offscreen pixel map.
global coordinate system: The coordinate system based on the top left comer of the bit image
being at (0,0).
global width table: A data structure in the system heap used by the Font Manager to
communicate fractional .character widths to QuickDraw.
go-away region: A region in a window frame. Clicking inside this region of the active window
makes the window close or disappear.
grafPort: A complete drawing environment, including such elements as a bit map, a subset of it in
which to draw, a character font, patterns for drawing and erasing, and other pen characteristics.
graphics device: A video card, a printer, a display device, or an offscreen pixel ~ap. Any of
these device types may be used with Color QuickDraw.
GrayRgn: The global variable that in the multiple screen desktop describes and defines the
desktop, the area on which windows can. be dragged.
grow image: The image pulled around when the user drags inside the grow region; whatever is
appropriate to show that the window's size will change.
grow region: A window region, usually within the content region, where dragging changes the
size of an active window.
grow zone function: A function supplied by the application program to help the Memory
Manager create free space within a heap zone.
handle: A pointer to a master pointer, which designates a relocatable block in the heap by double
indirection.
hardware overrun error: The condition that occurs when the SCC's buffer becomes full.
heap: The area of memory in which space is dynamically allocated and released on demand, using
the Memory Manager.
heap zone: An area of memory initialized by the Memory Manager for heap allocation.
hierarchical menu: A menu that includes, among its various menu choices, the ability to display
a submenu. In most cases the submenu appears to the right of the menu item used to select it, and is
marked with a filled triangle indicator.
highlight: To display an object on the screen in a distinctive visual way, such as inverting it
horizontal blanking interval: The time between the display of the righbnost pixel on one line
and the leftmost pixel on the next line.
hotSpot: The point in a cursor that's aligned with the mouse location.
VO queue: See driver VO queue or file VO queue-
102 Glossary
Glossary
VO request: A request for input from or output to a file or device driver; caused by calling a File
Manager or Device Manager routine asynchronously.
icon: A 32-by-32 bit image that graphically represents an object, concept, or message.
icon list: A resource consisting of a list of icons.
icon number: A digit from 1 to 255 to which the Menu Manager adds 256 to get the resource ID
of an icon associated with a menu item.
image width: The width of a character image.
inactive control: A control that won't respond to the user's actions with the mouse. An inactive
control is highlighted in some special way, such as dimmed.
inactive window: Any window that isn't the fronnnost window on the desktop.
indicator: The moving part of a dial that displays its current setting.
initiator device: An SCSI device that initiates a communication by asking another device
(known as the target device) to perfonn a certain operation.
input driver: A device driver that receives serial data via a serial port and transfers it to an
application.
insertion point: An empty selection range; the character position where text will be inserted
(usually marked with a blinking caret).
interface routine: A routine called from Pascal whose purpose is to trap to a certain Toolbox or
Operating System routine.
International Utilities Package: A Macintosh package that gives you access to country-
dependent infonnation such as the fonnats for numbers, currency, dates, and times.
internet: An interconnected group of AppleTalk networks.
internet address: The AppleTalk address and network number of a socket.
interrupt: An exception that's signaled to the processor by a device, to notify the processor of a
change in condition of the device, such as the completion of an 1/0 request
interrupt handler: A routine that services interrupts.
interrupt priority level: A number identifying the importance of the interrupt It indicates which
device is interrupting, and which interrupt handler should be executed.
interrupt vector: A pointer to an interrupt handler.
invalidation: When a color table is modified, its inverse table must be rebuilt, and the screen
should be redrawn to take advantage of this new infonnation. Rather than being reconsbUcted when
the color table is changed, the inverse table is marked invalid, and is automatically rebuilt when next
accessed.
inverse table: A special Color Manager data structure arranged in such a manner that, given an
arbitrary RGB color, the pixel value can be very rapidly looked up.
Glossary 103
Inside Macintosh X-Ref
104 Glossary
Glossary
leading: 1be amount of blank vertical space between the descent line of one line of text and the
ascent line of the next line of single-spaced text
ligature: A character that combines two letters.
line-height table: A TextEdit data structure that holds vertical spacing infotmation for an edit
record's text.
List Manager: The part of the Operating System that provides routines for creating, displaying,
and manipulating lists.
list definition procedure: A procedure called by the List Manager that detennines the
appearance and behavior of a list.
list element: The basic component of a list from a logical point of view, a list element is simply
bytes of data. In a list of names, for instance, the name Melvin might be a list element
list record: The internal representation of a list, where the List Manager stores all the infotmation
it requires for its operations on that list
list separator: The character that separates numbers, as when a list of numbers is entered by the
user.
local coordinate system: 1be coordinate system local to a grafPort, imposed by the boundary
rectangle defined in its bit map.
local ID: A number that refers to an icon list or file reference in an application's resource file and
is mapped to an actual resource ID by a bundle.
Glossary 105
Inside Macintosh X-Ref
Mi.D.I. synthesizer: This synthesizer interfaces with extemal synthesizers via a Musical
Instrument Data Interface (M.I.D.I.) adaptor connected to the serial ports.
magnitude: 1be vertical distance between any given point on a wave and the horizontal line about
which the wave oscillates.
main event loop: In a standard Macintosh application program, a loop that repeatedly calls the
Toolbox Event Manager to get events and then responds to them as appropriate.
main screen: On a system with multiple display devices, the screen with the menu bar is called
the main screen.
main segment: The segment containing the main program.
mark state: The state of a transmission line indicating a binary 1.
mark: A marker used by the File Manager to keep track of where it is during a read or write
operation. It is the position of the next byte in a file that will be read or written.
master directory block: Part of the data structure of a flat directory volume; contains the
volume infonnation and the volume allocation block map.
master pointer: A single pointer to a relocatable block, maintained by the Memory Manager and
updated whenever the block is moved, purged, or reallocated. All handles to a relocatable block
refer to it by double indirection through the master pointer. ·
Memory Manager: The part of the Operating System that dynamically allocates and releases
memory space in the heap.
memory block: An area of contiguous memory within a heap zone.
menu: A list of menu items that appears when the user points to a menu title in the menu bar and
presses the mouse button. Dragging through the menu and releasing over an enabled menu item
chooses that item.
menu bar: The horizontal strip at the top of the Macintosh screen that contains the menu titles of
all menus in the menu list
menu definition procedure: A procedure called by the Menu Manager when it needs to perfonn
type-dependent operations on a particular type of menu, such as drawing the menu.
menu entry: An entry in a menu color table that defines color values for the menu's title, bar, and
items.
menu ID: A number in the menu record that identifies the menu.
menu item: A choice in a menu, usually a command to the current application.
menu item number: The index, starting from l, of a menu item in a menu.
menu list: A list containing menu handles for all menus in the menu bar, along with infonnation
on the position of each menu.
Menu Manager: The part of the Toolbox that deals with setting up menus and letting the user
choose from them.
106 Glossary
Glossary
menu record: 1be internal representation of a menu, where the Menu Manag~r stores all the
infoimation it needs for its operations on that menu.
menu title: A word or phrase in the menu bar that designates one menu.
message phase: The phase in which the target sends one byte of message infoimation back to the
initiator.
missing symbol: A character to be drawn in case of a request to draw a character that's missing
from a particular font
modal dialog: A dialog that requires the user to respond before doing any other work on the
desktop.
modeless dialog: A dialog that allows the user to work elsewhere on the desktop before
responding.
modifier: A program that interprets and processes Sound Manager commands as they pass
through a channel
modifier key: A key (Shift, Caps Lock, Option, or Command) that generates no keyboard events
of its own, but changes the meaning of other keys or mouse actions.
mounted volume: A volume that previously was inserted into a disk drive and had descriptive
infoimation read from it by the File Manager.
mouse-down event: An event generated when the user presses the mouse button.
mouse scaling: A feature that causes the cursor to move twice as far during a mouse stroke than
it would have otherwise, provided the change in the cursor's position exceeds the mouse-scaling
threshold within one tick after the mouse is moved.
mouse-scaling threshold: A number of pixels which, if exceeded by the sum of the horizontal
and vertical changes in the cursor position during one tick of mouse movement, causes mouse
scaling to occur (if that feature is turned on); noimally six pixels.
mouse-up .event: An event generated when the user releases the mouse button.
Name-Binding Protocol (NBP): An AppleTalk protocol that's a DDP client, used to convert
entity names to their internet socket addresses.
name lookup: An NBP operation that allows clients to obtain the internet addresses of entities
from their names.
names directory: The union of all name tables in an internet.
names information socket: The socket in a node used to implement NBP (always socket
number2).
names table: A list of each entity's name and internet address in a node.
NBP tuple: An entity name and an internet address.
NBP: See Name-Binding Protocol
Glossary I 07
Inside MacintoshX-Ref
offspring: For a given directory, the set of files and directories for which it is the parent.
on-line volume: A mounted volume with its volume buffer and descriptive infonnation
contained in memory.
open driver: A driver that can be read from and written to.
open tile: A file with an access path. Open files can be read from and written to.
open permission: Information about a file that indicates whether the file can be read from,
written to, or both.
open routine: The part of a device driver's code that implements Device Manager Open calls.
Operating System: The lowest-level software in the Macintosh. It does basic tasks such as UO,
memory management, and interrupt handling.
Operating System Event Manager: 1be part of the Operating System that reports hardware-
related events such as mouse-button presses and keystrokes.
108 Glossary
Glossary
Operating System Utilities: Operating System routines that perfonn miscellaneous tasks such
as getting the date and time, finding out the user's preferred speaker volume and other preferences,
and doing simple string comparison.
output driver: A device driver that receives data via a serial port and transfers it to an application.
overrun error: See hardware overrun error and software overrun error.
Package Manager: The part of the Toolbox that lets you access Macintosh RAM-based
packages.
package: A set of routines and data types that's stored as a resource and brought into memory
only when needed. ·
page rectangle: The rectangle marking the boundaries of a printed page image. The boundary
rectangle, portRect, and clipRgn of the printing grafPort are set to this rectangle.
palette: A collection of small symbols, usually enclosed in rectangles, that represent operations
that can be selected by the user. Also, a collection of colors provided and used by your application
according to your needs.
Palette Manager: The part of the Toolbox that establishes and monitors the color environment of
the Macintosh II. It gives preference to the color needs of the front window, making the assumption
that the front window is of greatest interest to the user.
pane: An independently scrollable area of a window, for showing a different part of the same
document
panel: An area of a window that shows a different interpretation of the same part of a document
paper rectangle: The rectangle marldng the boundaries of the physical sheet of paper on which a
page is printed.
parameter block: A data stnlcture used to ttansfer infonnation between applications and certain
Operating System routines.
parameter RAM: In the clock chip, 20 bYtes where settings such as those made with the Control
Panel desk accessory are preserved.
parent: For a given file or directory, the directory immediately above it in the tree.
parent ID: The directory ID of the directory containing a file or directory.
parity bit: A data communications bit used to verify that data bits received by a device match the
data bits transmitted by another device.
parity error: 1be condition resulting when the parity bit received by a device isn't what was
expected.
part code: An integer between 1 and 253 that stands for a particular part of a control (possibly the
entire control).
partial pathname: A pathname beginning from any directory other than the root directory.
Glossary 109
Inside Macintosh X-Ref
path reference number: A number that uniquely identifies an individual access path; assigned
when the access path is created.
pathname: A series of concatenated directory and file names that identifies a given file or
directory. See also partial pathnameand full pathname.
pattern: An 8-by-8 bit image, used to define a repeating design (such as stripes) or tone (such as
gray).
pattern transfer mode: One of eight transfer modes for drawing lines or shapes with a pattern.
period: 1be time elapsed during one complete cycle of a wave.
phase: Some fraction of a wave cycle (measured from a fixed point on the wave).
physical end-of-file: The position of one byte past the last allocation block of a file; equal to 1
more than the maximum number of bytes the file can contain.
physical size: The actual number of bytes a memory block occupies within its heap zone.
picture: A saved sequence of QuickDraw drawing commands (and, optionally, picture comments)
that you can play back later with a single procedure call; also, the image resulting from these
commands.
picture comments: Data stored in the definition of a picture that doesn't affect the picture's
appearance but may be used to provide additional infonnation about the picture when it's played
back.
picture frame: A rectangle, defined as part of a picture, that surrounds the picture and gives a
frame of reference for scaling when the picture is played back.
PIO (programmed input/output): An interfacing technique where the processor directly
accesses registers assigned to 1/0 devices by executing processor instructions. Memory mapped 1/0
port registers are addressed as memory locations.
pixel: A dot on a display screen. Pixel is short for picture element.
pixel map: Color QuickDraw's extended data structure, containing the dimensions and content of
a pixel image, plus infonnation on the image's storage fonnat, depth, resolution, and color usage.
pixel pattern: The pattern structure used by Color QuickDraw, one of three types: old-style
pattern, full color pixel pattern, or ROB pattern.
pixel value: The bits in a pixel, taken together, fonn a number known as the pixel value. Color
QuickDraw represents each pixel on the screen using one, two, four, or eight bits in memory.
plane: The front-to-back position of a window on the desktop.
point: The intersection of a horizontal grid line and a vertical grid line on the coordinate plane,
defined by a horizontal and a vertical coordinate; also, a typographical tenn meaning approximately
1n2 inch.
110 Glossary
Glossary
pop-up menu: A menu not located in the menu bar, which appears when the user presses the
mouse button in a particular place.
port: See grafPort
portBits: The bit map of a grafPort.
portRect: A rectangle, defined as part of a gratPort, that encloses a subset of the bit map for use
by the grafPort.
post: To place an event in the event queue for later processing.
prime routine: The part of a device driver's code that implements Device Manager Read and
Write calls.
print record: A record containing all the infonnation needed by the Printing Manager to perfonn a
particular printing job.
Printer Driver: The device driver for the currently installed printer.
printer resource file: A file containing all the resources needed to run the Printing Manager with
a particular printer.
Printing Manager: The routines and data types that enable applications to communicate with the
Printer Driver to print on any variety of printer via the same interface.
printing grafPort: A special grafPort customi7.ed for printing instead of drawing on the screen.
processor priority: Bits 8-10 of the MC68000's status register, indicating which interrupts will
be processed and which will be ignored.
proportional font: A font whose characters all have character widths that are proportional to their
image width.
protocol: A well-defined set of communications rules.
protocol handler table: A list of the protocol handlers for a node.
protocol handler: A software process in a node that recognizes different kinds of frames by their
ALAP type and services them.
purge: To remove a relocatable block from the heap, leaving its master pointer allocated but set to
NIL.
purge bit: A bit in the master pointer to a relocatable block that indicates whether the block is
currently purgeable.
purge warning procedure: A procedure associated with a particular heap zone that's called
whenever a block is purged from that zone.
purgeable block: A relocatable block that can be purged from the heap.
queue: A list of identically structured entries linked together by pointers.
Glossary 111
Inside MacintoshX-Ref
QuickDraw: The part of the Toolbox that perfonns all graphic operations on the Macintosh
screen.
radio button: A standard Macintosh control that displays a setting, either on or off, and is part of
a group in which only one button can be on at a time.
RAM: The Macintosh's random access memory, which contains exception vectors, buffers used
by hardware devices, the system and application heaps, the stack, and other infonnation used by
applications.
range locking: Locking a range of bytes in a file so that other users can't read from or write to
that range, but allowing the rest of the file to be accessed. ·
raw key codes: Hardware-produced key codes on the Macintosh II and Apple Extended
Keyboard, which are translated into virtual key codes by the 'KMAP' resource.
read/write permission: Infonnation associated with an access path that indicates whether the file
can be read from, written to, both read from and written to, or whatever the file's open pennission
allows.
reallocate: To allocate new space in the heap for a purged block, updating its master pointer to
point to its new location.
reference number: A number greater than 0, returned by the Resource Manager when a resource
file is opened, by which you can refer to that file. In Resource Manager routines that expect a
reference number, 0 represents the system resource file.
reference value: In a window record or control record, a 32-bit field that an application program
may store into and access for any purpose.
region: An arbitrary area or set of areas on the QuickDraw coordinate plane. The outline of a
region should be one or more closed loops.
register-based routine: A Toolbox or Operating System routine that receives its parameters and
returns its results, if any, in registers.
relative handle: A handle to a relocatable block expressed as the offset of its master pointer
within the heap zone, rather than as the absolute memory address of the master pointer.
112 Glossary
Glossary
Glossary 113
Inside MacintoshX·Ref
Routing Table Maintenance Protocol (RTMP): An AppleTalk protocol that's used internally
by AppleTalk to maintain tables for routing datagrams through an internet
routing table: A table in a bridge that contains routing infonnation.
row width: The number of bytes in each row of a bit image.
RTMP: See Routing Table Maintenance Protocol
RTMP socket: The socket in a node used to implement RTMP.
RTMP stub: The RTMP code in a nonbridge node.
sampled sound synthesizer: Functionally equivalent to the old free-fonn synthesizer, the
sample sound synthesizer lets you play pre-recorded sounds or sounds generated by your
application.
scaling factor: A value, given as a fraction, that specifies the amount a character should be
stretched or shrunk before it's drawn.
script: A writing system, such as Cyrillic or Arabic. This book is printed in Roman script.
script interface system: Special software that supports the display and manipulation of a
particular script.
SCSI: See Small Computer Standard Interface.
SCSI Manager: The part of thC Operating System that controls the exchange of infonnation
between a Macintosh and peripheral devices connected through the Small Computer Standanl
Interface (SCSI).
sector: Disk space composed of 512 consecutive bytes of standard infonnation and 12 bytes of
file tags.
segment: One of several parts into which the code of an application may be divided. Not all
segments need to be in memory at the same time.
Segment Loader: The part of the Operating System that loads the code of an application into
memory, either as a single unit or divided into dynamically loaded segments.
selection phase: The phase in which the initiator selects the target device that will be asked to
perfonn a certain operation.
114 Glossary
Glossary
selection range: The series of characters (inversely highlighted), or the character position
(marked with a blinking caret), at which the next editing operation will occur.
sequence number: A number from 0 to 7, assigned to an ATP response datagram to indicate its
ordering within the response.
Serial Communications Controller (SCC): The chip that handles serial IJO through the
modem and printer ports.
Serial Driver: A device driver that controls communication, via serial ports, between applications
and serial peripheral devices.
serial data: Data communicated over a single-path communication line, one bit at a time.
sener: A node that manages access to a peripheral device.
service request enable: A bit set by a device connected to the Apple DeskTop Bus to tell the
system that it needs servicing.
session: A session consists of a series of transactions between two sockets, characterized by the
ordedy sequencing of requests and responses. ·
signature: A four-character sequence that uniquely identifies an application to the Finder.
slop: See justification gap.
slot exec parameter block: A data sttucture that provides communication with the Slot
Manager routines sMacBoot and sPrimarylnit
Slot Manager: A set of Macintosh II ROM routines that let applications access declaration ROMs
on slot cards.
slot parameter block: A data structure that provides communication with all Slot Manager
routines except sMacBoot and sPrimarylnit
slot resource: A software sttucture in the declaration ROM of a slot canl.
slot space:The upper one sixteenthofthe total address space. These addresses are in the fonn
$Fsxx xxxx where F, s, and x are hex digits of 4 bits each. This address space is geographically
divided among the NuBus slots according to slot ID number.
Small Computer Standard Interface (SCSI): A specification of mechanical, electrical, and
functional standards for comecting small computers with intelligent peripherals such as hard disks,
printers, and optical disks.
socket: A logical entity within the node of a network.
socket client: A software process in a node that owns a socket.
socket listener: The portion of a socket client that receives and services datagrams addressed to
that socket
socket number: An identifier for a socket.
socket table: A listing of all the socket listeners for each active socket in a node.
Glossary 115
Inside Macintosh X-Ref
software overrun error: The condition that occurs when an input driver's buffer becomes full.
solid shape: A shape that's filled in with any pattern.
Sound Driver: The device driver that controls sound generation in an application.
sound buffer: A block of memory from which the sound generator reads the infonnation to create
an audio wavefonn.
sound procedure: A procedure associated with an aleit that will emit one of up to four sounds
from the Macintosh's speaker. Its integer parameter ranges from 0 to 3 and specifies which sound.
source transfer mode: One of eight transfer modes for drawing text or transferring any bit image
between two bit maps.
space state: The state of a transmission line indicating a binary 0.
spool printing: Writing a representation of a document's printed image to disk or to memory, and
then printing it (as opposed to immediate draft printing).
square-wave synthesizer: The part of the Sound Driver used to produce less hannonic sounds
than the four-tone synthesizer, such as beeps.
116 Glossary
Glossary
status routine: The part of a device driver's code that implements Device Manager Status calls.
stop bit: A serial data communications bit that signals the end of data bits.
structure region: An entire window; its complete "sttucture".
style: See character style.
style dialog: A dialog that sets options affecting the page dimensions; associated with the Page
Setup command.
style record: A TextEdit data structure that specifies the styles for the edit record's text
style scrap: A new TextEdit scrap type, 'styl', is used for storing style information in the desk
scrap along with the old 'TEXT scrap.
style table: A TextEdit data structure that contains one entry for each-distinct style used in an edit
record's text.
subdirectory: Any directory other than the root directory.
submenu delay: The length of time before a submenu appears as a user drags through a
hierarchical main menu; it prevents rapid flashing of submenus. ·
super slot space: The large portion of memory in the range $9000 0000 through $EFFF FFFF.
NuBus addresses of the fonn $sxxx xxxx (that is, $s000 0000 through $sFFF FFFF) reference
the super slot space that belongs to the card in slot s, wheres is an ID digit in the range $9 through
$E. -
synchronous execution: After calling a routine synchronously, an application cannot continue
execution until the routine is completed.
synthesizer: A program which, like a device driver, interprets Sound Manager commands and
produces sound. See tree-form, four-tone, or square-wave synthesizer.
synthesizer buffer: A description of the sound to be generated by a synthesizer.
System Error Handler: The part of the Operating System that assumes control when a fatal
system error occurs.
system error alert table: A resource that determines the appearance and function of system error
alens.
system error alert: An alert box displayed by the System Error Handler.
system error ID: An ID number that appears in a system error alert to identify the error.
system event mask: A global event mask that controls which types of events get posted into the
event queue.
system font: The font that the system uses (in menus, for example). Its name is Chicago.
system font size: The si:ze of text drawn by the system in the system font; 12 points.
system heap: The portion of the heap reserved for use by the Operating System.
Glossary 117
Inside MacintoshX-Re/
system heap zone: The heap zone provided by the Memory Manager for use by the Operating
System; equivalent to the system heap.
system resource: A resource in the system resource file.
system resource file: A resource file containing standard resources, accessed if a requested
resource wasn't found in any of the other resource files that were searched.
system startup information: Certain configurable system parameters that are stored in the first
two logical blocks of a volume and read in at system startup.
system window: A window in which a desk accessory is displayed.
target device: An SCSI device (typically an intelligent peripheral) that receives a request from an
initiator device to perfonn a certain operation.
text styles: TextEdit records used for communicating style infonnation between the application
program and the TextEdit routineS.
TextEdit: The part of the Toolbox that supports the basic text entry and editing capabilities of a
standard Macintosh application.
TextEdit scrap: The place where certain TextEdit routines store the characters most recently cut
or copied from text
theGDevice: When drawing is being perfonned on a device, a handle to that device is stored as a
global variable theG Device.
thousands separator: The character that separates every three digits to the left of the decimal
point.
thumb: The Control Manager's tenn for the scroll box (the indicator of a scroll bar).
tick: A sixtieth of a second.
Time Manager: The part of the Operating System that lets you schedule a routine to be executed
after a given number of milliseconds have elapsed.
Toolbox: Same as User Interface Toolbox.
Toolbox Event Manager: The part of the Toolbox that allows your application program to
monitor the user's actions with the mouse, keyboard, and keypad.
Toolbox Utilities: The part of the Toolbox that perfonns generally useful operations such as
fixed-point arithmetic, stting manipulation, and logical operations on bits.
track: Disk space composed of 8 to 12 consecutive sectors. A track corresponds to one ring of
constant radius around the disk.
transaction: A request-response communication between two ATP clients. See transaction
request and transaction response.
transaction ID: An identifier assigned to a transaction.
118 Glossary
Glossary
transaction request: The initial part of a transaction in which one socket client asks another to
perfo1m an operation and return a response.
transaction response: The concluding part of a transaction in which one socket client returns
requested infonnation or simply confinns that a requested operation was perfoimed.
Transcendental Functions Package: A Macintosh package that contains trigonometric,
logarithmic, exponential, and financial functions, as well as a random number generator.
transfer mode: A specification of which Boolean operation QuickDraw should perfoim when
drawing or when transferring a bit image from one bit map to another.
trap dispatch table: A table in RAM containing the addresses of all Toolbox and Operating
System routines in encoded foim.
trap dispatcher: The part of the Operating System that examines a trap word to detennine what
operation it stands for, looks up the address of the corresponding routine in the trap dispatch table,
and jumps to the routine.
trap macro: A macro that assembles into a trap word, used for calling a Toolbox or Operating
System routine from assembly language.
trap number: The identifying number of a Toolbox or Operating System routine; an index into the
trap dispatch table.
Glossary 119
Inside MacintoshX-Ref
User Interface Toolbox: The software in the Macintosh ROM that helps you implement the
standard Macintosh user interface in your application.
user bytes: Four byteS in an ATP header provided for use by ATP's clients.
valence: The number of offspring for a given directory.
validity status: A number stored in parameter RAM designating whether the last attempt to write
there was successful. ('The number is $A8 if so.)
variation code: The part of a window or control definition ID that distinguishes closely related
types of windows or controls.
VBL task: A task perfonned during the vertical retrace intenupt.
vector table: A table of interrupt vectors in low memory.
Versatile Interface Adapter (VIA): The chip that handles most of the Macintosh's 1/0 and
interrupts.
version data: In an application's resource file, a resource that has the application's signature as its
resource type; typically a string that gives the name, version number, and date of the application.
version number: A number from 0 to 255 used to distinguish between files with the same name.
Vertical Retrace Manager: The part of the Operating System that schedules and executes tasks
during the vertical retrace interrupt
vertical blanking interrupt: See vertical retrace interrupt.
vertical blanking interval: The time between the display of the last pixel on the bottom line of
the screen and the first one on the top line.
vertical retrace interrupt: An interrupt generated 60 times a second by the Macintosh video
circuitry while the beam of the display tube returns from the bottom of the screen to the top; also
known as vertical blanking interrupt
vertical retrace queue: A list of the tasks to be executed during the vertical retrace interrupt.
VIA: See Versatile Interface Adapter.
view rectangle: In TextEdit, the rectangle in which the text is visible.
virtual key codes: The key codes that appear in keyboard events. (See also raw key codes.)
visible control: A control that's drawn in its window (but may be completely overlapped by
another window or other object on the screen).
visible window: A window that's drawn in its plane on the desktop (but may be completely
overlapped by another window or object on the screen).
visRgn: The region of a gratPort, manipulated by the Window Manager, that's actually visible on
the screen.
120 Glossary
Glossary
volume: A piece of storage medium fonnatted to contain files; usually a disk or part of a disk. A
3.5-inch Macintosh disk is one volume.
volume allocation block map: A list of 12-bit entries, one for each allocation block, that
indicate whether the block is cunently allocated to a file, whether it's free for use, or which block is
next in the file. Block maps exist both on flat directory volumes and in memory.
volume attributes: Information contained on volumes and in memory indicating whether the
volume is locked, whether it's busy (in memory only), and whether the volume control block
matches the volume infonnation (in memory only).
volume bit map: A data structure containing a sequence of bits, one bit for each allocation block,
that indicate whether the block is allocated or free for use. Volume bit maps exist both on
hierarchical directory volumes and in memory.
volume buffer: Memory used initially to load the master directory block, and used thereafter for
reading from files that are opened without an access path buffer.
volume control block: A nonrelocatable block that contains volume-specific infonnation,
including the volume information from the master directory block.
volume index: A number identifying a mounted volume listed in the volume-control-block
queue. The first volume in the queue has an index of l, and so on.
volume information block: Part of the data structure of a hierarchical directory volume; it
contains the volume infonnation.
volume information: Volume-specific information contained on a volume, including the volume
name and the number of files on the volume.
volume name: A sequence of up to 27 printing characters that identifies a volume; followed by a
colon (:) in Ftle Manager routine calls, to distinguish it from a file name.
volume reference number: A unique number assigned to a volume as it's mounted, used to
refer to the volume.
volume-control-block queue: A list of the volume control blocks for all mounted volumes.
wave table synthesizer: Similar to the old four-tone synthesizer, the wave table synthesizer
produces complex sounds and multi-part music.
waveform description: A sequence of bytes describing a wavefonn.
waveform: The physical shape of a wave.
wavelength: The horizontal extent of one complete cycle of a wave.
window: An object on the desktop that presents infonnation, such as a document or a message.
window class: In a window record, an indication of whether a window is a system window, a
dialog or alert window, or a window created directly by the application.
window definition function: A function called by the Window Manager when it needs to
perfonn certain type-dependent operations on a particular type of window, such as drawing the
window frame.
Glossary 121
Inside MacintoshX-Re/
window definition ID: A number passed to window-creation routines to indicate the type of
window. It consists of the window definition function's resource ID and a variation code.
window frame: The structure region of a window minus its content region.
window list: A list of all windows ordered by their front-to-back positions on the desktop.
Window Manager: 1be part of the Toolbox that provides routines for creating and manipulating
windows.
Window Manager port: A grafPort that has the entire screen as its portRect and is used by the
Window Manager to draw window frames.
window record: The internal representation of a window, where the Window Manager stores all
the infomation it needs for its operations on that window.
window template: A resource from which the Window Manager can create a window.
word wraparound: Keeping words from being split between lines when text is drawn.
word-selection break table: A break table that is used to find word boundaries for word
selection, spelling checking, and so on.
word-wrapping break table: A break table that is used to find word boundaries for screen
wrapping of text.
working directory: An alternative way of referring to a directory. When opened as a worldng
directory, a directory is given a working directory reference number that's used to referto it in File
Manager calls.
working directory control block: A data snucture that contains the directory ID of a worldng
directory, as well as the volume reference number of the volume on which the directory is located.
working directory reference number: A temporary reference number used to identify a
working directory. It can be used in place of the volume reference number in all File Manager calls;
the Ftle Manager uses it to get the directory ID and volume reference number from the worldng
directory control block.
workstation: A node through which a user can access a seiver or other nodes.
write data structure: A data structure used to pass infonnation to the ALAP or DDP modules.
X-Ref: An abbreviation for cross-reference.
zone: An arbitrary subset of AppleTalk networks in an internet See also heap zone.
zone header: The internal "housekeeping" infonnation maintained by the Memory Manager at the
beginning of each heap zone.
zone pointer: A pointer to a zone record.
zone record: A data structure representing a heap zone.
zone trailer: A minimum-size free block marking the end of a heap zone.
122 Glossary
Inside Macintosh X-Ref
Welcome to the world of programming for the Macintosh.GD No other pel'BCll181 computer bas been as enthusiastically received by the
programming community, and the large-ad growing4ody of Macintosh software attests to this. The Macintosh programming books
provide lhe guidelines and cedmical infonnation you'll need to develop Macintosh programs, but there are many other resources that can help
speed and simplify your development dfons.
The AppleProgrammer'sand Developer'sAssoclatlon
Whether you are a programmer, enthusiast. or make your living developing Apple-campatible products, you need fast access to the latest
technical infonnation and development tools.Now there's a source for you: The Apple Programmer's and Developer's Association (APDA).
An independent organization sponsored by Apple Computer, APDA is the one-stop source for lhe Apple programmer. Members get timely and
easy access to tedmical information and tools that will speed your developnent efforts.
Whether you 're looking fm programming tools, tedmical notes, or manuals, you have a single, convenient source. All these
materials-including seleded products and materials from Apple and ocher vendors-ere available to APDA members with one simple phone
call. Here are some of the producas you'll be able to order as an APDA member:
• Tools, system software, teduucal notes, and manuals for the Apple GD Il and Macintosh computers.
• Language products from companies such as Think Technologies, Borland, and Consulair.
• Teclmical books, including the entire Apple Technical library from Add.ism-Wesley.
APDA was created to serve the needs of the entire Apple programming community. For membership information, please contact:
APDA
290 SW 43rd Street
Renton, WA 98055
(206) 2Sl-6S48
AppleUnk: APDA
MCI: 312-7449
CompuServe 73527,'n
Programs for the Commercial Developer
If your primuy business is developing software products for canmercial markets, we strongly suggest that you investigate the Apple
Certified Developer Program, an aggressive program designed to help independent software developers get products to market quickly and
successfully. For information, wrile to:
Developer Progiams
Apple Computer, Inc.
MJS'n-W
20S2S Mariani Avenue
Cupertino, CA 95014
Developer Tools
You won't have to look far to find a development language that suits your specific requirements. A large family of Macintosh languages will
serve yaur development needs, whether your expertise is in Pascal, Assembler, C, FORTII, FOR1RAN, COBOL, BASIC, Logo, Lisp,
Modula, or one of many Olhen. And lhe infonnation comained in lnsitk Macintosh can be applied to any of these Janguages.
Apple offers a munber of special products essential to Macintosh programmers. Available through APDA, they include:
• Apple's Macintosh Programmer's Wmkshop (MPW) and MacAppN development system products.
• Macintosh utilities, example programs, and soun:e code.
• Preliminuy drafts of technical documentation.
• Latest versions of the Macintosh system software.
Apple is constantly updating the tools and utilities you need. Beccrne an APDA member and you'll be kept infonned of their availability.
Technical Notes
Macintosh Technical Notes are published on a bi-monthly basis. Available through APDA, user groups, developer consoniums, and electronic
infonnation services, they provide timely and helpful informatiClll, programming hints, and example code to he1p make your programming
efforts more creative and productive.
Want More Information?
Apple bas put together an information packet that includes:
• Infonnatioo about independent and Apple-sponsored programs for Apple developers.
• Support rescurc:es for developen, including names and addresses of Macintosh user groups, developer consortiums, and electronic
services that cater to yaur special needs.
• A mrrent list of Apple and third-party progranuning languages.
• Other materials of interest to the Apple developer.
1bis package is yours for the asking. Simply send your request to:
Apple Computer, Inc.
MIS 37-S
20S2S Mariani Avenue
Cupertino, CA 95014
,
About the cover: This design represents a new look for me original edition of Inside Macintosh
X-Ref, and me other books in tl1e Apple Tedmical Library. The contents have not been changed.
Printed in USA.
50995
Apple Computer, Inc.
20525 Mariani AYenue
Cupertino, CA 95014
(408) 9%-1010
TI..xln-576 9 780 20 1 19265 0
Addison·Wesley Publishing Company, Inc. I SBN 0 - 201-19265-9