Номер версии проекта Doxygen в XML

Question

Я хотел бы, чтобы мой номер версии проекта появился на выходе Doxygen XML, чтобы я мог программно получить его. Я установил PROJECT_NUMBER, и значение, которое я использовал там, появляется в выводе HTML для той же сборки, но не для вывода XML. Я grepped выходную папку XML для исходного текста значения, которое я ввел в PROJECT_NUMBER, и оно нигде не появляется. Поиск через параметры конфигурации Doxygen Я не мог найти ничего, что могло бы контролировать это, кроме самого PROJECT_NUMBER, поэтому я не думаю, что это только проблема конфигурации.

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

Я использую Doxygen 1.8.11

Answer 1

Нет однозначного ответа, но это решение я буду использовать, если ничего другого не выскочит.

Создать псевдоним:

ALIASES = "myversion=\anchor version \xmlonly a.b.c \endxmlonly" 

Где A.B.C 'это номер версии, который также был помещен в PROJECT_NUMBER.

Затем поместите \myversion тег в блоке комментариев отмечен как \page или \mainpage, поскольку \anchor должен быть в одном из них (source).

Это не идеальный вариант, но вы можете использовать якорь, чтобы легко найти версию в xml. В моем случае вывод XML был:

<para><anchor id="index_1version"/> a.b.c </para> 

в подробном описании страницы, так что вы можете просто взять текстовое содержание вмещающего «пункт» тега.

Мне не обязательно нужен тег \xmlonly, но так как PROJECT_NUMBER появляется в html уже, наличие номера версии, случайно напечатанного в другом месте, не требуется.