Oovcde scans the directories of the project under the source root directory and adds include paths for any directories that contain header files. Exclude directories can be set up for the project if needed.
Oovcde generally uses one set of compiler settings for all directories. This typically means that a superset of all packages must be specified. For example, if gtk is not needed for some directories, adding it for all directories should not cause a problem for directories that do not require gtk. It may make analysis slower, but should not fail.
Each header and source file is analyzed independently. This means that each file should be able to include all definitions needed. If the files do not include all needed definitions (they expect the source that includes them to include other files first), then the error limit may need to be increased so that more of the file can be parsed. The other alternative is to fix the header files so that they include the needed definitions.
Not all compiler errors need to be fixed to generate useful diagrams. Oovcde will still generate references to undefined objects as long as the compiler has parsed beyond the initial errors.
Packages are different on Windows and Linux. On Linux, the pkg-config tool is used by the Oovcde package dialogs so that packages can be selected and used in each project.
On Windows, Oovcde attempts to find directories using wildcards in the package directory definitions. If there are multiple versions, then the directory can be specified manually.
If the "Include Directory" setting is blank, then the directories are scanned for include files, and paths are saved. To prevent this scan, directories can be specified (separated with semicolons) or a single period can be used to specify that only the current directory relative to the root should be used as the path.
The "External References" can be specified with exclude directories the same as in the Build Arguments.
The argument order is important if there are files with the same names in different directories.
| Flag | Name | Description |
|---|---|---|
| -EP | External Packages | This flag should be added using the "External Project Packages" button. This specifies the name of the package to use for the OovBuilder. |
| -ER | External Recursive Directories | This flag allows specifying a root directory to search for includes and libraries. It also allows specifying exclude directories. An example is "/rootdir/!/test/!/examples/", so that any filepath that matches test or examples will be excluded. |
| -lnk | Link Flag | The value following this flag is sent to the linker. Some examples are "-lnk-L/libdir", or "-lnk../dir/objfile.o". |
See the Inkscape Example for more problem solving information.
For this example, we will attempt to analyze the Inkscape program. The Inkscape program requires gtkmm and boost, so they need to be added as external packages. Since gtkmm includes mingw, there is no reason to additionally add a separate mingw package.
I don't know which version of gtkmm is needed, so I just downloaded the Tarnyko gtkmm-3.4.0_mingw-4.6.2 version. Use Oovcde to add gtkmm as an external package.
At first, there was a compile error about a missing config.h. I never ran the configure command, so I cheated and copied config.h.in to config.h in the Inkscape source code.
The following problem is displayed during analysis, and resolved by adding an include of "gtkmm-3.0/gtkmm.h" to the Inkscape source in src/extension/param/parameter.h. The real problem is that Inkscape does not define all classes before they are referenced in header files.
C:/Dave/Mine/software/external-projects/inkscape-0.91/inkscape-0.91/src/ extension/param/parameter.h:42:8: error: use of undeclared identifier 'Glib'Similar to the first problem, more includes need to be added, so add the following includes to the parameter.h file before the gtkmm include. #include "xml/node.h", #include "extension/extension.h".
C:/Dave/Mine/software/external-projects/inkscape-0.91/inkscape-0.91/src/ extension/param\string.h:17:28: error: expected class name C:/Dave/Mine/software/external-projects/inkscape-0.91/inkscape-0.91/src/ extension/param\string.h:27:86: error: use of undeclared identifier 'Parameter'Inkscape defines float.h which conflicts with the external mingw library float.h. This problem can be eliminated by selecting "Analysis/Project Settings", and adding "inkscape-0.91/src/extension/param/" to Exclude Sub-Directories.
C:/Dave/Mine/software/external-projects/inkscape-0.91/inkscape-0.91/src/ extension/param\float.h:32:23: error: unknown type name 'gchar'The CLang compiler requires intrinsics from its own header file, and cannot use the one from mingw. This may or may not happen, but if it is a problem, use "-Iclang/3.6.0/include" before the external package ref arguments ("-EP").
/gtkmm340_mingw462/lib/gcc/mingw32/4.6.2/include\ia32intrin.h:41:10: error: use of undeclared identifier '__builtin_ia32_bsrsi'Inscape requires the Boehm garbage collector. This can be added by defining a new external package, or by using -I with the "include" directory specified. The sigc++ library can be added in the same manner with the "sigc++" directory specified. These packages are probably not needed to get a pretty good analysis of Inkscape.
C:/Dave/Mine/software/external-projects/inkscape-0.91/inkscape-0.91/src/ gc-core.h:25:11: fatal error: 'gc.h' file not foundTo summarize, by modifying two source files, and creating a simple Oovcde project, it was fairly easy to perform analysis on the Inkscape project.