Спасибо, Мувичиэль! Я принял ваше решение и расширил его для моих целей.
Текст ниже идет в мой Doxyfile:
ALIASES += req{1}="\ref SRTX_\1 \"SRTX-\1\" "
ALIASES += satisfy{1}="\xrefitem satisfy \"Satisfies requirement\" \"Requirement Implementation\" \1"
ALIASES += verify{1}="\xrefitem verify \"Verifies requirement\" \"Requirement Verification\" \1"
Где SRTX - название моего проекта и используется в качестве префикса к требованиям.
Затем я создаю файл Requirements.dox, который обеспечивает связь между идентификатором требования и URL-адресом для требования в моем инструменте управления требованиями (средство отслеживания проблем в моем случае).
/**
@page Requirements
@section Build1
@anchor SRTX_1113
<a href="https://foo.bar.com/mantis/view.php?id=1113">SRTX-1113</a>
@anchor SRTX_1114
<a href="https://foo.bar.com/mantis/view.php?id=1114">SRTX-1114</a>
*/
Можно также поместить текст требования в тег привязки, если вам не нужно ссылаться на внешний источник.
В моем коде у меня есть:
/**
* This is the basic executive that schedules processes.
* @satisfy{@req{1114}}
*/
class Scheduler: public Process
{
...
}
И в своих тестах я поставил:
/**
* Provide a number of tests for process scheduling.
* @verify{@req{1114}}
*/
class Scheduler_ut : public CppUnit::TestFixture
{
...
}
Это дает мне связанные страницы для требований, выполнения требований и проверки требований. Он также обеспечивает соответствие требованиям и проверяет разделы требований в описании класса (или функции - где бы вы ни ставили тег).