Contents

Previous

Next


Introduction

Red Hat Source-Navigator TM is a powerful code analysis and comprehention tool that provides a graphic framework for understanding and reengineering large or complex software projects. Source-Navigator's cross-platform nature also makes it an invaluable code porting tool.

Source-Navigator parsers scan through source code, extracting information from existing C, C++, Java, Tcl, [incr tcl], FORTRAN, COBOL, and assembly programs and then use this information to build a project database. The database represents internal program structures, locations of function declarations, contents of class declarations, and relationships between program components. Source-Navigator graphical browsing tools use this database to query symbols (such as functions and global variables) and the relationships between them.

In addition to the languages supported in the standard distribution, you can use the Source-Navigator Software Development Kit (SDK) to add new parsers and extend Source-Navigator functionality to other languages. For more information, refer to Introduction in the Programmer's Reference Guide.

For information on licensing and redistribution terms, see GNU General Public License.

Managing Projects

A Source-Navigator project is an entity containing references to source code files. A project describes where files are located and how to operate on them. Once a project is defined, developers can:

Navigational Tools

All Source-Navigator tools are organized around the project database that holds all project-specific symbols. The name and location of the project files, symbols extracted from the source code, and the relationships between symbols all reside in the project database. File structure may not be pertinent when visualizing code relationships, so Source-Navigator allows you to view and understand software structure regardless of which file contains what information.

The Symbol Browser, the Editor, and the Cross-Referencer are the basic tools for working with source code in a project.

About this Guide

This document serves as a reference to Source-Navigator menus, tools, and functionality.

Document Conventions

This documentation uses the following general conventions:

Italic Font

Indicates a new term that will be defined in the text and items called out for special emphasis.

Bold Font

Represents menus, window names, and tool buttons.

Bold Italic Font

Denotes book titles, both hardcopy and electronic.

Plain Typewriter Font

Denotes code fragments, command lines, contents of files, and command names; also indicates directory, file, and project names where they appear in body text.

Italic Typewriter Font

Represents a variable for which an actual value should be substituted.

Menu names and their submenus are separated by an arrow (->). For example, File -> Open means from the File menu, select Open from its submenu.

Paths are written in UNIX notation (forward slashes) throughout; .../bin means the directory Source-Navigator is installed into, subdirectory bin.

Mouse Conventions

The following are conventions for using the mouse with Source-Navigator:

Click

Place the cursor on a specified object and press the left mouse button. Double-click means to click the left mouse button twice in rapid succession without moving the mouse.
The term "click" alone always means left-click.

Ctrl+click

Depress and hold the Ctrl key, simultaneously clicking with the left mouse button.

Shift+click

Depress and hold the Shift key, simultaneously clicking with the left mouse button.

Right+click

Place the cursor on a specific object and click the right mouse button.

Select Text

Click and drag cursor through text (or code) to be selected. Selected text is highlighted.

Select Entries

Clicking a line selects it. To indicate the end of the selection, hold down the Shift key and click the desired line.

Keyboard Conventions

You can use the keyboard to activate many of the functions displayed on the toolbar and in the menus.


Contents

Previous

Next