Some programming languages provide a facility for including other source files. In C/C++ this is achieved using the #include preprocessor directive. The Include Browser lets you display Includes and Included by relationships simultaneously.
Start the Include Browser by choosing Windows -> New View -> Include.
To see further relationships, after selecting a file in the Include Browser window, use the right and left pointing-hand tool icons to show files included by the selected file (blue connection lines) and files that include the selected file (red connection lines).
To determine the number of levels shown for a query, enter a positive integer in the Levels text entry box.
Holding down the right mouse button on a symbol in the Include Browser window brings up a menu that allows you to show or hide include information.
This is useful when the Include Browser displays more information than you need, and you'd like to hide all relationships but the particular one you're interested in.
You'll find preference settings for the Include Browser window in the Include tab of the Preferences dialog. To find this window, select one of the following:
Display order:
Left to right displays the include hierarchy from left to right;
Top to Bottom displays it from top to bottom.
Display layout style:
Select Tree to display includes in tree layout; select ISI
to display them in ISI layout.
Vertical space:
Enter the number of vertical pixels between symbols in the Include
Browser window.
Horizontal space:
Enter the number of horizontal pixels between symbols in the Include
Browser window.
Locate Headers
Uncheck this box to prevent included files from being parsed.
In the Include Directories box you can choose which directories should be searched for include files. Using the set of directories shown in Include Tab of the Preferences Dialog, for example, if <stdio.h> is a reference then Source-Navigator will first look for the file ./stdio.h, then for contrib/epics/stdio.h, and so on down the list. The order of the list is important, because the first file listed is the one that is used by the Include Browser.