fMerge Tool

The FMerge tool (FMerge.exe) is an application called by Makeimg.exe to combine files together. It combines all existing binary image builder (.bib) files into a single file called Ce.bib. It also combines all existing registry (.reg) files into a single file called Reginit.ini.

Each of the following sections below describes the keywords that can be used in .bib files and are recognized by FMerge.

The following table shows keywords that you can use with FMerge.

Keyword Description
#define Specifies the value of a variable.
#undef Resets a variable to its original value.
#include Specifies a file to be included in the build.
#error Generates an error message to stderr and stops execution of FMerge.
#message Generates an output message to stdout.

Decision Statements and Operators

You can use several standard decision statements and operators with the fMerge application. The following standard expressions are available.

#if expression_list
#elif expression_list
  • expression_list
    An expression that is evaluated by the application.

Standard join operators and conditional operators are supported. The following operators can be used with the fMerge application: &&, ||, == and !=.

Example Code

The following code example shows how the #if statement is used.

#if ! defined DRIVER_DIRECTORY
#define DRIVER_DIRECTORY $(_PUBLICROOT)\oak\common\drivers

The following code example shows how the #elsestatement is used.

#if $(LOCALE)==0409
; do something
#elif $(LOCALE)==0411
; do something else
#error LOCALE $(LOCALE) is unsupported.

The following code example shows how the && join operator is used.

#if ! defined BSP_NOUSB && defined BSP_USB_OHCI
; do something

Variable Substitution

You can substitute variables by using the $()operator. Variables are not substituted in comments or in #definestatements. When using a variable for substitution, variables defined in the active files are checked first, followed by environment variables. If the variable is not found in either place, execution will fail. The exception to this is in conditional expressions where you may use a variable that is undefined.

Nested variables are resolved when the containing variable is used. If the variable varone contained the variable $(vartwo), when $(varone) is used, $(vartwo) would be resolved to its last defined value prior to the use of $(varone). When a variable is resolved, its value will be checked for nested variables up to a nested depth of 10 variables.

Example Code

The following code example shows how variable substitution is used.

#include "$(_PROJECTOAKROOT)\drivers\keybd\$(keyboard_type)\keybd.reg"; Includes the registry file for the keyboard

See Also

Build Demo Tool | Binary Image Builder File | Build Release Directory Tool | Make Binary Image Tool

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.