Index

Symbols

#define

TARGET_API_MAC_CARBON 66

#if defined(powerc) 65

#pragma export 82

'ckid' 230, 287

'mcvs' 230, 287

'rseg' resource 36

(ToolServer Tools) folder 360

.dump 114

.exp file 80

.r files 110

.rsrc 112

.xSYM 312, 313

__A5__ macro 207

__abs() 253

__ALTIVEC__ macro 207, 209

__APPLE__ macro 210

__ARCHITECTURE__ macro 210

__BIG_ENDIAN__ macro 209

__cntlzw() 254

__DYNAMIC__ macro 210

__eieio() 252

__fabs() 253

__fnabs() 253

__fourbyteintegers__ macro 207

__IEEEdoubles__ macro 208

__isync() 252

__labs() 253

__lhbrx() 253

__lwbrx() 253

__MACH__ macro 210

__MACOS__ macro 208, 210

__MC68020__ macro 208

__MC68881__ macro 208

__MC68K__ macro 208

__NATURAL_ALIGNMENT__ macro 210

__OPTIMIZE__ macro 210

__pixel 212

__powerc macro 209

__POWERPC__ macro 209

__ppc__ macro 210

__profile 311

__rlwimi() 254

__rlwinm() 254, 255

__rlwnm() 254

__setflm() 253

__STATIC__ macro 210

__sthbrx() 253

__stwbrx() 253

__sync() 252

__VEC__ macro 209

__vector 212

~ (C++). See destructors (C++)

'cfrg' 312

'MDEF' 315

'rsrc' 114

'SIZE' resource 63

'XCMD' resources 314

Numerics

32-bit clean applications 196

4-Byte Ints option, 68K Processor panel 157, 275

4D extensions 314

68020 Codegen option

68K Processor panel 157

68020 Codegen option, 68K Processor panel 282

68881 Codegen option

68K Processor panel 158

68881 Codegen option, 68K Processor panel 283

68K A4-based application 68

68K A5-based application 69

68K Disassembler panel

Only Show Operands and Mnemonics 183

Show Name Table 194

68K Linker panel

Generate SYM File 174

Generate VRSAVE Instructions 174

Merge Compiler Glue into Segment 1 180

68K Processor panel

68020 Codegen 157

68881 Codegen 158

MacsBug Symbols 179

68K Target panel

CFM68K library option 160

Extended Resource 167

RSEG Application 191

8-Byte Doubles option 157, 158, 277

A

A4 globals 314

A4 register 68

A4 Relative Data 71

A4 relative data option, 68K Target panel 159

A4Stuff.h 103

A5 globals 314

A5 register 69

A5 Relative Data 71

A5 relative data option, 68K Target panel 159

__abs() 253

accelerated resource 385

acceptAppDiedEvents 196

acceptSuspendResumeEvents 195

adding

file mapping 344

align pragma 215

align_array_ pragma 215

alignment 219-221

Alignment option

Rez panel 159

All Globals 82

allocating variables for 68K 279

Altivec 159, 174, 201, 385

Altivec Programming Model 159

Altivec, definition of 385

altivec.h 210

AltiVec

vector types 211

always_inline pragma 215

ANSI Keywords Only 232

ANSI Strict 232

ANSI_strict pragma 215

AppDied events 196

Apple

Apple Developer Connection 116

Carbon Dater software 118, 119

Carbon Porting Guide 115

CarbonLib 1.1 SDK 116

Apple Developer Connection 116

Apple Events, handling 196

applications

68K 35

background 195

CFM68K 35

choosing libraries for 52-56

Fat 36

PowerPC 36

PPC 36

types of 35, 67

arguments

passing in registers 273

ARM_conform pragma 215

asm blocks not supported 262

asm keyword 232, 261

assembler

stand-alone described 30

syntax 232

See also inline assembler

Assembler Dialect option

PPCAsm panel 160

assembly instructions 174

auto_inline pragma 215

Automatically Launch Applications When SYM File Opened command 308

Automatically Vectorize Code 180

B

back-end compilerþþSee compiler

background application 195

Backup MPW command 352

Balloon Help 343-349

parameter options 346

Balloon Help commands

DIALOG 347

END 348

END-DIALOG 347

END-MENU 348

MENU 348

STR# 349

Balloon Help Compiler 343, 343-349

bfchg assembly statement 271

bfclr assembly statement 271

bfexts assembly statement 271

bfextu assembly statement 271

bfffo assembly statement 271

bfins assembly statement 271

bfset assembly statement 271

