This manual describes how to use the CodeWarrior toolset to develop applications, libraries, shared libraries, and other executables that operate on the Mac OS.

The introduction includes the following sections:

• Read the Release Notes!-where to go for critical, last-second details
• What's New in This Release-new features since the previous release
• What's in This Manual-a description of the contents of this manual
• CodeWarrior Documentation-a general description of the CodeWarrior documentation architecture
• Where to Go from Here-recommendations for further reading

Read the Release Notes!

Before you use the CodeWarrior IDE or a particular tool, you should read the release notes. They contain important last-minute information about new features, bug fixes, and incompatibilities that may not be included in the documentation.

The release notes directory is always included as part of a standard CodeWarrior installation. The release notes directory is also located at the top level of the CodeWarrior CD.

What's New in This Release

The CodeWarrior product for Mac OS development has some new features. The following are most notable.

Support for Carbon!

Full support for developing Carbon applications. See Application Projects for more information on developing Carbon applications.

PowerPlant and PowerPlant Constructor Carbonized

PowerPlant and the PowerPlant Constructor have been fully carbonized. See The PowerPlant Book, and Constructor for PowerPlant for more details. Also, see the Porting PowerPlant to Carbon Reference for help inporting your non-Carbon PowerPlant applications to be Carbon complient.

Support for Velocity Engine!

Read the release notes on the CD to learn about the new support added for the Velocity Engine (AltiVec), and also refer to the section entitled "C and C++ Support for Power PC," among others.

Remote Debugging Improvements

Changes have been made to remote debugging making it more flexible in multiple debugging environments. You can now specify and save a list of named remote connections, much like an address book of names, which can later be chosen for a debugging session. See the IDE User Guide and Debugger Setup and Options for more details.

MetroNub Improvements

MetroNub now supports debugging applications written to the MacOS 8.6 Multiprocessing 2.0 API. In addition, MetroNub for MP has been merged into MetroNub making for a clean single extension to support different Mac OS debugging environments.

68K Development Notice!

This release of the Metrowerks CodeWarrior toolset is the last release that will support 68K development.

Pascal Development Notice!

This release of the Metrowerks CodeWarrior toolset no longer supports Pascal development.

What's in This Manual

Table 1.1 lists every chapter in this manual, and describes the information contained in each. However, this manual only contains information specific to Mac OS software development. See "CodeWarrior Documentation" for a discussion of how these chapters relate to other CodeWarrior documentation.

Contents of chapters:

Chapter	Description
Introduction	this chapter
Getting Started	installation and setup instructions, and an overview of CodeWarrior
Application Projects	how to create applications
Library Projects	how to create static and shared libraries
Code Resource Projects	how to create code resources
Adding Project Resources	how to add resources to a Mac OS project and use Rez files in your project
Mac OS Target Settings	how to control the compiler and linker
C and C++ Support for Power PC	details of the back-end compiler for PPC Mac OS development
PowerPC Assembler	details of support for inline assembly in the PPC compilers
Support for Motorola 68K	how to control the compiler and linker, details of the back-end compiler for 68K Mac OS development, details of support for inline assembly in the 68K compilers
Debugger Setup and Options	includes details on debugger settings panels for Mac OS
Advanced Debugging	advanced Mac OS-specific debugging issues including Debugging SOM, Threads, and PowerPlant
Troubleshooting	troubleshooting information specific to the Mac OS
Balloon Help Compiler	a plug-in compiler that converts text file descriptions of menu and dialog balloon help into the appropriate help resources
Creating MPW Tool Projects	how to create MPW Tools that can be run under MPW or ToolServer
Using MPW ToolServer with CodeWarrior	covers the use of Toolserver with the IDE
Glossary	terms used in this manual

CodeWarrior Documentation

CodeWarrior is a multi-host, multi-language, multi-target development environment. What does that mean?

Multiple hosts

CodeWarrior runs on several different operating systems, including Windows and Mac OS. The features, human interface, and operation of CodeWarrior is very similar on all hosts.

Multiple languages

