gccxml - En ligne dans le Cloud

PROGRAMME:

Nom

gccxml - Créer une représentation XML des déclarations C++.

SYNOPSIS

gccxml [options] -fxml=

DESCRIPTION

GCC-XML analyse un fichier source C++ tel qu'il est vu par le compilateur lors de sa construction. Un facile-
la représentation XML à analyser des déclarations de classe, de fonction et d'espace de noms est vidé
dans un fichier spécifié. Le prétraitement C complet transforme le fichier en une unité de traduction C++
comme vu par le compilateur. Cela signifie que GCC-XML doit utiliser le même standard
bibliothèque et autres fichiers d'en-tête en tant que compilateur. GCC-XML peut être configuré pour simuler n'importe quel
de plusieurs compilateurs populaires.

OPTIONS

Les options suivantes sont disponibles pour exécuter GCC-XML :

--droits d'auteur
Imprimez le copyright GCC-XML et quittez.

--déboguer
Imprimez des informations de débogage supplémentaires. Cette option permet à GCC-XML d'imprimer le
nom de l'exécutable et arguments de ligne de commande utilisés pour exécuter le GCC C++ corrigé
analyseur. Ceci est utile lorsque vous essayez de simuler un compilateur non pris en charge.

-fxml=
Spécifiez le fichier de sortie XML. Cette option est transmise directement au GCC patché
analyseur C++. Il active le vidage XML et spécifie le nom du fichier de sortie.

-fxml-start= [,...]
Spécifiez une liste de déclarations de départ. Cette option est transmise directement au
parseur GCC C++ corrigé. Il n'a de sens que si -fxml= est également spécifié. Cette
spécifie une liste séparée par des virgules de déclarations de départ nommées. GCC-XML videra
seul le sous-ensemble des déclarations dans l'unité de traduction qui est accessible
via une séquence de références source à partir de l'un des
déclarations.

--gccxml-compilateur
Définissez GCCXML_COMPILER sur "xxx".

--gccxml-cxxflags
Définissez GCCXML_CXXFLAGS sur « xxx ».

--gccxml-exécutable
Définissez GCCXML_EXECUTABLE sur "xxx".

--gccxml-cpp
Définissez GCCXML_CPP sur « xxx ».

--gccxml-config
Définissez GCCXML_CONFIG sur "xxx".

--gccxml-racine
Définissez GCCXML_ROOT sur "xxx".

--gccxml-gcc-options
Lisez les options GCC à partir du fichier "xxx". Cette option spécifie un fichier à partir duquel lire
options à transmettre à l'analyseur syntaxique GCC C++ corrigé. Ceci est utile pour spécifier un
longue liste de répertoires d'inclusion. Chaque ligne du fichier devient une option. Vide
les lignes et les lignes commençant par '#' sont ignorées.

--Aidez-moi Imprimez l'aide complète et quittez. L'aide complète affiche la plupart de la documentation fournie par
la page de manuel UNIX. Il est fourni pour une utilisation sur des plates-formes non UNIX, mais est également
pratique si la page de manuel n'est pas installée.

--help-html
Imprimer l'aide complète au format HTML. Cette option est utilisée par les auteurs GCC-XML pour aider
produire des pages Web.

--homme Imprimez une page de manuel UNIX et quittez. Cette option est utilisée par les auteurs GCC-XML pour générer
la page de manuel UNIX.

--imprimer
Imprimez les paramètres de configuration et quittez. GCC-XML a de nombreuses options de configuration pour
l'aider à simuler un autre compilateur. L'utilisation de cette option fera que GCC-XML
se configure comme s'il allait analyser la source C++, mais s'arrête et imprime
la configuration trouvée. Ceci est utile pour vérifier la configuration.

--prétraiter
Prétraitez l'entrée et la sortie. GCC-XML simule le proprocesseur d'un autre
compilateur. L'utilisation de cette option entraînera la configuration de GCC-XML comme s'il était
va analyser la source C++, mais s'arrêter après le prétraitement. Ceci est utile pour
problèmes de débogage liés à la simulation de l'autre compilateur.

-E Alias ​​pour --preprocess.

--version
Affichez le nom/la bannière de la version du programme et quittez.

D'autres indicateurs, tels que -I et -D, sont transmis à l'exécutable d'analyseur GCC C++ corrigé.

REGLAGES

GCC-XML est conçu pour simuler l'analyseur syntaxique d'un compilateur lors de la lecture du code source C++. Certains
les paramètres de configuration sont nécessaires pour déterminer comment simuler un compilateur particulier de
le choix de l'utilisateur. Les paramètres suivants peuvent être utilisés pour configurer GCC-XML :