bftst assembly statement 271

bitfields

size of 279

Blue Box 385

Blue Box, definition of 385

bool 212

bool pragma 215

bool size 212, 276

Break on C++ Exception command 310

bus error 339

C

C++

exceptions, debugging 310

static constructors 307, 337

static destructors 308

C++ code

debugging 304

calling conventions

registers 273

calling conventions for 68K 278

CallUniversalProc() 107

canBackground 195

Carbon 18, 115, 386

Carbon Porting Guide 115

CarbonLib 116

CarbonLib 1.1 SDK 116

Fat_SillyBalls.report example 118

Mc OS to Carbon

  example 118

porting Mac OS project 118-122

SillyBalls-solution example 118

SillyBalls-start example 118

Carbon Dater, Apple's 118, 119

Carbon porting 115-126

Carbon porting example 118

Carbon Porting Guide 115

CarbonLib 116, 386

CarbonLib 1.1 SDK 116

Case Sensitive

PPCAsm panel 160

CDEF 89

CFM68K 35, 36, 69, 72, 85, 312

applications 69

CFM68K library option

68K Target panel 160

CFM68K library option, 68K Target panel 160

CFM68K panel

Current Versio 164

Expand Uninitialized Data 166

Export Symbols 167

Far Data Threshold 168

Force Indirect Access 172

Fragment Name 172

Global Data Alignment 175

Initialization 177

Library SubFolderID 178

Main 180

Old Definition 183

Old Implementation 183

Share Data 193

Termination 201

CFM-68K Runtime Enabler 35

CFM68K Target panel

RSEG Application 191

char size 212, 276

check_header_ pragma 215

Chooser extensions 89

class specialization

and debugging 309

Classic Mac OS 115, 386

system requirements 26

__cntlzw() 254

Cocoa 386

Code Fragment Manager 35, 312

Code Model option, 68K Processor panel 161

code resource 102

68K globals 103

calling PowerPC 107

choosing libraries for 100-102

creating 92-93, 94-96

creating multi-segment 94-96

creating single-segment 94-96

custom headers 104

debugging 314-316

globals 103

libraries for 68K 100

types of 89

writing 103-108

code resources 387

accelerated resource 385

private resource 388

Code Sorting option, PPC PEF panel 161

code68020 pragma 282

code68881 pragma 283

CodeWarrior

compare to command line 31

compiler architecture 28

compiler described 30

components 28-31

debugger described 30

described 20

development process 31-34

documentation architecture 21

IDE described 29

installing 26-27

linker described 30

stand-alone assembler described 30

tools listed 28

Collapse Unused TOC-reloads option 162

command line 66

command-line and CodeWarrior compared 31

Commando command 361

comments in inline assembler 237, 264

Comments option

Output Flags panel 163

Compare MPW command 352

compiler

architecture 28

back-end for 68K 281-286

back-end for PowerPC 205-219

described 30

other documentation 206

support for inline assembly 231

See also C Compilers Reference

compiling 33

console.stubs.c 66

Constructor 109

constructors

preventing execution of static 308

constructors (C++) 307

debugging 305

Control Definition 89

Control Panel 89

Copy Code Fragments option

Mac OS Merge panel 163

Copy Resources option

Mac OS Merge panel 163

cplusplus pragma 215

cpp_extensions pragma 215

Create alias to Classic executable

Mac OS Packager panel 163

Create PkgInfo file

Mac OS Packager panel 164

Creator

PPC Target panel 164

Current Version option

CFM68K panel 164

PPC PEF panel 164

CustomCRStartup.lib 104

D

Darwin 386

data fork 36, 85

Dead-strip Static Initialization Code option

PPC Linker panel 165

deadstripping unused code 230, 286

Debug_Version 323

debugger

breaking into 338

described 30

log window 295

See also Debugger User Guide

debugger nub

defined 290

Debugger Trap Settings

of MetroNub Settings preference panel (Mac OS) 292

Debugger() 338

Debugger() 292, 294

DebuggerINIT 290

debugging 34, 312

C++ code 304

C++ constructors 305

C++ exceptions 310

class specialization 309

code resources 314-316

Drag Manager 336

exceptions 310

inline functions 308

log window 292

logging DebugStr messages 292, 295

low-level 294

Mac OS Toolbox calls 294

new 305

profiled code 311

reentrant code 315

remote 298-303

shared libraries 312-314

shared library limitations 312

shared library without application SYM file 313

SOM 317-320

static constructors 307

static objects 307

stepping into 306

template classes 309

