1 Introduction

CodeWarrior IDE Overview

IDE Tools

IDE Flexibility

CodeWarrior Projects

IDE User Guide Overview

Read the Release Notes!

Manual Conventions

Typographical Conventions

Host Conventions

Figure Conventions

Keyboard Conventions

New in This Release

Find and Replace

Selectable Menu Bar Layouts

Shielded Folders

Remote Debugging

Symbolics Window

Project Engine Improvements

Import/Export of IDE Preferences and Target Settings

Contextual Menu Improvements

Where To Go From Here

Getting Started and Tutorials

Targeting Documentation

Adobe Acrobat Indexes

2 Getting Started

System Requirements

Windows

Mac OS

Solaris

Linux

CodeWarrior IDE Installation

Programming Concepts

Creating Input Files

Generating the Software

Debugging and Refining the Software

An Introduction to the CodeWarrior IDE

Projects and Targets

Source-Code Editing and Browsing

Compiling and Linking

Project Debugging

Rapid Application Development

Version Control

Scripting

Customizing the IDE

Working with Third-Party Tools

3 Working with Projects

Guided Tour of the Project Window

Navigating the Project Window

Project Window Toolbar

Files View

Design View

Link Order View

Targets View

Creating a New Project

Types of Project Files

Choosing a Project Stationery File

Naming Your New Project

Using the New Project dialog box

Modifying Your New Project

Building Your New Project

Working with Project Stationery

About Project Stationery

About the Project Stationery Folder

Creating Your Own Project Stationery

Importing Makefiles into Projects

Using the Makefile Importer Wizard

Makefile Importer Wizard Options

Opening an Existing Project

Using the Open Command

Using the Open Recent Command

Using the Project Window to Open Subprojects

Opening Project Files Created on Other Host Platforms

Saving a Project

Items Saved with Your Project

Saving a Copy of Your Project

Closing a Project

Choosing a Default Project

Managing Files in a Project

Expanding and Collapsing Groups

Selecting Files and Groups

Adding Files

Moving Files and Groups

Creating Groups

Removing Files and Groups

Renaming Groups

Touching and Untouching Files

Working with Complex Projects

What is a Build Target?

What is a Subproject?

What is a Design?

Strategy for Creating Complex Projects

Creating a New Build Target

Changing a Build Target's Name

Changing a Build Target's Settings

Setting the Current Build Target

Creating Build-Target Dependencies

Assigning Files to Build Targets

Creating Subprojects Within Projects

Examining Project Information

Moving a Project

Importing and Exporting a Project

Controlling Debugging in a Project

Generating Debugging Information for a Project

Generating Debugging Information for a File

Adding Preprocessor Symbols to a Project

4 Working with Files

Creating a New File

Opening an Existing File

Opening Files from the File Menu

Opening Files from the Project Window

Opening Files from an Editor Window

Opening a Related File

Saving a File

Closing a File

Closing One File

Closing All Files

Printing a File

Setting Print Options

Printing a Window

Reverting to a Previously-Saved File

Comparing and Merging Files & Folders

File Comparison and Merge Overview

Choosing Files To Compare

Examining and Applying Differences

Choosing Folders To Compare

5 Editing Source Code

Guided Tour of the Editor Window

Text-Editing Area

Interface Pop-Up Menu

Function Pop-Up Menu

Marker Pop-Up Menu

Document Settings Pop-Up Menu

VCS Pop-Up Menu

File Path Caption

Dirty File Marker

Pane Splitter Controls

Line and Column Indicator

Toolbar Disclosure Button

Path Pop-Up Menu (Mac OS)

Editor Window Configuration

Setting Text Size and Font

Seeing Window Controls

Splitting the Window into Panes

Saving Editor Window Settings

Basic Text Editing

Basic Editor Window Navigation

Adding Text

Deleting Text

Selecting Text

Moving Text (Drag and Drop)

Using Cut, Copy, and Paste

Balancing Punctuation

Shifting Text Left and Right

Undoing Changes

Controlling Color

Navigating the Text

Finding a Routine

Adding, Removing, and Selecting a Marker

Using Bookmarks

Opening a Related File

Going to a Particular Line

Using Go Back and Go Forward

Configuring Editor Commands

Opening the Directory of a File (Mac OS)

Online References

Finding Symbol Definitions

WinHelp (Windows)

QuickHelp (Mac OS)

QuickView (Mac OS)

THINK Reference (Mac OS)

Inserting Routine (Reference) Templates (Mac OS)

6 Finding and Replacing Text

Guided Tour of the IDE's Find Features

Find Dialog Box

Find and Replace Dialog Box

Find in Files Window

Find Options

General Search Options

Multi-File Search Options

Search Buttons

Finding and Replacing Text in a Single File

Finding Text

Finding and Replacing Text

Searching with Special Characters

Finding and Replacing Text in Multiple Files

In Folders

In Projects

In Symbolics

In Files

Search Results

Searching for Selected Text

Finding Text in the Active Editor Window

Finding Text in Multiple Editor Windows

Using Regular Expressions (grep)

Operators

Find and Replace Using Regular Expressions

7 Browsing Source Code

Activating the Browser

Understanding the Browser Strategy

Contents View

Browser View

Hierarchy View

Guided Tour of the Browser

Browser Contextual Menu

Contents Window

Browser Window

Multi-Class Hierarchy Window

Single-Class Hierarchy Window

Symbol Window

Browser Menu

Browser Wizards

New Class Wizard

New Member Function Wizard

