BSCMAKE 选项
警告
虽然安装 Visual Studio 时仍会安装 BSCMAKE,但 IDE 将不再使用它。 从 Visual Studio 2008 起,浏览信息和符号信息自动存储在解决方案文件夹的 SQL Server .sdf
文件中。
本节介绍可用于控制 BSCMAKE 的选项。 多个选项通过排除或包含特定信息来控制浏览信息文件的内容。 排除选项可以允许 BSCMAKE 更快地运行,并可能会产生较小的 .bsc
文件。 选项名称区分大小写(/HELP
和 /NOLOGO
除外)。
/NOLOGO
和 /o
仅在 Visual Studio 开发环境中可用。 有关详细信息,请参阅在 Visual Studio 中设置 C++ 编译器和生成属性。
选项
从浏览信息文件中排除一个或多个指定 filename
包含文件的内容。 若要指定多个文件,请使用空格分隔名称,并将列表括在括号中。 如果只指定一个 filename
,则不需要括号。 将 /Ei
与 /Es
选项一起使用可排除 /Es
未排除的文件。
/El
排除本地符号。 默认值是包含本地符号。 有关本地符号的详细信息,请参阅创建 .sbr 文件。
/Em
在宏主体中排除符号。 使用 /Em
可仅将宏的名称包含在浏览信息文件中。 默认值是同时包含宏名称和宏扩展的结果。
从浏览信息文件中排除一个或多个指定 symbol
符号。 若要指定多个符号名称,请使用空格分隔名称,并将列表括在括号中。 如果只指定一个 symbol
,则不需要括号。
/Es
排除使用绝对路径指定或是在 INCLUDE 环境变量中指定的绝对路径中的每个包含文件。 (通常,这些文件是系统包含文件,其中包含在浏览信息文件中可能不需要的许多信息。)此选项不排除在未使用路径的情况下指定、使用相对路径指定或是在 INCLUDE 中的相对路径中的文件。 可以将 /Ei
选项与 /Es
选项一起使用以排除 /Es
未排除的文件。 如果要仅排除某些文件,请使用 /Ei
而不是 /Es
,并列出要排除的文件。
.- .
此选项已弃用。 在 Windows Vista 及更高版本中,错误报告由 Windows 错误报告 (WER) 设置控制。
/HELP
显示 BSCMAKE 命令行语法的摘要。
/Iu
包含未引用的符号。 默认情况下,BSCMAKE 不会记录已定义但未引用的任何符号。 如果 .sbr
文件已打包,则此选项对输入文件没有影响,因为编译器已移除了未引用的符号。
/n
强制进行非增量生成。 使用 /n
可强制完全生成浏览信息文件(无论 .bsc
文件是否存在)并防止 .sbr
文件被截断。 有关详细信息,请参阅 BSCMAKE 如何生成 .bsc
文件。
/NOLOGO
禁止显示 BSCMAKE 版权消息。
/o
filename
filename
选项参数指定浏览信息文件的名称。 默认情况下,BSCMAKE 为浏览信息文件提供第一个 .sbr
文件的基名称和 .bsc
扩展名。
告知 BSCMAKE 在首次遇到每个指定 filename
包含文件时进行处理,否则将其排除。 当文件(例如 .c
或 .cpp
源文件的头文件 (.h
))包含在多个源文件中,但每次都由预处理指令保持不变时,使用此选项可节省处理时间。 如果文件的更改方式对所创建的浏览信息文件不重要,请使用此选项。 若要指定多个文件,请使用空格分隔名称,并将列表括在括号中。 如果只指定一个 filename
,则不需要括号。 如果要在文件每次被包含时进行排除,请使用 /Ei
或 /Es
选项。
/v
提供详细输出,其中包括所处理的每个 .sbr
文件的名称以及有关完整 BSCMAKE 运行的信息。
/?
显示 BSCMAKE 命令行语法的简短摘要。
示例
以下命令行告知 BSCMAKE 通过三个 .sbr
文件完整生成 main.bsc
。 它还告知 BSCMAKE 排除重复的 toolbox.h
实例:
BSCMAKE /n /S toolbox.h /o main.bsc file1.sbr file2.sbr file3.sbr