templates 309

threads 316-317

traps 294

debugging PowerPlant code 304

debuggingdebugging

advanced topics 297-328

DebugNew 320-328

and DebugStr() traps 323

DebugNewSetErrorHandler() 322

DebugNewValidateAllBlocks() 323

DebugNewValidatePtr() 323

disabling 324

memory overhead 326

NEW macro 323

setting up 321

with MW ZoneRanger 326

DebugNewReportLeaks() 324

DebugNewSetErrorHandler()

using 326

DebugNewSetErrorHandler() 322

DebugNewValidateAllBlocks() 323

DebugNewValidatePtr() 323

DebugStr() 338

DebugStr() 292, 294, 323

def_inherited pragma 215

defer_codegen pragma 215

delete (C++). See destructors

derez 113

Derez MPW command 352

destructors (C++) 308

development tools 28-31

device driver 90

DIALOG, Balloon Help command 347

direct_to_som pragma 215

directives, assembler

entry 247

fralloc 248

frfree 249

machine 249

Directory MPW command 352

Disable All Warnings

PPCAsm panel 165

disable_registers pragma 216

Disassemble 114

Disassemble Exception Tables option, PPC Disassembler panel 166

Display Dialog option

PPC Target panel 166

Display Manager aware 196

Display Notice event, handling 196

divs.l assembly statement 271

divsl assembly statement 271

divu.l assembly statement 271

divul assembly statement 271

documentation architecture 21

doesActivateOnFGSwitch 195

dollar_identifiers pragma 216

Don't Inline setting 308, 309

Don't Step Into Runtime Support Code setting 306

dont_inline pragma 216

dont_reuse_ pragma 216

double size 158, 213, 277

Drag Manager

debugging 336

Duplicate MPW command 352

dynamic library 68

E

editing code 33

See also IDE User Guide

__eieio() 252

emulation 337

END, Balloon Help command 348

END-DIALOG, Balloon Help command 347

END-MENU, Balloon Help command 348

entry assembly statement 247

entry directive 247

enumsalwaysints pragma 216

error

bus 339

errorcheck pragma 216

Escape Control Chars option

Rez panel 166

exceptions pragma 216

Execute as ToolServer Script command 360

.exp file 80

Expand Uninitialized Data option

CFM68K panel 166

PPC PEF panel 166

export pragma 82

Export Symbols

CFM68K panel 167

PPC PEF panel 167

Export Symbols pop-up menu 80

extb.l assembly statement 271

Extended Resource

68K Target panel 167

PPC Target panel 167

extended_ pragma 216

extended80 283

extern keyword 67

F

__fabs() 253

Far Data option, 68K Processor panel 168

Far Data Threshold option

CFM68K panel 168

Far Method Tables option, 68K Processor panel 168

Far String Constants option, 68K Processor panel 169

Fast Link option, 68K Linker panel 169

faster_pch_gen pragma 216

FAT 85

fat

code resource 91

Fat applications 36

fat resource 387

FAT shared libraries 85

Fat_SillyBalls.report 118

File Flags

Output Flags panel 169

File locked

Output Flags panel 169

File Mappings 113

adding 344

File MPW command 352

File Name

PPC Target panel 170

Files MPW command 352

Filter Mode option

Rez Panel 170

Finder Flags options

Output Flags panel 170

flags pragma 216

float size 213, 277

float.h 210

float_constants pragma 216

floating point formats for PowerPC 213

Floating Point option, 68K Processor panel 171

floating-point

formats 158

floating-point formats 213, 277

__fnabs() 253

Folder to package

Mac OS Packager panel 171

Force Indirect Access option

CFM68K panel 172

force_active pragma 216

fp_contract pragma 216

fp68k.lib 171

FPSCR 253

Fragment Name option

CFM68K panel 172

PPC PEF panel 172

fralloc assembly statement 239, 266

fralloc directive 248

frfree assembly statement 239, 266

frfree directive 249

Full Path in SYM Files option, 68K Linker panel 172

Full Path in SYM Files option, PPC Linker panel 172

fullpath_prepdump pragma 216

function initialization 266

function level assembly 262

function_align pragma 216

G

gcc_extensions pragma 216

Generate A6 Stack Frames option, 68K Linker panel 172

Generate Link Map option, PPC Linker panel 173

Generate Profiler Information option, 68K Processor panel 174

Generate SYM File option

68K Linker panel 174

PPC Linker panel 174

Generate VRSAVE Instructions options

68K Linker panel 174

PPC Linker panel 174

