Welcome to the CodeWarrior PowerPlant Carbon Porting Guide. This guide offers hints and tips on moving your PowerPlant programming project from the Classic Mac OS application programming interface to the new "Carbon" API. Carbon is Apple Computer's name for a set of application programming interfaces and libraries designed to help you make the transition from previous versions of the Macintosh Operating System ("Classic Mac OS") to the forthcoming Mac OS X programming model. Applications built with Carbon will run successfully under both Mac OS 8/9 (versions 8.1 and later) and Mac OS X.
Use this guide if you are converting a PowerPlant programming project from the Classic Mac OS API to the Carbon API. This guide points you to other CodeWarrior and Apple documentation for more in-depth topics. It also refers to development tools that might not be available with the CodeWarrior package you have.
This chapter contains the following sections:
Before using CodeWarrior, read the information in the Release Notes folder, which is on the CodeWarrior CD-ROM and installed in the CodeWarrior folder on your computer's hard disk drive. The release notes contain important information about new features, bug fixes, and any late-breaking changes.
The Products provided by Metrowerks under the License Agreement process dates only to the extent that the Products use date data provided by the host or target operating system for date representations used in internal processes, such as file modifications. Any Year 2000 Compliance issues resulting from the operation of the Products are therefore necessarily subject to the Year 2000 Compliance of the relevant host or target operating system. Metrowerks directs you to the relevant statements of Apple Computer, Inc., relating to the Year 2000 Compliance of the Mac OS operating systems. Except as expressly described above, the Products, in themselves, do not process date data and therefore do not implicate Year 2000 Compliance issues.
For additional information, visit
http://www.metrowerks.com/about/y2k.html.
The chapters in this guide are listed in Table 1.1.
Read this chapter
to learn about
This guide only discusses unique issues and problems that you might encounter when converting your PowerPlant programming project to the Carbon API. For general information on PowerPlant programming, you will find these manuals and references the most useful:
For general information about Mac OS X and the Carbon application programming interface, visit the Apple Developers' Web site at
<http://developer.apple.com/techpubs/>
This site offers a variety of Apple documentation on Mac OS X and Carbon. In particular, the document Carbon Porting Guide contains much useful information on converting existing applications from Classic Mac OS to the Carbon interface.