gccxml - Интернет в облаке

ПРОГРАММА:

ИМЯ

gccxml - Создать XML-представление объявлений C ++.

СИНТАКСИС

gccxml [параметры] -fxml =

ОПИСАНИЕ

GCC-XML анализирует исходный файл C ++ таким, каким его видит компилятор при его построении. Легко-
для синтаксического анализа XML-представление объявлений класса, функции и пространства имен сбрасывается
в указанный файл. Полная предварительная обработка C преобразует файл в модуль перевода C ++
как видит компилятор. Это означает, что GCC-XML должен использовать тот же стандарт.
библиотека и другие файлы заголовков в качестве компилятора. GCC-XML можно настроить для имитации любого
нескольких популярных компиляторов.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Для запуска GCC-XML доступны следующие параметры:

--авторское право
Распечатайте информацию об авторских правах GCC-XML и выйдите.

--отлаживать
Распечатать дополнительную отладочную информацию. Эта опция заставляет GCC-XML печатать
имя исполняемого файла и аргументы командной строки, используемые для выполнения исправленного GCC C ++
парсер. Это полезно при попытке имитировать неподдерживаемый компилятор.

-fxml =
Укажите выходной файл XML. Эта опция передается непосредственно в исправленный GCC.
Парсер C ++. Он включает дамп XML и указывает имя выходного файла.

-fxml-start = [, ...]
Укажите список начальных объявлений. Эта опция передается непосредственно в
пропатчен парсер GCC C ++. Это имеет смысл, только если также указан -fxml =. Этот
задает список именованных начальных объявлений, разделенных запятыми. GCC-XML сбросит
только доступное подмножество объявлений в единице перевода
через последовательность ссылок на источники из одного из указанных начальных
деклараций.

--gccxml-компилятор
Установите GCCXML_COMPILER на «xxx».

--gccxml-cxxflags
Установите GCCXML_CXXFLAGS на «xxx».

--gccxml-исполняемый файл
Установите GCCXML_EXECUTABLE на «xxx».

--gccxml-cpp
Установите GCCXML_CPP на «xxx».

--gccxml-конфигурация
Установите GCCXML_CONFIG на «xxx».

--gccxml-корень
Установите GCCXML_ROOT на «xxx».

--gccxml-gcc-параметры
Прочтите параметры GCC из файла «xxx». Этот параметр указывает файл, из которого следует читать
параметры для передачи пропатченному синтаксическому анализатору GCC C ++. Это полезно для указания
длинный список включаемых каталогов. Каждая строка в файле становится одним вариантом. Пустой
строки и строки, начинающиеся с символа "#", игнорируются.

--Помогите Распечатайте полную справку и выйдите. Полная справка отображает большую часть документации, предоставленной
справочную страницу UNIX. Он предназначен для использования на платформах, отличных от UNIX, но также
удобно, если страница руководства не установлена.

--help-html
Распечатать полную справку в формате HTML. Эта опция используется авторами GCC-XML, чтобы помочь
создавать веб-страницы.

--человек Распечатайте справочную страницу UNIX и выйдите. Эта опция используется авторами GCC-XML для генерации
справочную страницу UNIX.

--Распечатать
Распечатайте настройки конфигурации и выйдите. GCC-XML имеет множество параметров конфигурации для
помогите имитировать другой компилятор. Использование этой опции приведет к тому, что GCC-XML будет
настроить себя так, как если бы он собирался проанализировать исходный код C ++, но остановился и распечатал
конфигурация найдена. Это полезно для проверки конфигурации.

--предпроцесс
Предварительно обработать ввод и выйти. GCC-XML имитирует процессор другого
компилятор. Использование этого параметра приведет к тому, что GCC-XML настроится так, как если бы он был
собираюсь проанализировать исходный код C ++, но остановиться после предварительной обработки. Это полезно для
устранение проблем, связанных с моделированием другого компилятора.

-E Псевдоним для --preprocess.

--версия
Показать название программы / баннер версии и выйти.

Другие флаги, такие как -I и -D, передаются исправленному исполняемому файлу синтаксического анализатора GCC C ++.

НАСТРОЙКИ

GCC-XML предназначен для имитации синтаксического анализатора компилятора при чтении исходного кода C ++. Некоторые
параметры конфигурации необходимы, чтобы определить, как имитировать конкретный компилятор
выбор пользователя. Для настройки GCC-XML можно использовать следующие параметры:

GCCXML_COMPILER
Компилятор C ++, который нужно смоделировать. GCC-XML попытается автоматически определить
как имитировать компилятор, указанный в этом параметре. Компилятор указан
по имени исполняемого файла (например, «g ++»). Для Visual Studio компилятор
указывается "msvc6", "msvc7", "msvc71" или "msvc8" (если задано "cl", GCC-XML
пытается угадать, какой VS использовать).

GCCXML_CXXFLAGS
Флаги для симулятора C ++. Поведение большинства компиляторов может
можно настроить, указав флаги в командной строке. Когда GCC-XML пытается
автоматически определять, как моделировать компилятор, эти флаги принимаются в
рассмотрение.

GCCXML_CONFIG
Файл конфигурации для общих настроек. Когда нестандартные настройки часто
их удобно записать в один файл, содержащий их. Когда такой файл
указано, он будет прочитан для настройки любых параметров, которые еще не известны. Каждый
строка файла состоит из одного присвоения вида KEY = "VALUE" (например,
GCCXML_COMPILER = "g ++").

GCCXML_EXECUTABLE
Укажите исправленный исполняемый файл парсера GCC C ++. Программа GCC-XML глазами
пользователь фактически является интерфейсом, который определяет флаги, необходимые для настройки
пропатчен синтаксический анализатор GCC C ++ для имитации другого компилятора. Этот параметр определяет
реальный исполняемый файл для запуска после определения флагов. Пользователи должны редко
необходимо изменить это значение по умолчанию.

GCCXML_CPP
Укажите исполняемый файл препроцессора GCC C. Программа GCC-XML глазами пользователя
фактически является интерфейсом, который определяет флаги, необходимые для настройки исправленного
Парсер GCC C ++ для имитации другого компилятора. Этот параметр определяет
препроцессор для работы с флагами, которые были определены для отладки
целей. Пользователям редко нужно менять это значение по умолчанию.

GCCXML_ROOT
Каталог библиотеки поддержки GCC-XML. Поскольку GCC-XML - это только один синтаксический анализатор C ++, он
не может точно дублировать функциональность каждого компилятора, который пытается имитировать.
Некоторые компиляторы предоставляют стандартные заголовки с кодом, который GCC-XML не может напрямую
ручка. Чтобы обойти это ограничение, для каждого
компилятор. Он состоит из набора файлов заголовков, которые используются вместо
системные заголовки компилятора. Эти файлы содержат небольшие изменения, а затем включают
соответствующий реальный заголовок. Корень дерева каталогов, содержащего эту поддержку
заголовки библиотеки задаются этим параметром. Пользователям редко нужно менять
это значение по умолчанию.

GCCXML_FLAGS
Флаги, используемые для имитации другого компилятора. Когда GCC-XML запускает исправленный GCC C ++
парсера, эти флаги передаются программе, чтобы сообщить ей, как имитировать
конкретный компилятор. Этот параметр обычно определяется автоматически из других
настройки, но его могут указать непосредственно опытные пользователи. Большинству пользователей следует
не пытайтесь изменить это значение из автоматической конфигурации.

GCCXML_USER_FLAGS
Дополнительные пользовательские флаги для симуляции компилятора. Когда GCC-XML запускает исправленный GCC
Синтаксическому анализатору C ++ эти флаги передаются в дополнение к тем, которые указаны в GCCXML_FLAGS.
Это позволяет продвинутым пользователям настраивать симуляцию компилятора, продолжая использовать
автоматическая настройка GCCXML_FLAGS. Пользователям редко нужно менять это
значение по умолчанию.

Есть несколько способов настройки этих параметров. Они перечислены здесь в
порядок приоритета (сначала высший):

Командная строка Опции
Настройки можно указать с помощью соответствующих им опций. Когда обстановка
предусмотрен соответствующий параметр командной строки, он используется вместо любого другого
средства конфигурации. Если GCCXML_CONFIG установлен в командной строке, настройки
читать из файла с приоритетом чуть ниже, чем в другой командной строке
настройки.

Окружающая среда Переменные
Параметры настраиваются по имени в среде. Каждая настройка еще не известна
читается из переменной среды с ее именем. Если GCCXML_CONFIG установлен
среды, настройки считываются из файла с чуть меньшим приоритетом
чем другие переменные среды.