generating code

for specific 68K processors 281-285

GetDiskFragment 312

getFrontClicks 195

GetMemFragment 312

GetQDGlobalsScreenBits()

Carbon API 124

GetSharedLibrary 312

Global Data Alignment option

CFM68K panel 175

global_optimizer pragma 216

H

Has been inited

Output Flags panel 175

Has bundle

Output Flags panel 175

Has custom icon

Output Flags panel 176

Header Type option, PPC Target panel 176

help text options 346

I

IDE described 29

IEEE floating-point standards 283

ignore_oldstyle pragma 216

import pragma 216

Import Weak option 84

Initialization option

CFM68K panel 177

PPC Linker panel 177

Initialize Before option 84

inline assembler

asm blocks not supported 262

comments 237, 264

defining a function 263

directives 247-251, 268-271

for 68K 271

for PowerPC 231-260

function level support 262

instructions 231, 232, 262, 271

labels 236, 264

local variables 238, 265

operands 240

preprocessor use 237, 264

special PowerPC instructions 235

stack frame 239

syntax 261

using for 68K 261-267

using for PowerPC 246

See also intrinsic functions

inline functions

debugging 308

inline_bottom_up pragma 216

inline_depth pragma 216

installing CodeWarrior 26-27

int size 213, 276

integer formats 211, 275

integer formats for PowerPC 212

integrated development environment (IDE) 31

intermediate representation 28

internal pragma 216

interrupts 315

and debugging 337

intrinsic functions

described 251

for PowerPC 251-260

See also inline assembler 251

Invisible

Output Flags panel 177

IR 28

is32BitCompatable 196

isDisplayManagerAware 196

isHighLevelEventAware 196

isStationeryAware 196

__isync() 252

J

Jasik 293

L

Label

Output Flags panel 177

labels in inline assembler 236, 264

__labs() 253

language extensions for 68K 272-275

launch application

automatically 308

LBroadcaster 305

leaks.log 324, 325

__lhbrx() 253

lib_export pragma 216

libraries

68K 52, 53

A4 68

A5 69

CFM68K 74

for shared libraries 72, 78

MSL names 64

naming 64

PowerPC 54, 55, 56, 74

shared 72-79, 388

Library Folder ID option

PPC PEF panel 178

Library Folder ID option, PPC PEF panel 178

Library SubFolderID option

CFM68K panel 178

Library SubFolderID option, CFM68K panel 178

limits.h 210

Line MPW command 352

line_prepdump pragma 216

Link Column 62

Link Mode option, PPC Linker panel 178

link order 230, 287

Link Single Segment option, 68K Linker panel 178

Linker

Target Settings panel 179

linker

.a files 287

.o files 287

and executable files 287

described 30

for 68K 286-287

for PowerPC 230

multiply defined symbols 287

other documentation 206

linking 33

See also IDE User Guide

local variables in inline assembler 238, 265

localAndRemoteHLEvents 196

Locked 189

Log DebugStr messages setting 292, 295

log window 292, 295

long double size 158, 213, 277

long long

type 243

long long size 213, 276

long size 213, 276

longlong pragma 216

longlong_enums pragma 216

longlong_prepval pragma 216

__lwbrx() 253

M

M68000PM/AD M68000 Family Programmer's Reference Manual 262

Mac OS 337

system requirements 26

Mac OS debugger traps 294

Mac OS Merge panel

Copy Code Fragments 163

Copy Resources 163

Skip Resource Types 196

Suppress Warnings 199

Mac OS Packager panel

Create alias to Classic executable 163

Create PkgInfo file 164

Folder to package 171

Package Creator Type 184

Package File Type 184

Mac OS X 36, 385

Carbon, definition 386

CarbonLib

  definition 386

Classic Mac OS, definition 386

system requirements 26

machine assembly statement 249, 271

machine directive 249

Mach-O 387

macintosh macro 209

macros

207

__A5__ 207

__ALTIVEC__ 207, 209

__APPLE__ 210

__ARCHITECTURE__ 210

__BIG_ENDIAN__ 209

__DYNAMIC__ 210

__IEEEdoubles__ 208

__MACH__ 210

__MACOS__ 208, 210

__MC68020__ 208

__MC68881__ 208

__MC68K__ 208

__NATURAL_ALIGNMENT__ 210

__OPTIMIZE__ 210

__powerpc 209

__POWERPC__ 209

__ppc__ 210

__STATIC__ 210

__VEC__ 209

macintosh 209

macro 207

powerc 208, 209

ppc 210

