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-config
Встановіть GCCXML_CONFIG на "xxx".

--gccxml-корінь
Встановіть GCCXML_ROOT на "xxx".

--gccxml-gcc-параметри
Прочитайте параметри GCC з файлу "xxx". Цей параметр визначає файл, з якого потрібно читати
параметри для передачі до виправленого синтаксичного аналізатора GCC C++. Це корисно для вказівки a
довгий список включаються каталогів. Кожен рядок у файлі стає одним параметром. Порожній
рядки та рядки, що починаються з '#', ігноруються.

--допомога Роздрукуйте повну довідку та вийдіть. Повна довідка відображає більшість наданої документації
сторінку керівництва UNIX. Він надається для використання на платформах, які не є UNIX, але також є
зручно, якщо сторінка man не встановлена.

--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, як бачить
user насправді є інтерфейсом, який визначає прапори, необхідні для налаштування
виправлений синтаксичний аналізатор 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++
аналізатор, ці прапори передаються програмі, щоб сказати їй, як моделювати a
конкретний компілятор. Цей параметр зазвичай визначається автоматично з іншого
налаштування, але його можуть вказати безпосередньо досвідчені користувачі. Більшість користувачів повинні
не намагайтеся змінити це значення з автоматичної конфігурації.

GCCXML_USER_FLAGS
Додаткові позначки користувача для моделювання компілятора. Коли GCC-XML запускає виправлений GCC
Синтаксичний аналізатор C++, ці прапори передаються на додаток до тих, які вказано GCCXML_FLAGS.
Це дозволяє досвідченим користувачам налаштовувати симуляцію компілятора, використовуючи
автоматичне налаштування GCCXML_FLAGS. Користувачам рідко доведеться це змінювати
значення за замовчуванням.

Існує кілька способів налаштування цих параметрів. Вони перераховані тут у
порядок пріоритету (спершу найвищий):

Командний рядок Опції
Налаштування можна вказати відповідними параметрами. Коли налаштування
надається відповідна опція командного рядка, вона використовується на користь будь-якої іншої
засоби конфігурації. Якщо GCCXML_CONFIG встановлено в командному рядку, параметри є
читання з файлу з пріоритетом трохи нижче, ніж в інших командних рядках
Варіанти.

Навколишнє середовище Змінні
Налаштування налаштовуються за назвою в середовищі. Кожне налаштування ще не відоме
зчитується зі змінної середовища з її іменем. Якщо GCCXML_CONFIG встановлено за допомогою
середовища, налаштування зчитуються з файлу з пріоритетом трохи нижче
ніж інші змінні середовища.

конфігурація Файли
Виконується пошук GCCXML_CONFIG. Якщо GCCXML_CONFIG ще не встановлено, an
робиться спроба автоматично знайти файл конфігурації. По-перше, якщо файл
$HOME/.gccxml/config існує, він буде використаний. По-друге, якщо GCC-XML виконується
з його каталогу збірки буде використаний файл конфігурації з цього каталогу. нарешті,
якщо файл конфігурації знайдено в каталозі бібліотеки підтримки інсталяції, він буде
бути використаним. Після виявлення всі невідомі налаштування зчитуються з файлу конфігурації.

Відгадування
Припущення робляться на основі інших налаштувань. Після того, як GCCXML_COMPILER встановлено, він є
використовується для автоматичного пошуку параметрів для GCCXML_FLAGS. Якщо він не встановлений, то
Змінна середовища "CXX" перевіряється як останній засіб для пошуку параметрів компілятора
і визначити GCCXML_FLAGS.

Більшість користувачів не повинні змінювати значення за замовчуванням для цих налаштувань. Є за замовчуванням
Файл GCCXML_CONFIG надається в каталозі бібліотеки підтримки після встановлення. Це
налаштовує GCC-XML для імітації компілятора, який використовувався для його побудови.

КОМПІЛЯТОРИ

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

GCC Версії 4.2, 4.1, 4.0, 3.4, 3.3, 3.2, 2.95.x

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

Borland, 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__=стор
Визначено для внутрішнього рівня виправлення аналізатора GCC.

Досвідчені користувачі можуть моделювати інші компілятори, вручну налаштувавши GCCXML_FLAGS
налаштування. Зверніться за допомогою до списку розсилки.

МЕТАІНФОРМАЦІЯ

GCC-XML додав новий атрибут до легального набору атрибутів C/C++. Атрибут є
використовується для додавання метаінформації до вихідного коду C/C++, який потім з’явиться в XML
вихід. Синтаксис оголошення атрибута такий:

__атрибут((gccxml( , , ...)))
Тут є рядком у лапках. Для цього має бути принаймні один аргумент
атрибут 'gccxml', але немає верхнього обмеження для загальної кількості аргументів.
Кожен аргумент перевіряється як рядок - якщо знайдено не рядковий аргумент, то
атрибут ігнорується.

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

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

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

Як приклад того, як цей атрибут можна використовувати для додавання метаінформації до C++
декларації, розглянемо наступний макрос:

#визначити _out_ __attribute((gccxml("out")))
Тут '_out_' визначено як атрибут gccxml, де перший аргумент
це рядок "out". Рекомендується використовувати перший аргумент як унікальний
Ім'я рядка для типу метаінформації починає застосовуватися.

Тепер оголошення методу можна записати так:

анулювати getInteger(_out_ int& i);
Це призведе до того, що вихідний XML-код міститиме мета-інформацію для '_out_'
атрибут у формі "gccxml(out)".

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

АВТОРСЬКЕ

GCC-XML - вихід XML для GCC

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

Перерозповсюдження та використання у вихідних і двійкових формах, із змінами чи без них, є
дозволяється за умови виконання наступних умов:

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

* Повторне розповсюдження у двійковій формі має відтворювати вищенаведене повідомлення про авторські права, цей список
умов та наступного застереження в документації та/або інше
матеріали, надані разом із розповсюдженням.

* Ані назви Kitware, Inc., консорціуму програмного забезпечення Insight, ані назв
їхніх учасників можна використовувати для схвалення або просування продуктів, отриманих з цього
програмне забезпечення без спеціального попереднього письмового дозволу.

ЦЕ ПРОГРАМНЕ ЗАБЕЗПЕЧЕННЯ НАДАЄТЬСЯ ВЛАСНИКАМИ АВТОРСЬКИХ ПРАВ ТА СПІЛЬНИКАМИ «ЯК Є» ТА БУДЬКИМИ
ЯВНІ АБО НЕПРЯМАНІ ГАРАНТІЇ, ВКЛЮЧАЮЧИ, АЛЕ НЕ ОБМЕЖУЮТЬСЯ, НЕПРЯМАНІ ГАРАНТІЇ
ПРОДАЖНІСТЬ ТА ПІДХОДНІСТЬ ДЛЯ ОПРЕДЕЛЕНОЇ ЦІЛІ ВІД ВІД ВІД ВІД ВІД ВІДКЛЮЧЕННЯ. НІ В НІКОМУ разі
ВЛАСНИК АВТОРСЬКОГО ПРАВА АБО УЧАСНИКИ НЕСУТЬ ВІДПОВІДАЛЬНІСТЬ ЗА БУДЬ-ЯКІ ПРЯМІ, НЕПРЯМІ, ВИПАДКОВІ, ОСОБЛИВІ,
ПРИКЛАДНИЙ АБО НАСІМНИЙ ЗБИТК (В УКРАЇНІ, АЛЕ НЕ ОБМЕЖУЮЧИЙСЯ, ЗАКУПІВЛЕННЯ
ТОВАРІ-ЗАМІНИТИ ЧИ ПОСЛУГИ; ВТРАТА ВИКОРИСТАННЯ, ДАНИХ АБО ПРИБИТКУ; АБО ПЕРЕБРИВАННЯ БІЗНЕСУ)
НЕЗАЛЕЖНО ЗА ПРИЧИНИ ТА ЗА БУДЬ-ЯКЮ ТЕОРІЮ ВІДПОВІДАЛЬНОСТІ, НЕБО В КОНТРАКТІ, СУВОЇ ВІДПОВІДАЛЬНОСТІ АБО
ДЕЛІКТОВ (У ТОЧОМУ НЕДВАЛЬНІСТЬ АБО ІНШЕ), ЩО ВИНИКАЄ З ВИКОРИСТАННЯ ЦЬОГО
ПРОГРАМНЕ ЗАБЕЗПЕЧЕННЯ, НАВІТЬ ЯКЩО ПОВІДОМЛЕНО МОЖЛИВОСТІ ТАКОГО ШКОДИ.

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

gccxml_cc1plus - синтаксичний аналізатор GCC, виправлений для XML-дампів одиниць перекладу

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

Ця програма є безкоштовним програмним забезпеченням; ви можете розповсюджувати його та/або змінювати відповідно до умов
Загальна публічна ліцензія GNU, видана Фондом вільного програмного забезпечення; або
версія 2 Ліцензії або (на ваш вибір) будь-яка наступна версія.

Ця програма поширюється в надії, що вона буде корисною, але БЕЗ БУДЬ-ЯКИХ ГАРАНТІЙ;
навіть без неявної гарантії про придатність до продажу або придатність для певної мети.
Докладніше див. У Загальній публічній ліцензії GNU.

Ви повинні були отримати копію Загальної публічної ліцензії GNU разом із цією програмою;
якщо ні, пишіть на
Free Software Foundation, Inc.
51 Franklin Street, п'ятий поверх
Бостон, Массачусетс, 02110-1301 США

ПОШТА СПИСОК

Для отримання допомоги та обговорення використання gccxml список розсилки надається за адресою
[захищено електронною поштою]. Спочатку прочитайте повну документацію за адресою http://www.gccxml.org
перед розміщенням запитань у списку.

Використовуйте gccxml онлайн за допомогою служб onworks.net