GCCXML_COMPILER
Le compilateur C++ à simuler. GCC-XML tentera de déterminer automatiquement
comment simuler le compilateur spécifié par ce paramètre. Le compilateur est spécifié
par son nom d'exécutable (comme "g++"). Pour Visual Studio, le compilateur est
spécifié par "msvc6", "msvc7", "msvc71" ou "msvc8" (si "cl" est donné, GCC-XML
essaie de deviner quel VS utiliser).

GCCXML_CXXFLAGS
Les drapeaux du compilateur C++ à simuler. Le comportement de la plupart des compilateurs peut
être ajusté en spécifiant des drapeaux sur la ligne de commande. Lorsque GCC-XML tente de
déterminent automatiquement comment simuler un compilateur, ces drapeaux sont pris en compte
considération.

GCCXML_CONFIG
Le fichier de configuration pour les paramètres communs. Lorsque des paramètres autres que ceux par défaut sont souvent
utilisé, il est pratique d'écrire un seul fichier les contenant. Lorsqu'un tel fichier est
spécifié, il sera lu pour configurer les paramètres qui ne sont pas encore connus. Chaque
ligne du fichier se compose d'une affectation de la forme KEY="VALUE" (par exemple,
GCCXML_COMPILER="g++").

GCCXML_EXECUTABLE
Spécifiez l'exécutable d'analyseur GCC C++ corrigé. Le programme GCC-XML vu par le
l'utilisateur est en fait un frontal qui détermine les drapeaux nécessaires pour configurer le
parseur GCC C++ corrigé pour simuler un autre compilateur. Ce paramètre spécifie le
exécutable réel à exécuter une fois que les indicateurs ont été déterminés. Les utilisateurs devraient rarement
besoin de changer cette valeur par défaut.

GCCXML_CPP
Spécifiez l'exécutable du préprocesseur GCC C. Le programme GCC-XML vu par l'utilisateur
est en fait un frontal qui détermine les drapeaux nécessaires pour configurer le patché
Analyseur GCC C++ pour simuler un autre compilateur. Ce paramètre spécifie le
préprocesseur à exécuter avec les indicateurs qui ont été déterminés pour le débogage
fins. Les utilisateurs devraient rarement avoir besoin de modifier cette valeur par défaut.

GCCXML_ROOT
Le répertoire de la bibliothèque de support GCC-XML. Comme GCC-XML n'est qu'un analyseur C++, il
ne peut pas dupliquer exactement la fonctionnalité de chaque compilateur qu'il essaie de simuler.
Certains compilateurs fournissent des en-têtes standard avec du code que GCC-XML ne peut pas directement
manipuler. Pour contourner cette limitation, une bibliothèque de support est fournie pour chaque
compilateur. Il s'agit d'un ensemble de fichiers d'en-tête qui sont utilisés à la place du
en-têtes système du compilateur. Ces fichiers contiennent de légères modifications et incluent ensuite le
en-tête réel correspondant. La racine de l'arborescence des répertoires contenant ces supports
les en-têtes de bibliothèque sont spécifiés par ce paramètre. Les utilisateurs devraient rarement avoir besoin de changer
cette valeur à partir de sa valeur par défaut.

GCCXML_FLAGS
Indicateurs utilisés pour simuler l'autre compilateur. Lorsque GCC-XML exécute le correctif GCC C++
parseur, ces drapeaux sont passés au programme pour lui dire comment simuler un
compilateur particulier. Ce paramètre est généralement détecté automatiquement par les autres
paramètres, mais il peut être spécifié directement par les utilisateurs avancés. La plupart des utilisateurs devraient
n'essayez pas de modifier cette valeur à partir de la configuration automatique.

GCCXML_USER_FLAGS
Indicateurs utilisateur supplémentaires pour la simulation du compilateur. Lorsque GCC-XML exécute le GCC corrigé
analyseur C++, ces indicateurs sont passés en plus de ceux spécifiés par GCCXML_FLAGS.
Cela permet aux utilisateurs avancés de peaufiner la simulation du compilateur tout en utilisant le
configuration automatique de GCCXML_FLAGS. Les utilisateurs devraient rarement avoir besoin de changer cela
valeur de sa valeur par défaut.

Il existe plusieurs moyens de configurer ces paramètres. Ils sont répertoriés ici dans
ordre de priorité (le plus élevé en premier) :

Ligne de commande Options
Les paramètres peuvent être spécifiés par leurs options correspondantes. Lorsqu'un paramètre est
l'option de ligne de commande correspondante est fournie, elle est utilisée en faveur de toute autre
moyens de configuration. Si GCCXML_CONFIG est défini sur la ligne de commande, les paramètres sont
lire à partir du fichier avec une priorité légèrement inférieure à celle des autres lignes de commande
options.