MacsBug 338

MacsBug Symbols option

68K Processor panel 179

Main option

CFM68K panel 180

PPC Linker panel 180

Make 63

Make Strings ReadOnly option, PPC Processor panel 180

makefiles 32

mark pragma 216

Max String Width option

Rez panel 180

MC68020 processor 36, 282

MC68881 FPU 283

members pragma 216

MENU, Balloon Help command 348

Merge Compiler Glue into Segment 1 option

68K Linker panel 180

Merge into Output 85

Merge to File option, PPC Target panel 181

message pragma 217

MetroNub 290

MetroNub Extension 291

MetroNub Settings panel

Symbolics Settings (Mac OS) 292

MetroNub Settings preference panel 295

Debugger Trap Settings (Mac OS) 292

Window Settings (Mac OS) 292

Metrowerks Standard Libraries 67

Metrowerks Standard LibrariesþþSee MSL

Minimum Heap Size 63

PPC Target panel 181

Mixed Mode Manager 337

modifying

target settings 127-128

monolithic 78

Motorola 385

Velocity Engine, see Altivec 388

MPW

function documentation 365

MPW C Calling Conventions option, 68K Processor panel 181

MPW commands 358

MPW Rez 111

MPW Shell 383

MPW Tools 109, 367-384

choosing libraries for 380-381

running 383

writing 382

mpwc_newline pragma 217

mpwc_relax pragma 217

MSL 66, 67

described 31

See also MSL C Reference, MSL C++ Reference

MSL CustomCRStartup.Lib 101

MSL Runtime68K.A4.Lib 101

MSL Runtime68K.Lib 52, 53

MSL RuntimePPC.DLL 102

muls.l assembly statement 271

multi-fragment 78

multiple symbols and linker 287

multiple targets 57

mulu.l assembly statement 271

MWCRuntime.lib 102

N

Name locked

Output Flags panel 182

naming conventions 64

network

debugger requirements 290

new operator 305

no_static_dtors pragma 217

None 83

nub. <$Italic<$Default Para Font

number formats

floating-point 213

for 68K 275-277

for PowerPC 210-213

integers 212

O

Old Definition option

CFM68K panel 183

PPC PEF panel 183

Old Implementation option

CFM68K panel 183

PPC PEF panel 183

once pragma 217

Only Show Operands and Mnemonics option

68K Disassembler panel 183

only_std_keywords pragma 217

onlyBackground 195

Open Transport 290

OpenGL 387

operands in inline assembler 240

opt_common_subs pragma 217

opt_dead_assignments pragma 217

opt_dead_code pragma 217

opt_lifetimes pragma 217

opt_loop_invariants pragma 217

opt_propagation pragma 217

opt_strength_reduction pragma 215

opt_strength_reduction_strict pragma 215

opt_unroll_loops pragma 215

opt_vectorize_loops pragma 215

optimization_level pragma 217

optimize_for_size pragma 217

optimizing

for 68K 280-281

for PowerPC 214-215

inline assembly disables 233, 262

register coloring 214, 280

Output Directory

Target Settings panel 184

Output Flags Panel

Finder Flags 170

Output Flags panel

Comments 163

File Flags 169

File locked 169

Has been inited 175

Has bundle 175

Has custom icon 176

Invisible 177

Label 177

Name locked 182

Printer Driver is MultiFinder Compatible 187

Resource Map is Read-only 190

Shared 193

Stationery 198

P

Package Creator Type option

Mac OS Packager panel 184

Package File Type option

Mac OS Packager panel 184

PalmOS library option, 68K Target panel 184

parameter pragma 273

PC-Relative Strings option, 68K Processor panel 185

pcrelstrings pragma 275

Peephole Optimization option, PPC Processor panel 185

peephole pragma 215

PEF 84, 387

Perform Typechecking option

PPCAsm panel 186

PhotoShop plugins 314

Photoshop plugins 90

pixel 212

pool_data pragma 215

pool_strings pragma 215

pop pragma 215

porting

Mac OS to Carbon 118-122

porting to Carbon 115-126

Post-Linker

Target Settings panel 186

powerc macro 208, 209

PowerMac Debug Services 290

PowerPC 102

code resources, calling 107

PowerPC intrinsicsþþSee intrinsic functions

PowerPlant 308

viewing source code 308

PowerPlant code

debugging 304

PowerPlant Constructor 109

PPC Disassembler panel

Show Code Modules 194

Show Name Table 194

Show Source Code 194

Show SYM Info 195

Use Extended Mnemonics 203

