BSCMAKE オプション
警告
BSCMAKE は、現在も Visual Studio と共にインストールされていますが、IDE では使用されなくなりました。 Visual Studio 2008 以降、ブラウザー情報とシンボル情報は、ソリューション フォルダー内の SQL Server の .sdf ファイルに自動的に格納されます。
ここでは、BSCMAKE を制御するためのオプションを説明します。 一部のオプションでは、特定の情報を除外するか、または含めることによってブラウザー情報ファイルの内容を制御できます。 除外オプションを使用すると、BSCMAKE の処理が速くなるだけでなく、.bsc ファイルのサイズが小さくなる場合があります。 /HELP と /NOLOGO 以外のオプション名は、大文字と小文字が区別されます。
Visual Studio 開発環境で利用できるのは、/NOLOGO と /o だけです。 詳しくは、「Visual Studio で C++ コンパイラとビルド プロパティを設定する」をご覧ください。
[オプション]
/Ei (filename ...)
指定した 1 つ以上の filename インクルード ファイルの内容をブラウザー情報ファイルから除外します。 複数のファイルを指定する場合は、スペースで名前を区切り、名前のリストをかっこで囲みます。 filenameを 1 つだけ指定する場合、かっこは必要ありません。 /Ei を /Es オプションと一緒に使用すると、/Es で除外されないファイルを除外できます。
/El
ローカル シンボルを除外します。 既定では、ローカル シンボルは含まれます。 ローカル シンボルの詳細については、「.sbr ファイルの作成」を参照してください。
/Em
マクロの本体のシンボルを除外します。 /Em を使用すると、ブラウザー情報ファイルでマクロの名前だけを含めることができます。 既定では、マクロ名とマクロの展開の結果の両方が含められます。
/Er (symbol ...)
指定した 1 つ以上の symbol シンボルをブラウザー情報ファイルから除外します。 複数のシンボル名を指定する場合は、スペースで名前を区切り、名前のリストをかっこで囲みます。 symbolを 1 つだけ指定する場合、かっこは不要です。
/Es
絶対パスで指定されたインクルード ファイル、または INCLUDE 環境変数内の絶対パスで検索できるインクルード ファイルを、すべて除外します。 (通常、これらのファイルはシステムインクルードファイルであり、参照情報ファイルには必要ない多くの情報が含まれています)。このオプションでは、パスなしで指定されたファイル、相対パスを持つファイル、または INCLUDE の相対パスにあるファイルは除外されません。 /Ei オプションと/Esを使用して、/Esが除外しないファイルを除外できます。 一部のファイルのみを除外する場合は、/Esではなく/Eiを使用し、除外するファイルを一覧表示します。
/errorreport:[ none | prompt | queue | send ]
このオプションは非推奨です。 Windows Vista 以降では、エラー報告は Windows エラー報告 (WER) の設定によって制御されます。
/HELP
BSCMAKE コマンド ライン構文の簡単な説明を表示します。
/Iu
未参照シンボルを含めます。 既定では、BSCMAKE では定義されているが参照はされていないシンボルは記録されません。 .sbr ファイルがパックされている場合、このオプションはその入力ファイルには効果がありません。なぜなら、コンパイラによって未参照シンボルが既に削除されているためです。
/n
ノンインクリメンタル ビルドを強制的に実行します。 /n を使用すると、.bsc ファイルが存在するかどうかに関係なく、ブラウザー情報ファイルのフル ビルドが強制的に実行され、.sbr ファイルの切り詰めが行われません。 詳細については、「BSCMAKE による .bsc ファイルのビルド方法」を参照してください。
/NOLOGO
BSCMAKE の著作権メッセージが表示されなくなります。
/o filename
オプションの filename パラメーターにより、参照情報ファイルの名前が指定されます。 既定では、BSCMAKE によるブラウザー情報ファイルの名前は、最初の .sbr ファイルの基本名と拡張子 .bsc で構成されます。
/S (filename ...)
指定した各 filename インクルード ファイルを最初に見つけたときに処理し、それ以降では除外するように BSCMAKE に指示します。 このオプションを使用すると、ファイル (.c または .cpp ソース ファイルのヘッダー (.h) ファイルなど) が複数のソース ファイルにインクルードされているが、プリプロス ディレクティブによって毎回変更されない場合に、処理時間を短縮できます。 作成するブラウザー情報ファイルにとってあまり重要ではない方法でファイルが変更される場合に、このオプションを使います。 複数のファイルを指定する場合は、スペースで名前を区切り、そのリストをかっこで囲みます。 filenameを 1 つだけ指定する場合、かっこは必要ありません。 ファイルを含めるたびに除外する場合は、 /Ei または /Es オプションを使用します。
/v
処理される各 .sbr ファイルの名前や、完全な BSCMAKE の実行についての情報が含まれる詳細出力を表示します。
/?
BSCMAKE コマンド ライン構文の簡単な説明を表示します。
例
3 つの .sbr ファイルから main.bsc のフル ビルドを実行するよう BSCMAKE に指示するには、次のコマンド ラインを使用します。 このコマンド ラインでは、toolbox.h の重複インスタンスが除外されます。
BSCMAKE /n /S toolbox.h /o main.bsc file1.sbr file2.sbr file3.sbr