/Gm   (Enable Minimal Rebuild)

|  Overview |  How Do I |  Compiler Options

The Enable Minimal Rebuild (/Gm) option controls minimal rebuild, which determines whether C++ source files that include changed C++ class definitions (stored in header (.H) files) need to be recompiled. The compiler stores dependency information between source files and class definitions in the project's .IDB file during the first compile. (Dependency information tells which source file is dependent on which class definition, and which .H file the definition is located in.) Subsequent compiles use the information stored in the .IDB file to determine whether a source file needs to be compiled, even if it includes a modified .H file.

To find this option in the development environment, click Settings on the Project menu. Then click the C/C++ tab, and click Customize in the Category box.

Note Minimal rebuild relies on class definitions not changing between include files. Class definitions must be global for a project (there should be only one definition of a given class), because the dependency information in the .IDB file is created for the entire project. If you have more than one definition for a class in your project, disable minimal rebuild.