PPC Linker panel

Dead-strip Static Initialization Code 165

Generate SYM File 174

Generate VRSAVE Instructions 174

Initialization 177

Main 180

Termination 201

Treat Multiple Definitions as Warnings 202

PPC Linker target settings panel 143-201

ppc macro 210

PPC PEF panel 162

Current Version 164

Expand Uninitialized Data 166

Fragment Name 172

Library Folder ID 178

Old Definition 183

Old Implementation 183

Share Data Section 193

PPC PEF target settings panel 144-162

PPC Processor panel

Processor Specific Instructions 187

Profiler Information 188

Schedule Instructions 192

Store Small Static Data in TOC 198

Struct Alignment 198

Target Processor 201

Traceback Tables 201

Use FMADD & FMSUB 203

PPC Target panel

Application pane

  Creator 164  File Name 170  Minimum Heap Size 181  Preferred Heap Size 186  Project Type 188  SIZE Flags 195  Stack Size 197  Type 202

Display Dialog 166

Extended Resource 167

Shared Library pane

  Creator 164  File Name 170  Project Type 188  Type 202

Stub Library pane

  Creator 164  File Name 170  Project Type 188  Type 202

Sym Name 200

ppc_unroll_factor_limit pragma 215

ppc_unroll_instructions_limit pragma 215

ppc_unroll_speculative pragma 215

PPCASm panel

Disable All Warnings 165

PPCAsm panel

Assembloer Dialect 160

Case Sensitive 160

Perform Typechecking 186

Prefix File 186

Symbolic Debugging 200

PPCPEF panel

Export Symbols 167

pragma

for 68K 285

for PowerPC 215

overload 287

pragmas

align 215

align_array_ 215

always_inline 215

ANSI_strict 215

ARM_conform 215

auto_inline 215

bool 215

check_header_ 215

cplusplus 215

cpp_extensions 215

def_inherited 215

defer_codegen 215

direct_to_som 215

disable_registers 216

dollar_identifiers 216

dont_inline 216

dont_reuse_ 216

enumsalwaysints 216

errorcheck 216

exceptions 216

extended_ 216

faster_pch_gen 216

flags 216

float_constants 216

force_active 216

fp_contract 216

fullpath_prepdump 216

function_align 216

gcc_extensions 216

global_optimizer 216

ignore_oldstyle 216

import 216

inline_bottom_up 216

inline_depth 216

internal 216

lib_export 216

line_prepdump 216

longlong 216

longlong_enums 216

longlong_prepval 216

mark 216

members 216

message 217

mpwc_newline 217

mpwc_relax 217

no_static_dtors 217

once 217

only_std_keywords 217

opt_common_subs 217

opt_dead_assignments 217

opt_dead_code 217

opt_lifetimes 217

opt_loop_invariants 217

opt_propagation 217

opt_strength_reduction 215

opt_strength_reduction_strict 215

opt_unroll_loops 215

opt_vectorize_loops 215

optimization_level 217

optimize_for_size 217

peephole 215

pool_data 215

pool_strings 215

pop 215

ppc_unroll_factor_limit 215

ppc_unroll_instructions_limit 215

ppc_unroll_speculative 215

precompile_target 215

profile 215

push 216

readonly_strings 216

require_prototypes 216

RTTI 216

schedule 216

scheduling 216

segment 216

side_effects 216

simple_prepdump 216

SOMCallOptimization 216

SOMCallStyle 216

SOMCheckEnvironment 216

SOMClassVersion 216

SOMMetaClass 216

SOMReleaseOrder 216

static_inlines 216

strings 216

suppress_init_code 216

supress_warnings 216

sym 216

syspath_once 216

toc_data 216

traceback 216

trigraphs 216

unsigned_char 216

unused 216

warn_emptydecl 216

warn_extracomma 217

warn_hidevirtual 217

warn_illpragma 217

warn_implicitconv 217

warn_no_side_effect 217

warn_notinlined 217

warn_padding 217

warn_possunwant 217

warn_resultnotused 217

warn_structclass 217

warn_unusedarg 217

warn_unusedvar 217

warning_errors 216

wchar_type 217

precompile_target pragma 215

preferences

launch applications automatically 308

MetroNub symbolics settings (Mac OS) 292

stepping into runtime code 306

Stop for DebugStrs 295

Preferred Heap Size 63

PPC Target panel 186

Prefix File option

PPCAsm panel 186

Rez panel 186

Pre-Linker

Target Settings panel 187

Preload 189

preprocessing 34