Конфигурация Файлы
Выполняется поиск GCCXML_CONFIG. Если GCCXML_CONFIG еще не установлен,
делается попытка найти файл конфигурации автоматически. Во-первых, если файл
$ HOME / .gccxml / config существует, он будет использоваться. Во-вторых, если выполняется GCC-XML
из каталога сборки будет использоваться файл конфигурации из этого каталога. Наконец-то,
если файл конфигурации найден в каталоге библиотеки поддержки установки, он будет
использоваться. После обнаружения любые неизвестные настройки считываются из файла конфигурации.

Гадать
Предположения сделаны на основе других настроек. После установки GCCXML_COMPILER он
используется для автоматического поиска настройки для GCCXML_FLAGS. Если он не установлен,
Переменная среды "CXX" проверяется в крайнем случае, чтобы найти параметр компилятора.
и определите GCCXML_FLAGS.

Большинству пользователей не нужно изменять значения по умолчанию для этих параметров. Есть дефолт
Файл GCCXML_CONFIG, предоставленный в каталоге библиотеки поддержки после установки. Это
настраивает GCC-XML для имитации компилятора, который использовался для его создания.

КОМПИЛЯТОРЫ

GCC-XML может имитировать любой из следующих компиляторов:

НКУ Версии 4.2, 4.1, 4.0, 3.4, 3.3, 3.2, 2.95.x

визуальный C + +
Версии 8, 7.1, 7.0 и 6 (sp5)

Борланд, Intel, SGI
ранее поддерживался, но больше не тестировался

Предоставляются следующие дополнительные определения препроцессора C:

-D__GCCXML __ = MMmmpp
MM, mm и pp - это основные, второстепенные и патч-версии GCC-XML. Этот
символ препроцессора идентифицирует GCC-XML для исходного кода в процессе его предварительной обработки.
Его можно использовать для включения информации, специфичной для GCC-XML.

-D__GCCXML_GNUC __ = M
Определен для основной версии внутреннего парсера GCC.

-D__GCCXML_GNUC_MINOR __ = m
Определен для внутренней второстепенной версии парсера GCC.

-D__GCCXML_GNUC_PATCHLEVEL __ = p
Определен для внутреннего уровня исправлений парсера GCC.

Опытные пользователи могут имитировать другие компиляторы, вручную настроив GCCXML_FLAGS.
параметр. Обратитесь за помощью в список рассылки.

МЕТАИНФО

GCC-XML добавил новый атрибут к допустимому набору атрибутов C / C ++. Атрибут
используется для присоединения метаинформации к исходному коду C / C ++, который затем появится в XML
выход. Синтаксис объявления атрибута следующий:

__attribute ((gccxml ( , , ...)))
Здесь строка в кавычках. Должен быть хотя бы один аргумент для
'gccxml', но нет верхнего предела для общего количества аргументов.
Каждый аргумент проверяется как строка - если найден нестроковый аргумент,
атрибут игнорируется.

Выходные данные XML для элемента кода, помеченного атрибутом, будут затем содержать
следующие:

атрибуты = " ... gccxml ( , , ...) ...
Атрибут XML "attributes" содержит все атрибуты, применяемые к элементу кода.
Каждый аргумент атрибута печатается без кавычек, поэтому, если
аргумент содержит символ ',', аргумент будет выглядеть как несколько
аргументы.

Атрибут gccxml может применяться к любому объявлению, включая структуры, классы,
поля, параметры, методы, функции, переменные и определения типов. Единственное исключение -
что обработка GCC языкового элемента '__attribute' в настоящее время нарушена для
перечисления и конструкторы со встроенным телом. Можно использовать атрибут 'gccxml'
любое количество раз по данному объявлению.

В качестве примера того, как этот атрибут можно использовать для присоединения метаинформации к C ++
объявлений, рассмотрите следующий макрос:

#define _из_ __attribute ((gccxml ("вне")))
Здесь _out_ был определен как атрибут gccxml, где первый аргумент
это строка «out». Рекомендуется использовать первый аргумент как уникальный
строковое имя для типа метаинформации begin.

Теперь объявление метода можно записать следующим образом:

аннулировать getInteger (_out_ int & я);
Это приведет к тому, что вывод XML будет содержать метаинформацию для '_out_'
атрибут в виде "gccxml (out)".

Использование атрибута gccxml позволяет включать метаинформацию непосредственно в C ++.
исходный код, без необходимости использования специального парсера для извлечения метаинформации. В
Атрибут gccxml предоставлен только для удобства - нет гарантии, что в будущем
версии GCC будут принимать языковой элемент __attribute без ошибок.

