Options BSCMAKE
Avertissement
Bien que BSCMAKE soit toujours installé avec Visual Studio, il n’est plus utilisé par l’IDE. Depuis Visual Studio 2008, les informations de navigation et de symbole sont stockées automatiquement dans un fichier SQL Server .sdf dans le dossier solution.
Cette section décrit les options disponibles pour contrôler BSCMAKE. Plusieurs options contrôlent le contenu du fichier d’informations parcourir en excluant ou en incluant certaines informations. Les options d’exclusion peuvent permettre à BSCMAKE de s’exécuter plus rapidement et peuvent entraîner un fichier plus petit .bsc . Les noms d’options respectent la casse (à l’exception /HELP de et /NOLOGO).
Seuls /NOLOGO et /o sont disponibles à partir de l’environnement de développement Visual Studio. Pour plus d’informations, consultez Définir le compilateur C++ et les propriétés de build dans Visual Studio.
Options
/Ei (filename ...)
Exclut le contenu d’un ou plusieurs fichiers include spécifiés filename du fichier d’informations parcourir. Pour spécifier plusieurs fichiers, séparez les noms par un espace et placez la liste entre parenthèses. Les parenthèses ne sont pas nécessaires si vous spécifiez un seul filename. Utilisez /Ei l’option permettant d’exclure /Es les fichiers non exclus par /Es.
/El
Exclut les symboles locaux. La valeur par défaut consiste à inclure des symboles locaux. Pour plus d’informations sur les symboles locaux, consultez Création d’un fichier .sbr.
/Em
Exclut les symboles dans le corps des macros. Permet /Em d’inclure uniquement les noms de macros dans le fichier d’informations parcourir. La valeur par défaut consiste à inclure les noms de macros et le résultat des expansions de macro.
/Er (symbol ...)
Exclut un ou plusieurs des symboles spécifiés symbol du fichier d’informations parcourir. Pour spécifier plusieurs noms de symboles, séparez les noms par un espace et placez la liste entre parenthèses. Les parenthèses sont inutiles si vous ne spécifiez qu’un seul symbol.
/Es
Exclut chaque fichier include spécifié avec un chemin d’accès absolu ou trouvé dans un chemin d’accès absolu spécifié dans la variable d’environnement INCLUDE. (En règle générale, ces fichiers sont les fichiers include système, qui contiennent beaucoup d’informations dont vous n’avez peut-être pas besoin dans votre fichier d’informations de navigation.) Cette option n’exclut pas les fichiers spécifiés sans chemin d’accès, ou avec des chemins relatifs, ou des fichiers trouvés dans un chemin relatif dans INCLUDE. Vous pouvez utiliser l’option /Ei ainsi que /Es pour exclure les fichiers qui /Es n’excluent pas. Si vous souhaitez exclure uniquement certains des fichiers, utilisez /Ei plutôt /Esque les fichiers et listez les fichiers que vous souhaitez exclure.
/errorreport:[ nonesend | | prompt | queue]
Cette fonction est déconseillée. Dans Windows Vista et versions ultérieures, le rapport d’erreurs est contrôlé par les paramètres de rapport d’erreurs Windows (WER ).
/HELP
Affiche un résumé de la syntaxe de ligne de commande BSCMAKE.
/Iu
Inclut des symboles non référencés. Par défaut, BSCMAKE n’enregistre aucun symbole défini, mais non référencé. Si un .sbr fichier a été compressé, cette option n’a aucun effet pour ce fichier d’entrée, car le compilateur a déjà supprimé les symboles non référencés.
/n
Force une build non incrémentielle. Permet /n de forcer une build complète du fichier d’informations de navigation si un .bsc fichier existe ou non, et pour empêcher la .sbr troncation des fichiers. Pour plus d’informations, consultez Comment BSCMAKE génère un .bsc fichier.
/NOLOGO
Supprime le message de copyright BSCMAKE.
/o filename
Le filename paramètre d’option spécifie un nom pour le fichier d’informations de navigation. Par défaut, BSCMAKE fournit au fichier d’informations de navigation le nom de base du premier .sbr fichier et une .bsc extension.
/S (filename ...)
Indique à BSCMAKE de traiter chaque fichier include spécifié filename la première fois qu’il est rencontré et de l’exclure sinon. Utilisez cette option pour gagner du temps de traitement lorsqu’un fichier (par exemple, un en-tête ou .hun fichier pour un .c fichier .cpp source) est inclus dans plusieurs fichiers sources, mais n’est pas modifié par les directives de prétraitement à chaque fois. Utilisez cette option si un fichier est modifié de manière non importante pour le fichier d’informations de navigation que vous créez. Pour spécifier plusieurs fichiers, séparez les noms par un espace et placez la liste entre parenthèses. Les parenthèses ne sont pas nécessaires si vous spécifiez un seul filename. Si vous souhaitez exclure le fichier chaque fois qu’il est inclus, utilisez l’option ou /Es l’option/Ei.
/v
Fournit une sortie détaillée, qui inclut le nom de chaque .sbr fichier en cours de traitement et des informations sur l’exécution complète de BSCMAKE.
/?
Affiche un bref résumé de la syntaxe de ligne de commande BSCMAKE.
Exemple
La ligne de commande suivante indique à BSCMAKE d’effectuer une build complète de main.bsc trois .sbr fichiers. Il indique également à BSCMAKE d’exclure les instances dupliquées de toolbox.h:
BSCMAKE /n /S toolbox.h /o main.bsc file1.sbr file2.sbr file3.sbr