See also IDE User Guide

preprocessor, using in inline assembler 237, 264

preventing execution of static constructors 308

Printer Driver is MultiFinder Compatible

Output Flags panel 187

printf 66

private code resource 91

private resource 388

Processor Specific Instructions 187

Processor Specific Instructions option

PPC Processor panel 187

profile pragma 215

Profiler Information option

PPC Processor panel 188

Profiler Information option, PPC Processor panel 188

Profiler User Guide 188

ProfilerInit()

warning 311

ProfilerTerm()

warning 311

Program window

threads pop-up menu 316

project stationery 128

Project Type

PPC Target panel 170, 188

Project Type option, 68K Target panel 133, 145

projects

adding resource files 110

applications 35, 67

resource files 112

resources 109-114

subprojects 57, 62

prolog 220

Protected option 189

Purgeable 189

push pragma 216

putchar 66

Q

QDFlushPortBuffer()

Carbon API 126

Quark XTensions 314

Quartz 388

R

readonly_strings pragma 216

reference variables (C++) 305

register coloring optimization 214, 280

register variables for 68K 279

register variables for PowerPC 213

registers

floating-point 284

passing arugments in 273

variables 213, 279

remote debugging 298-303

Remove Selected Items 63

require_prototypes pragma 216

Res Type option, PPC Target panel 190

ResEdit 109

ResID option, PPC Target panel 190, 191

Resorcerer 109

resource compiler

decompilation 113

resource files

adding to projects 110

creating 112

project folder 112

Resource Flags option, PPC Target panel 189

Resource Map is Read-only

Output Flags panel 190

Resource Name option, PPC Target 190

resources

'CODE' 35

'rseg' 36

'SIZE' 63

adding 109-114

resume events, handling 195

Rez 113

Rez compiler 110

Rez MPW command 352

Rez panel

Alignment 159

Escape Control Chars 166

Filter Mode 170

Max String Width 180

Prefix File 186

Script Language 192

Rez settings panel 131, 132

__rlwimi() 254

__rlwinm() 254, 255

__rlwnm() 254

rofiler 188

RSEG Application option

68K Target panel 191

CFM68K Target panel 191

rtd assembly statement 271

RTTI pragma 216

Runtime Libraries

MSL CustomCRStartup.Lib 101

MSL Runtime68K.A4.Lib 101

MSL Runtime68K.Lib 52, 53

MSL RuntimePPC.DLL 102

S

SANE 171

SANE.h 283

Save Project Entries Using Relative Paths option

Target Settings panel 191

scan 66

Schedule Instructions option

PPC Processor panel 192

schedule pragma 216

scheduling pragma 216

Script Language option

Rez panel 192

Search MPW command 352

segment pragma 216

SegType option

68K Target panel

  Code Resource pane

SegType 193

SetApplLimit() 197

SetCurrentA4 314

SetCurrentA4() 315

__setflm() 253

SetPortWindowPort()

Carbon API 125

SetQDGlobalsRandomSeed()

Carbon API 124

settings panels

selecting 127

Share Data option

CFM68K panel 193

Share Data option, CFM68K panel 193

Share Data Section option

PPC PEF panel 193

Shared

Output Flags panel 193

Shared libraries 312

shared libraries 72-79, 388

CFM68K 74

choosing libraries 72, 78

creating Fat 75

debugging 312-314

debugging limitations 312

exporting symbols 80-83

FAT 85

PowerPC 74

shared library

debugging without SYM file 313

short double 277

short double size 213, 277

short size 212, 276

Show Code Modules option

PPC Disassembler panel 194

Show Data Modules option, PPC Disassembler panel 194

Show Name Table option

68K Disassembler panel 194

PPC Disassembler panel 194

Show Source Code option

PPC Disassembler panel 194

Show SYM Info option

PPC Disassembler panel 195

side_effects pragma 216

signed char size 212, 276

SillyBallsCarbon-solution 118

SillyBalls-start

Carbon porting example 118

simple_prepdump pragma 216

SIZE Flag 63

SIZE Flags

PPC Target panel 195

'SIZE' flags

acceptAppDiedEvents 196

acceptSuspendResumeEvents 195

canBackground 195

doesActivateOnFGSwitch 195

getFrontClicks 195

is32BitCompatable 196

isDisplayManagerAware 196

isHighLevelEventAware 196

isStationeryAware 196

localAndRemoteHLEvents 196

onlyBackground 195

useTextEditServices 196

Skip Resource Types option

Mac OS Merge panel 196