Environment Variables
Les paramètres sont configurés par nom dans l'environnement. Chaque paramètre n'est pas déjà connu
est lu à partir d'une variable d'environnement avec son nom. Si GCCXML_CONFIG est défini par le
environnement, les paramètres sont lus à partir du fichier avec une priorité légèrement inférieure
que d'autres variables d'environnement.

configuration Fichiers
Une recherche de GCCXML_CONFIG est effectuée. Si GCCXML_CONFIG n'a pas encore été défini, un
une tentative est faite pour trouver un fichier de configuration automatiquement. Premièrement, si le fichier
$HOME/.gccxml/config existe, il sera utilisé. Deuxièmement, si GCC-XML est en cours d'exécution
à partir de son répertoire de construction, un fichier de configuration de ce répertoire sera utilisé. Finalement,
si un fichier de configuration est trouvé dans le répertoire de la bibliothèque de support de l'installation, il sera
être utilisé. Une fois trouvés, tous les paramètres inconnus sont lus à partir du fichier de configuration.

Devinant
Les suppositions sont faites en fonction d'autres paramètres. Une fois GCCXML_COMPILER défini, il est
utilisé pour trouver automatiquement le paramètre pour GCCXML_FLAGS. S'il n'est pas défini, le
La variable d'environnement "CXX" est vérifiée en dernier recours pour trouver le paramètre du compilateur
et déterminer GCCXML_FLAGS.

La plupart des utilisateurs ne devraient pas avoir à ajuster les valeurs par défaut de ces paramètres. Il y a un défaut
Fichier GCCXML_CONFIG fourni dans le répertoire de la bibliothèque de support après l'installation. Ce
configure GCC-XML pour simuler le compilateur qui a été utilisé pour le construire.

COMPILATEURS

GCC-XML peut simuler l'un des compilateurs suivants :

GCC Versions 4.2, 4.1, 4.0, 3.4, 3.3, 3.2, 2.95.x

Visuel C + +
Versions 8, 7.1, 7.0 et 6 (sp5)

Borland Intel, SGI
anciennement pris en charge mais plus testé

Les définitions de préprocesseur C supplémentaires suivantes sont fournies :

-D__GCCXML__=MMmmpp
MM, mm et pp sont les versions majeure, mineure et patch de GCC-XML. Cette
Le symbole du préprocesseur identifie GCC-XML au code source tel qu'il est prétraité.
Il peut être utilisé pour activer les informations spécifiques à GCC-XML.

-D__GCCXML_GNUC__=M
Défini sur la version majeure de l'analyseur GCC interne.

-D__GCCXML_GNUC_MINOR__=m
Défini à la version mineure de l'analyseur GCC interne.

-D__GCCXML_GNUC_PATCHLEVEL__=p
Défini au niveau de correctif de l'analyseur GCC interne.

Les utilisateurs avancés peuvent simuler d'autres compilateurs en configurant manuellement GCCXML_FLAGS
réglage. Contactez la liste de diffusion pour obtenir de l'aide.

MÉTAINFO

GCC-XML a ajouté un nouvel attribut à l'ensemble légal d'attributs C/C++. L'attribut est
utilisé pour joindre des méta-informations au code source C/C++, qui apparaîtra ensuite dans le XML
sortir. La syntaxe pour déclarer un attribut est la suivante :

__attribute((gccxml( , , ...)))
Ici est une chaîne entre guillemets. Il doit y avoir au moins un argument au
'gccxml', mais il n'y a pas de limite supérieure au nombre total d'arguments.
Chaque argument est vérifié comme étant une chaîne - si un argument autre qu'une chaîne est trouvé, le
l'attribut est ignoré.

La sortie XML pour l'élément de code qui est étiqueté avec l'attribut contiendra alors
ce qui suit:

attributs=" gccxml( , , ...)
L'attribut XML 'attributes' contient tous les attributs appliqués à l'élément de code.
Chaque argument de l'attribut est affiché sans guillemets, donc si un
l'argument contient le caractère ',', l'argument semblera être multiple
arguments.

L'attribut 'gccxml' peut être appliqué à n'importe quelle déclaration, y compris les structs, les classes,
champs, paramètres, méthodes, fonctions, variables et définitions de type. La seule exception est
que la gestion par GCC de l'élément de langage '__attribute' est actuellement interrompue pour
énumérations et constructeurs avec un corps en ligne. L'attribut 'gccxml' peut être utilisé
un nombre quelconque de fois sur une déclaration donnée.

Comme exemple de la façon dont cet attribut peut être utilisé pour attacher des méta-informations à C++
déclarations, considérez la macro suivante :

#define _dehors_ __attribute((gccxml("out"))))
Ici '_out_' a été défini pour être l'attribut gccxml où le premier argument
est la chaîne "out". Il est recommandé d'utiliser le premier argument comme unique
nom de chaîne pour le type de méta-information qui commence à être appliqué.

