Contents

Preface

Guide to Taligent Tools for AIX

CommonPoint information set

Getting started

Developer guides

Usage and tools guidelines

Application documentation

Documented sample programs and sample code

Installation and late-breaking information

Typographical conventions

part 1 - A Quick Start

Quick start introduction

Preparing to work on AIX

Setting up your environment variables

Running CommonPoint programs

Following the AIX development workflow

Editing and browsing with SNiFF+

Installing and running SNiFF+

Creating a new project

Taligent header files in your project

Making a new source file

Adding a source file to a project

Editing in SNiFF+

Compiling and linking

Running a modified application

Debugging an application

Seven things to remember

New project == Select

Navigate == icon menu

Stay out of .sniffdir directories

Use a Taligent subproject

Ctrl-click toggles header and source

Watch the Reusable button

Beware of uncommitted buffers

Debugging your application

Launching the debugger

Setting the fetch path

Priming the debugger

Debugging from the system menu

Debugging with breakpoints

Setting a breakpoint

Debugging an interactor

Using OpusBug()

Troubleshooting common problems

Responding to problems

Performing a deep clean

Performing a session restart

Performing a complete restart

Reviewing a sample AIX process listing

Identifying common problems

Strange behavior, progressively becoming worse

Erroneous behavior when launching or debugging your program

Hardware or software problems apparently not related to Taligent

SNiFF+ text "melts"

Launching your program causes "exec format error"

Undefined symbol errors

OpenDocument exception errors

Load errors

Runtime symbol resolution error

Keyboard server dies

AIX system is sluggish after stopping

Swap space errors

System hangs with 888 on the CPU display

System crawls and CommonPoint eventually hangs

Using AIX

Frequently performed AIX tasks

Commands

Meta characters

Not-so-common AIX tasks

Examining the contents of an AIX binary

Giving interactive processes a higher priority

Changing directories quickly

Turning off aliasing when executing a particular command

Generating formatted ASCII version of a man page

Finding a file on your disk

part 2 - Taligent Tools

Tools introduction

The Taligent build environment for AIX

Taligent build terminology

The build process

Makefiles

Makefile description syntax

Target types

Library

Program

ParentObject

SubProjectList

Makeit

Syntax

Passing options to make

Creating makefiles

Building without stopping

Preventing duplication

Environment variables

Defining environment variables

How to change environment variables

When to change environment variables

Real-life examples

A simple sample

How to create SimpleSample

The build log

Makeit messages

Includes phase

Objects phase

Exports phase

Binaries phase

Copy phase

How to execute SimpleSample

A faster build

A clean build

A not-so-simple makefile

A simple *.PinkMake file

Adding link libraries

Using FindSymbols

Reduced library footprint

Reduced compiled code size

Generating template class instantiations

The instantiations file

Adding new instantiations

Determining which class templates to add

Defining new class templates

Source file modifications

Managing class template dependencies

Checklist for using class templates

Taligent build tools

CommonPoint

Syntax

Usage

Examples

CreateMake

Installation

Syntax

Usage

Makefile format

Example

FindSymbols

Syntax

Usage

Examples

MakeExportList

Usage

Example

Makeit

Installation

Syntax

Usage

Passing options to make

Creating makefiles

Preventing duplication

Other global targets

MakeSharedApp

Usage

Example

MakeSharedLib

Usage

Example

MakeSOL

Syntax

Usage

RunDocument

Syntax

Usage

Example

SemaPurge

SmartCopy

Syntax

Usage

SmartLn

Syntax

Usage

TalFetch

TrimExports

Syntax

Usage

CreateMake keywords

Keyword categories

Pathnames

application

binariessubfolderdir

binary

Syntax

Example

build

Syntax

Example

compileoption

Syntax

Example

data

Syntax

Example

developmentobject

Syntax

Example

end

Syntax

Example

export

Syntax

Example

header

Syntax

Example

headerdir

Syntax

Example

heapsize

Syntax

Example

library

Syntax

Example

link

Syntax

Example

loaddump

Syntax

Example

local

Syntax

localheader

Syntax

Example

localheaderdir

Syntax

Example

make

Syntax

Example

object (tag)

Syntax

Example

object (target)

Syntax

Example

objectdir

Syntax

Example

parentobject

parentobjectdir

Syntax

Example

private

Syntax

Example

privateheaderdir

Syntax

Example

program

public

Syntax

Example

script

Syntax

Example

server

Syntax

Example

source

Syntax

Example

sourcedir

Syntax

Example

start

Syntax

Example

subfolder

subfolderdir

Syntax

Example

subproject

Syntax

Example

testapplication

Syntax

testlibrary

Syntax

testparentobject

Syntax

testserver

Syntax

tool

Syntax

trimdependencies

Syntax

Example

trimexports

Syntax

The Xcdb debugger

Significant features

The Xcdb setup

Installating

Signals

Compiling

Running Xcdb

Example

Program starting

Program interrupting

Program terminating

Xcdb exit codes

Window organization

Window manipulation

Left mouse button

Right mouse button

Keys

Execution control

Format control

Common formats

Type-specific formats

Class, struct, and union formatting

Array formatting

Statically allocated arrays

Dynamically allocated arrays

Subrange selection

Pointer formatting

Breakpoints

Preferences

Self-displaying C++ objects

Example

Notes

Customizing Xcdb

Example

Frequently asked questions

Reporting bugs