What Are Common Projects?
Most Source Insight users make use of standard libraries, such as the C/C++ runtime libraries, or the standard Java packages. In order for Source Insight to provide symbol completion, and other symbolic features for standard libraries, you need to setup separate projects for those libraries. Source Insight will resort to searching these common projects if a symbol cannot be found in your current project.
The Setup Common Projects command will help you build projects for those libraries. The projects you build are added to the project symbol path, so Source Insight can provide symbol completion and other symbolic features for those libraries from within your own projects.
Creating Common Projects
Source Insight will ask you at this point if you want to create common projects.
In order for Source Insight to provide symbol completion, and other symbolic features for standard libraries, such as the C Runtime, or Java standard packages, you need to setup separate projects for those libraries. Source Insight will resort to searching these projects if a symbol cannot be found in your current project.
For each common project, you are asked to locate the directory where the corresponding files are located on your disk. If you installed the source code for your libraries on your disk, then you can take advantage of Source Insight to use the source code as a basis for the projects. For instance, you might click on a call to the function strtok in the C Runtime Library, and Source Insight will locate the source code for strtok.
The projects that you create at this point are automatically added to the project symbol path. Later, if you want to change that path, run the Preferences: Symbol Lookups command (Options menu) to edit it. You can always create projects later and add them to the path.
Setup Common Projects
This command asks you to indicate what common projects you would like to build.
This command runs automatically after you install Source Insight for the first time. You can also invoke this command directly at any time after that from the Preferences: Symbol Lookups dialog box.
Set Common Projects Dialog box
For each common project, you are asked to locate the directory where the corresponding files are located on your disk. If you installed the source code for your libraries on your disk, then you can take advantage of Source Insight to use the source code as a basis for the projects. For instance, you might click on the C function strtok, and Source Insight will locate the source code for strtok.
Each common project created here is appended to the project symbol path, which can also be edited in the Preferences: Symbol Lookups dialog box.
Note: Selecting a project to rebuild in this dialog box will replace the existing project, if any. Also, building a large project, such as the C/C++ Runtime and Windows Header project may take a few minutes.
Standard C/C++ and Windows Headers
This project is intended to include the standard Windows, C, and C++ include files, and/or source code. Source Insight will attempt to locate them by looking in your registry, however you will have to confirm their location. Click the Browse button to the right to locate the folder that contains the source files.
Standard MFC Files
This project is intended to include the MFC (Microsoft Foundation Classes) include files and/or source files. Click the Browse button to the right to locate the folder that contains the source files.
Standard Java Libraries
This project is intended to include the Java development kit source code for the standard Java packages, such as java.lang. Source Insight will attempt to locate them by looking in your registry, however you will have to confirm their location. Click the Browse button to the right to locate the folder that contains the source files.
.Net Framework
This project is used for symbolic auto-completion in C#. If you are not using C#, you do not need to select this project. You don’t need to specify a directory for this project because Source Insight creates it for you.
Continue
Click the Continue button to proceed and create the common projects that are checked. For each project that is checked, Source Insight will ask you to add files to that project. The Add and Remove Project Files dialog box will appear.