BSCMAKE Options

OverviewsHow Do I

This section describes the options available for controlling BSCMAKE. Several options control the content of the browse information file by excluding or including certain information. The exclusion options can allow BSCMAKE to run faster and may result in a smaller .BSC file. Option names are case sensitive (except for /HELP and /NOLOGO).

/Ei (filename...)

Excludes the contents of the specified include files from the browse information file. To specify multiple files, separate the names with a space and enclose the list in parentheses. Parentheses are not necessary if you specify only one filename. Use /Ei along with the /Es option to exclude files not excluded by /Es.

/El

Excludes local symbols. The default is to include local symbols. For more information about local symbols, see Creating an .SBR File.

/Em

Excludes symbols in the body of macros. Use /Em to include only the names of macros in the browse information file. The default is to include both the macro names and the result of the macro expansions.

/Er (symbol...)

Excludes the specified symbols from the browse information file. To specify multiple symbol names, separate the names with a space and enclose the list in parentheses. Parentheses are not necessary if you specify only one symbol.

/Es

Excludes from the browse information file every include file specified with an absolute path or found in an absolute path specified in the INCLUDE environment variable. (Usually, these are the system include files, which contain a lot of information that you may not need in your browse information file.) This option does not exclude files specified without a path or with relative paths or files found in a relative path in INCLUDE. You can use the /Ei option along with /Es to exclude files that /Es does not exclude. If you want to exclude only some of the files that /Es excludes, use /Ei instead of /Es and list the files you want to exclude.

/HELP

Displays a summary of the BSCMAKE command-line syntax.

/Iu

Includes unreferenced symbols. By default, BSCMAKE does not record any symbols that are defined but not referenced. If an .SBR file has been packed, this option has no effect for that input file because the compiler has already removed the unreferenced symbols.

/n

Forces a nonincremental build. Use /n to force a full build of the browse information file whether or not a .BSC file exists and to prevent .SBR files from being truncated. See How BSCMAKE Builds a .BSC File.

/NOLOGO

Suppresses the BSCMAKE copyright message.

/o filename

Specifies a name for the browse information file. By default, BSCMAKE gives the browse information file the base name of the first .SBR file and a .BSC extension.

/S (filename...)

Tells BSCMAKE to process the specified include file the first time it is encountered and to exclude it otherwise. Use this option to save processing time when a file (such as a header, or .H, file for a .C or .CPP source file) is included in several source files but is unchanged by preprocessing directives each time. You may also want to use this option if a file is changed in ways that are unimportant for the browse information file you are creating. To specify multiple files, separate the names with a space and enclose the list in parentheses. Parentheses are not necessary if you specify only one filename. If you want to exclude the file every time it is included, use the /Ei or /Es option.

/v

Provides verbose output, which includes the name of each .SBR file being processed and information about the complete BSCMAKE run.

/?

Displays a brief summary of BSCMAKE command-line syntax.

The following command line tells BSCMAKE to do a full build of MAIN.BSC from three .SBR files. It also tells BSCMAKE to exclude duplicate instances of TOOLBOX.H:

BSCMAKE /n /S toolbox.h /o main.bsc file1.sbr file2.sbr file3.sbr