# 2.

Getting Started

This chapter gives you the information you need to get started with CodeWarrior for the BeOS. You'll find the system requirements and information about installing the software, as well as a guided overview of the CodeWarrior IDE user interface.

## Getting Started Overview

The sections in this chapter are:

- `System Requirements`
- `CodeWarrior IDE Installation`
- `CodeWarrior IDE Guided Tour`

### TIP:

For a quick look at the CodeWarrior IDE user interface, go to `"CodeWarrior IDE Guided Tour."` The tour gives you your first glimpse of the CW IDE interface.

## System Requirements

CodeWarrior for BeOS is hosted on the following processors.

- `Intel`
- `PowerPC`

The system requirements are listed for each host below.

#### Intel

- Pentium processor or higher
- 16 MB or RAM minimum (32 MB for Java development)
- BeOS Release 3
- 30 MB of free hard disk space

### NOTE:

For info on BeOS minimum requirements, see
http://www.be.com

#### PowerPC

- BeBox, or Power Macintosh, running BeOS Preview Release 2
- 16 MB of RAM minimum (32 MB for Java development)
- 30 MB of free hard disk space

### NOTE:

For info on BeOS minimum requirements, see
http://www.be.com

## CodeWarrior IDE Installation

To learn how to install the CodeWarrior product, read the QuickStart guide on the CodeWarrior CD. When you install CodeWarrior, you automatically install the CodeWarrior Integrated Development Environment (IDE), including the CodeWarrior tools, languages, and debugger.

All compilers and targets available in CodeWarrior use the same IDE. This manual provides information for all items in the IDE, noting platform-specific items when applicable.

### NOTE:

A limited version of CodeWarrior for BeOS is already installed with the BeOS. Additional material is found on the CodeWarrior for BeOS CD.

## CodeWarrior IDE Guided Tour

This section gives an overview of the CodeWarrior IDE user interface. In this section you'll find:

- `Initial View of the IDE`
- `IDE Menus`
- `Other IDE Components`

### Initial View of the IDE

When you launch CodeWarrior, you see the application main menu change to the icon and a new Editor window appear.

You use the menus in the Editor, Project, and Message windows to access CodeWarrior tools and commands.

#### Figure 2.1 The CodeWarrior Window.

Because the menu commands are so extensive, this chapter describes each menu only briefly. Information about the various menu options can be found throughout this manual. If you'd like to look up what a specific menu item does, you can refer to `"IDE Menu Reference."`

### IDE Menus

The CodeWarrior BeIDE menus allow you to perform a large number of tasks to accomplish your work.

Menus normally apply to the window in which the menu appears. The BeIDE uses menus in the following windows:

- `Editor Window Menus`
- `Project Window Menus`
- `Message Window Menus`

For beginners: Depending on your operating system and preference choices, some menu items may be disabled. These commands are not available for use with your current procedure or with your current target.

The following sections describe each menu briefly. You'll find a detailed reference for every command on each menu starting at `"IDE Menu Reference."`

### Editor Window Menus

The menus that appear in an Editor window include:

- `File Menu`
- `Edit Menu`
- `Search Menu`
- `Project Menu`
- `Window Menu`
- `Add-ons Menu`

#### File Menu

The `File Menu` contains all the necessary commands used to save, close or print source code files.

#### Figure 2.2 The File menu

#### Edit Menu

The `Edit Menu` contains commands to help you customize the CodeWarrior IDE to your needs. Undo, cut, copy, paste, and selection operations are on this menu.

#### Figure 2.3 The Edit menu

#### Search Menu

The `Search Menu` contains all the necessary commands used to find text, replace text, and to find the definitions of routines in your source code.

#### Figure 2.4 The Search menu

#### Project Menu

Use the commands on the `Project Menu` to add and remove source code files and libraries for your project, and to compile, build, link, and make your project. Commands for syntax checking, preprocessing, and disassembling source files are also on this menu.

#### Figure 2.5 The Project menu

#### Window Menu

The `Window Menu` includes commands that arrange open editor windows, switch between windows, and switch to previously opened projects.

#### Figure 2.6 The Window menu

#### `Add-ons Menu`

The `Add-ons Menu` displays a list of Editor plug-ins stored in the plugins directory.

#### Figure 2.7 Add-ons Menu

### Project Window Menus

The menus that appear in a Project window include:

- `File Menu`
- `Project Menu`
- `Window Menu`

#### File Menu

The Project window's `File Menu` includes commands to save copies of the project and close the project window.

#### Project Menu

Use the commands on the Project window's `Project Menu` to add and remove source code files, and libraries to your project, and to compile, build, link, and run your project. Commands for syntax checking, preprocessing, and disassembling source files are also on this menu. In addition, there are commands to add and remove groups, remove object code, reset file paths, and enable or disable the Debugger.

#### Figure 2.8 Project window's Project Menu

#### Window Menu

See `"Window Menu"` for details.

### Message Window Menus

The menus that appear in the Message window include:

- `File Menu`
- `Edit Menu`
- `Window Menu`

#### File Menu

See `"File Menu"` for details.

#### Edit Menu

See `"Edit Menu"` for details.

#### Window Menu

See `"Window Menu"` for details.

### Other IDE Components

This chapter discussed the CodeWarrior IDE menus. There are a few more components in the IDE that have Guided Tours.

For a tour of the Project Window, see `"Guided Tour of the Project Window."`

For a tour of the Editor Window, see `"Guided Tour of the Editor Window."`

Visit the Metrowerks website at: http://www.metrowerks.com
For assistance contact Metrowerks Technical Support at: support@metrowerks.com
Copyright © 1998, Metrowerks Corp. All rights reserved.
Last updated: February 15, 1998
* Chris Magnuson * John Roseborough