You can use CodeWarrior to program in several languages, including C/C++, and Java. Third-party compilers provide support for other languages, such as Fortran. The languages available to you depend upon the target for which you are developing software.

Multiple targets

You can use CodeWarrior to write software for several different chips or operating systems. CodeWarrior products support programming for a variety of embedded processors and real-time operating systems, the Java Virtual Machine, and desktop operating systems such as Windows and Mac OS.

Most features of CodeWarrior apply regardless of your preferred host, language, or target. General features of CodeWarrior are described in other manuals, such as the IDE User Guide.

However, each target has its own unique features. This manual describes those unique features.

For a complete understanding of CodeWarrior, you must refer to both the general documentation and the documentation that is specific to your particular target, such as this manual.

The documentation is organized so that various chapters in this manual are extensions of particular generic manuals, as shown in Table 1.2. For a complete discussion of a particular subject, you may need to look in both the generic manual and the corresponding chapter in this Targeting manual.

CodeWarrior documentation organization:

This chapter...	Extends...
Application Projects   Library Projects   Code Resource Projects   Mac OS Target Settings	IDE User Guide
Advanced Debugging	IDE User Guide
C and C++ Support for Power PC   Support for Motorola 68K   PowerPC Assembler	C Compilers Reference
Application Projects   Library Projects   Code Resource Projects	MSL C Reference   MSL C++ Reference

For example, to completely understand the C/C++ compiler, you need to know the information in the C Compilers Reference (which covers the C/C++ front-end compiler) and the information in the C and C++ Support for Power PC section of this manual, which covers the back-end compiler that generates target-specific code.

Adobe Acrobat Indexes

An Acrobat PDX index is included on the CodeWarrior Reference CD that provides a global index across all the CodeWarrior PDF documentation included with CodeWarrior. Add the CodeWarrior index to Acrobat's Available Indexes list using the Edit > Search > Select Indexes... menu option. Once added, you can easily search for all occurances of an item, like stationery, or Carbon, or anything.

Where to Go from Here

All the manuals mentioned below are available as part of the CodeWarrior documentation and can be found on the CodeWarrior Reference CD. Online references do not have documentation on the CD.

If you're new to CodeWarrior:

• For an overview of how CodeWarrior IDE works, see "Development Tools for Mac OS."
• To learn more about the CodeWarrior IDE, its features and capabilities, visit the Metrowerks Training web site at:

  	http://www.metrowerks.com/training/

Free, online supplemental courses in a variety of programming disciplines like C, C++, and Java can be found at:

	http://www.codewarrioru.com/

For everyone:

• For general information about the CodeWarrior IDE and debugger, or RAD tools, see the IDE User Guide.
• For information specific to the C/C++ front-end compiler, see the C Compilers Reference.
• For information on Metrowerks' standard C/C++ libraries, see the MSL C Reference and the MSL C++ Reference.
• For information scripting the CodeWarrior IDE, see the CodeWarrior Scripting Reference.
• For information on using the CodeWarrior IDE with command-line tools, see the CodeWarrior Command-line Tools Reference.

For general information on Mac OS programming:

• If you are using PowerPlant, you will be interested in reading the Inside PowerPlant documentation. Start with the PowerPlant Book, then refer often to the PowerPlant Reference, the Porting PowerPlant to Carbon Reference, and PowerPlant Advanced Topics manuals as required.
• MW Profiler is a Mac OS tool that allows you to see where optimizations are required in your code to make it more efficient. Profiler has been carbonized to work on Mac OS X. See the MW Profiler manual for more information.
• ZoneRanger is a Mac OS utility that enables you to see how your code is managing memory. If there are problems, you can fix them before releasing a final product. ZoneRanger has not been carbonized to work on Mac OS X. See the ZoneRanger manual for further information.
• Apple's current developer documentation in HTML and PDF formats, and easy access to relevant Technical Notes and Technical Q&As can be found at:

  	http://developer.apple.com/techpubs/

• If you are coming from a Windows or other platform background, and are not sure how to get started with Mac OS programming, you should visit this web site also.

  	http://developer.apple.com/macos/macoverview/