New Data Member Wizard

Using the Browser

Setting Browser Options

Identifying Symbols in the Browser Database

Navigating Code in the Browser

Browsing Across Subprojects

Completing Symbols

Opening a Source File

Seeing a Declaration

Seeing a Routine Definition

Editing Code in the Browser

Analyzing Inheritance

Finding Functions That Are Overrides

Viewing MFC and PowerPlant Classes

Saving a Default Browser

8 Configuring IDE Options

Preferences Guided Tour

Preference Panels

Window Buttons

Choosing Preferences

General Preferences

Editor Preferences

Debugger Preferences

RAD Tools Preferences

Customizing the IDE

Window Buttons

Customizing Commands

Customizing Key Bindings

Customizing Toolbars

9 Configuring Target Options

Target Settings Guided Tour

Settings Panels

Window Buttons

Choosing Target Settings

Target Settings

Code-Generation Settings

Editor Settings

Debugger Settings

10 Compiling and Linking

Choosing a Compiler

Understanding Plug-in Compilers

Setting a File Extension

Compiling and Linking a Project

Compiling Files

Setting Link Order

Updating a Project

Making a Project

Enabling Debugging

Running a Project

Debugging a Project

Generating a Link Map

Synchronizing Modification Dates

Handling Object Code

Advanced Compile Options

Using Precompiled or Preprocessed Headers

Creating Precompiled Headers

Defining Symbols For C/C++

Defining Symbols For Pascal

Preprocessing Source Code

Disassembling Source Code

Guided Tour of the Message Window

Using the Message Window

Seeing Errors and Warnings

Stepping Through Messages

Correcting Compiler Errors and Warnings

Correcting Linker Errors

Correcting Pascal Circular References

Saving and Printing the Message Window

Locating Errors in Modified Files

Special Library Options (Mac OS)

Import Weak

Initialize Before

Merge Into Output

11 Debugging Source Code

Symbolics Files

Preparing for Debugging

Setting Up a Build Target for Debugging

Setting Up a File for Debugging

Generating Symbolics Information

Using the Debugger

Guided Tour of the Debugger

Thread Window

Symbolics Window

Symbol Hint

Debugger Contextual Menu

Processes Window

Expressions Window

Global Variables Window

Breakpoints Window

Watchpoints Window

Register Windows

Log Window

Variable Window

Array Window

Memory Window

Basic Debugging

Starting Up

Running, Stepping, and Stopping Code

Navigating Code

Breakpoints

Watchpoints

Viewing and Changing Data

Editing Source Code

Expressions

How Expressions are Interpreted

Using Expressions

Example Expressions

Expression Syntax

Using Vector Variables in Expressions (Mac OS)

Troubleshooting

General Problems

Problems Launching the Debugger

Problems Running/Crashing the Debugger

Problems with Breakpoints

Problems with Variables

Problems with Source Files

Debugger Error Messages

12 RAD Designs and Layouts

About RAD

CodeWarrior RAD Tools

Class Authoring

Component Model

Creating RAD Projects

RAD Wizards

Java Applet Wizard

Java Application Wizard

Java Bean Wizard

Working with Designs

Adding Designs to a Project

Design View in the Project Window

Designs in the Targets View

Working with Layouts

13 RAD Layout Editing

Layout Editor

Creating a Layout

Modifying a Layout

Layout Wizards

Java Frame Wizard

Component Palette

Component Palette Toolbar

Catalog Pop-up Menu

Component Tools

Component Catalog window

Component Catalog Toolbar

Catalog Pane

Component Pane

Component Catalog Contextual Menu

Creating Component Catalogs

Object Inspector

Object Pop-up Menu

Properties Tab

Events Tab

Object Inspector Contextual Menu

14 RAD Components

Java AWT Components

Java Swing Components

Component Editors

Menu Editor

Pop-up Menu Editor

15 RAD Browsing

Browser Window RAD Features

Tab Control

Properties View

Methods View

Events View

RAD Windows

New Property Window

New Method Window

New Event Set Window

New Event Set wizard

New Event Window

16 Using the CodeWarrior® IDE with Version Control Systems

Using Version Control Systems

Commercially Available VCS Plug-ins

Activating VCS Operations

Installing VCS Software

Activating VCS Software

Accessing VCS Features

VCS Menu

Version Control Login Window

VCS Pop-up

Project Window

VCS Messages Window

Common VCS Operations

Getting a File's Status

Modifying a Checked In File

Dealing with `ckid' Resources (Mac OS)

Other Operations

A CodeWarrior® IDE Menu Reference

IDE Menu Tables

Info Menu

File Menu

Edit Menu

View Menu

Search Menu

Project Menu

Debug Menu

Data Menu

Browser Menu

Layout Menu

Window Menu

VCS Menu

Tools Menu

Scripts Menu

Editor Extensions Menu

Help Menu

Alphabetical Menu-Command Listing

Submenu Listing

Java Exceptions Submenu

Align Submenu

Resize Submenu

Toolbar Submenu

B Solaris and Linux Utilities

Copy Files Accessory

Source File/Directory Selection

Currently Selected Files/Directories

Destination Directory Selection

File Systems Facility

The File Systems Dialog Box

The File System Options Dialog Box

Keyboard Preferences Dialog Box

C Opening Project Files from Earlier IDE Versions

Converting a Single 1.7 Project

Converting Multiple 1.7 Projects (Mac OS)

Opening Project Files from Versions Prior to 1.7 (Mac OS)

Index