АВТОРСКИЕ ПРАВА

GCC-XML - вывод XML для GCC

Авторские права 2002-2012 Kitware, Inc., Insight Consortium

Распространение и использование в исходной и двоичной формах, с модификациями или без них, являются
разрешено при соблюдении следующих условий:

* При повторном распространении исходного кода должно сохраняться указанное выше уведомление об авторских правах, этот список
условия и следующий отказ от ответственности.

* Распространение в двоичной форме должно воспроизводить указанное выше уведомление об авторских правах, этот список
условий и следующий отказ от ответственности в документации и / или других
материалы, поставляемые с распространением.

* Ни названия Kitware, Inc., Insight Software Consortium, ни названия
их авторов могут быть использованы для поддержки или продвижения продуктов, полученных из этого
программное обеспечение без специального предварительного письменного разрешения.

ДАННОЕ ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ ОБЛАДАТЕЛЯМИ АВТОРСКИХ ПРАВ И СОСТАВЛЯМИ «КАК ЕСТЬ» И ЛЮБЫМИ
ЯВНЫЕ ИЛИ ПОДРАЗУМЕВАЕМЫЕ ГАРАНТИИ, ВКЛЮЧАЯ, НЕ ОГРАНИЧИВАясь, ПОДРАЗУМЕВАЕМЫЕ ГАРАНТИИ
КОММЕРЧЕСКАЯ ЦЕННОСТЬ И ПРИГОДНОСТЬ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ ОТКАЗЫВАЕТСЯ. НИ В КОЕМ СЛУЧАЕ
ВЛАДЕЛЬЦА АВТОРСКИХ ПРАВ ИЛИ СОСТАВНИКИ НЕСЕТ ОТВЕТСТВЕННОСТЬ ЗА ЛЮБЫЕ ПРЯМЫЕ, КОСВЕННЫЕ, СЛУЧАЙНЫЕ, ОСОБЫЕ,
ПРИМЕРНЫЕ ИЛИ КОСВЕННЫЕ УБЫТКИ (ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ, ЗАКУПКИ
ЗАМЕНА ТОВАРОВ ИЛИ УСЛУГ; ПОТЕРЯ ИСПОЛЬЗОВАНИЯ, ДАННЫХ ИЛИ ПРИБЫЛИ; ИЛИ ПРЕРЫВАНИЕ БИЗНЕСА)
ОДНАКО ПРИЧИНЕННАЯ И ПО ЛЮБОЙ ТЕОРИИ ОТВЕТСТВЕННОСТИ, ЛИБО ПО КОНТРАКТУ, СТРОГОЙ ОТВЕТСТВЕННОСТИ ИЛИ
ДЕЛЕНИЕ (ВКЛЮЧАЯ НЕБРЕЖНОСТЬ ИЛИ ИНОЕ), ВОЗНИКАЮЩЕЕ ЛЮБОЙ СПОСОБ ПРИ ИСПОЛЬЗОВАНИИ ЭТОГО
ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ, ДАЖЕ ОБЪЯВЛЕНИЕ О ВОЗМОЖНОСТИ ТАКОГО ПОВРЕЖДЕНИЯ.

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

gccxml_cc1plus - парсер GCC исправлен для дампов XML единиц перевода

Авторские права 2002-2012 Kitware, Inc., Insight Consortium

Эта программа является бесплатным программным обеспечением; вы можете распространять и / или изменять его в соответствии с условиями
Стандартная общественная лицензия GNU, опубликованная Free Software Foundation; или
версия 2 лицензии или (по вашему выбору) любая более поздняя версия.

Эта программа распространяется в надежде, что она будет полезна, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ;
даже без подразумеваемых гарантий ТОВАРНОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
Подробнее см. Стандартную общественную лицензию GNU.

Вы должны были получить копию Стандартной общественной лицензии GNU вместе с этой программой;
если нет, напишите в
Free Software Foundation, Inc.
51 Франклин-стрит, пятый этаж
Бостон, Массачусетс 02110-1301 США

ПОЧТОВОЕ ОТПРАВЛЕНИЕ СПИСОК

Для получения помощи и обсуждения использования gccxml список рассылки доступен по адресу
[электронная почта защищена]. Пожалуйста, сначала прочтите полную документацию по адресу http://www.gccxml.org
перед размещением вопросов в списке.

Используйте gccxml в Интернете с помощью сервисов onworks.net