Maintenant, une déclaration de méthode peut être écrite comme suit :

annuler getInteger(_out_ int& je);
Cela entraînera la sortie XML de contenir des méta-informations pour le '_out_'
attribut, sous la forme "gccxml(out)".

L'utilisation de l'attribut 'gccxml' permet d'inclure directement les méta-informations dans C++
code source, sans avoir besoin d'un analyseur personnalisé pour extraire les méta-informations. Les
L'attribut 'gccxml' est fourni uniquement pour plus de commodité - il n'y a aucune garantie que l'avenir
les versions de GCC accepteront l'élément de langage '__attribute' d'une manière sans bogue.

DROIT D'AUTEUR

GCC-XML - Sortie XML pour GCC

Copyright 2002-2012 Kitware, Inc., Consortium Insight

La redistribution et l'utilisation sous forme source et binaire, avec ou sans modification, sont
autorisé à condition que les conditions suivantes soient remplies :

* Les redistributions du code source doivent conserver l'avis de droit d'auteur ci-dessus, cette liste de
conditions et la clause de non-responsabilité suivante.

* Les redistributions sous forme binaire doivent reproduire l'avis de droit d'auteur ci-dessus, cette liste
des conditions et la clause de non-responsabilité suivante dans la documentation et/ou d'autres
matériel fourni avec la distribution.

* Ni les noms de Kitware, Inc., le Insight Software Consortium, ni les noms
de leurs contributeurs peuvent être utilisés pour approuver ou promouvoir des produits dérivés de ce
logiciel sans autorisation écrite préalable spécifique.

CE LOGICIEL EST FOURNI PAR LES TITULAIRES DES DROITS D'AUTEUR ET LES CONTRIBUTEURS « EN L'ÉTAT » ET TOUT
GARANTIES EXPRESSES OU IMPLICITES, Y COMPRIS, MAIS SANS S'Y LIMITER, LES GARANTIES IMPLICITES DE
LA VALEUR MARCHANDE ET L'ADAPTATION A UN USAGE PARTICULIER SONT EXCLUES. EN AUCUN CAS, LE
LE TITULAIRE DES DROITS D'AUTEUR OU LES CONTRIBUTEURS SERONT RESPONSABLES DE TOUTES PROCÉDURES DIRECTES, INDIRECTES, ACCESSOIRES, SPÉCIALES,
DOMMAGES EXEMPLAIRES OU CONSÉCUTIFS (Y COMPRIS, MAIS SANS S'Y LIMITER, L'ACHAT DE
BIENS OU SERVICES DE SUBSTITUTION ; PERTE D'UTILISATION, DE DONNÉES OU DE BÉNÉFICES ; OU INTERRUPTION DES AFFAIRES)
TOUTEFOIS CAUSÉ ET SUR TOUTE THÉORIE DE RESPONSABILITÉ, QUE CE SOIT DANS LE CONTRAT, LA RESPONSABILITÉ STRICTE OU
DÉLIT (Y COMPRIS LA NÉGLIGENCE OU AUTRE) DÉCOULANT DE QUELQUE MANIÈRE QUE CE SOIT DE L'UTILISATION DE CE
LOGICIEL, MÊME SI AVISÉ DE LA POSSIBILITÉ DE TELS DOMMAGES.

-------------------------------------------------- ----------

gccxml_cc1plus - Un analyseur GCC corrigé pour les vidages XML des unités de traduction

Copyright 2002-2012 Kitware, Inc., Consortium Insight

Ce programme est un logiciel libre ; vous pouvez le redistribuer et/ou le modifier selon les termes de
la licence publique générale GNU telle que publiée par la Free Software Foundation ; Soit
la version 2 de la licence ou (à votre choix) toute version ultérieure.

Ce programme est distribué dans l'espoir qu'il sera utile, mais SANS AUCUNE GARANTIE ;
sans même la garantie implicite de QUALITÉ MARCHANDE ou D'ADAPTATION À UN USAGE PARTICULIER.
Voir la licence publique générale GNU pour plus de détails.

Vous devriez avoir reçu une copie de la licence publique générale GNU avec ce programme ;
sinon, écrivez au
Fondation du logiciel libre, Inc.
51, rue Franklin, cinquième étage
Boston, MA 02110-1301 États-Unis

ENVOI POSTAL LISTE

Pour obtenir de l'aide et des discussions sur l'utilisation de gccxml, une liste de diffusion est fournie à l'adresse
gccxml@www.gccxml.org. Veuillez d'abord lire la documentation complète sur http://www.gccxml.org
avant de poster des questions sur la liste.

Utilisez gccxml en ligne à l'aide des services onworks.net