SOM 317

SOMCallOptimization pragma 216

SOMCallStyle pragma 216

SOMCheckEnvironment pragma 216

SOMClassVersion pragma 216

SOMMetaClass pragma 216

SOMReleaseOrder pragma 216

stack frame in inline assembler 239

Stack Size 197

PPC Target panel 197

stand-alone assembler 30

See also Assembler Guide

Start ToolServer command 354, 366

Startup Code option, 68K Target panel 197

static constructors

debugging 307

preventing execution 308

static destructors 308

static libraries

creating 68-72

types of 68-69

static library 388

static objects

defined 307

static_inlines pragma 216

Stationery

Output Flags panel 198

stationery aware 196

Step Into command (debugger)

constructors 306

stepping

into runtime code 306

__sthbrx() 253

Store Small Static Data in TOC option

PPC Processor panel 198

Store Static Vector Data in TOC option, PPC Processor panel 198

STR# Balloon Help command 349

string literals

PC-relative 274

strings pragma 216

Struct Alignment option

PPC Processor panel 198

struct assembly construct 265

__stwbrx() 253

subprojects 57, 62

Suppress Warning Messages check box 200

Suppress Warning Messages option, PPC Linker panel 200

Suppress Warning of Redeclared Types option 110

Suppress Warnings option

Mac OS Merge panel 199

suppress_init_code pragma 216

supress_warnings pragma 216

suspend events, handling 195

SYM file 309, 312, 313, 314

Sym Name option

PPC Target panel 200

sym pragma 216

Symbolic Debugging option

PPCAsm panel 200

Symbolics Settings

of MetroNub Settings panel (Mac OS) 292

symbols

multiple linker 287

__sync() 252

syspath_once pragma 216

System Folder 291

debugger requirements 290

System Heap 189

System Object Model 317

system requirements 26

T

Target Name

Target Settings panel 200

Target Processor option

PPC Processor panel 201

target settings

modifying 127-128

overview 127-128

See also settings panels

Target Settings panel

Linker 179

Output Directory 184

Post-Linker 186

Pre-Linker 187

Save Project Entries Using Relative Paths 191

Target Name 200

target settings panels 154

68K 154

  68K Target 145

PowerPC

  PPC Linker 143-201  PPC PEF 144-162  Rez 131, 132

Target Settings window 127

TARGET_API_MAC_CARBON 66, 123

targets

multiple 57

template classes

debugging 309

Termination option

CFM68K panel 201

PPC Linker panel 201

Text Edit services, using 196

theListener 305

32-bit clean applications 196

Threads pop-up menu 316

toc_data pragma 216

ToolServer 365-366, 383

installing 353

(ToolServer Tools) folder 360

ToolServer Tools submenu 360

traceback pragma 216

Traceback Tables option

PPC Processor panel 201

Treat Multiple Definitions as Warnings option

PPC Linker panel 202

trigraphs pragma 216

troubleshooting

bus error variables 339

debugger crashes 337

Drag Manager 336

exception handlers 335

Type

PPC Target panel 202

types

long long 243

Types.h 283

U

Universal Procedure Pointer

and debugging 337

unsigned char size 212, 276

unsigned int size 213, 276

unsigned long long size 213, 276

unsigned long size 213, 276

unsigned short size 212, 276

unsigned_char pragma 216

unused pragma 216

UPP

and debugging 337

Use #pragma 82

Use .exp file 80

Use Extended Mnemonics option

PPC Disassembler panel 203

Use FMADD & FMSUB option

PPC Processor panel 203

useTextEditServices 196

V

variable allocation for 68K 279

variables

register 213, 279

vector 212

Velocity Engine 18, 388

viewing

PowerPlant source code 308

virtual function dispatch tables 168

VRSAVE 174

W

warn_emptydecl pragma 216

warn_extracomma pragma 217

warn_hidevirtual pragma 217

warn_illpragma pragma 217

warn_implicitconv pragma 217

warn_no_side_effect pragma 217

warn_notinlined pragma 217

warn_padding pragma 217

warn_possunwant pragma 217

warn_resultnotused pragma 217

warn_structclass pragma 217

warn_unusedarg pragma 217

warn_unusedvar pragma 217

warning_errors pragma 216

wchar_type pragma 217

WDEF 89

what's in this manual 19

what's new 18

where to learn more 22

Window Definitions 89

Window Settings

of MetroNub Settings preference panel (Mac OS) 292

windows

Target Settings 127

X

x80tox96() 283

x96tox80() 283

XCMD resources 314