# Source-Navigator Tutorial

Source-Navigator scans your source code and loads the extracted information into a project database. This database stores all information about file names, symbol elements, and symbol relationships (functions and global variables are examples of symbols). Source-Navigator provides you with different browsers (graphical views) into the project database.

This tutorial is based on the C++ demo project, so this demo project must be installed to proceed.

If you did not choose to create project files during installation, see Creating a Project.

## Using the Symbol Browser

After you create the demo project, the Symbol Browser window opens. The Symbol Browser provides a view of the symbols within the project. This list can be filtered (sorted) by symbol type or by a text string that can be typed in the Pattern: field.

1. Click on the icon to the left of the file or symbol name to expand the list view to a tree view of the file or symbol.

2. Double-click on the file or symbol name `Agent.cc` to open the Editor to the location of the selected file or symbol in the source code.

For more information on the Symbol Browser, see Symbol Browser.

## Using the Project Editor

Use the Project Editor when you want to create a new project, add files or directories to an existing project, or delete files or directories from an existing project. The Project Editor also enables you to organize source files for a project. With the Project Editor, you can:

- name the project and specify the path.
- view statistics for a file or directory.

Open the Project Editor by selecting File -> Project Editor.

The Project Editor lets you set up a project view and hide selected files from the view. This is useful in large projects where you want to segment views in the project based on file structure.

To view a project, select a name from the View combo-box.

### Adding Files to a Project

To add source files to a project, select Add Files... from the Project Editor window. The Open dialog appears:

Click on the down arrow in Files of Type at the bottom of the window to bring up a combo-box to show only files based on the file extensions you choose; All files (*) is chosen by default. Select source files to be added to the project and click Open.

### Adding Directories to a Project

The Add directory... button allows you to add entire directories and their contents to your project.

Select the directory you want to add and click OK. You may add as many directories as you wish, but you must add them one at a time.

### Adding the Files from Another Project

The Add Project... button allows you to import another Source-Navigator project and all of the files it includes into your current project.

This is the same Open dialog as when you clicked on Add Files... , except that Project files (*.proj) is chosen by default from the Files of Type menu. To see all files in the directory, choose All files (*). Click on the project from which you want to import files.

When you're finished working with the Project Editor, click OK.

### Modifying Files in a Project

Hide files or directories by selecting a file or directory in the file system tree view and clicking the