Вопрос, связанный с кислородом. Комментарии одни и те же вещи в разных файлах

Question

Я использую doxygen для комментирования кода. Есть, например, два файла:

test1.cpp

/**
* @namespace SomeNamespace
* @brief Describe it
*/
namespace SomeNamespace
{
   ...
}

test2.cpp

// Put comment about namespace again?
namespace SomeNamespace
{
   ...
}

Answer 1

Когда вы комментируете один и тот же материал в разных файлах, комментарии объединяются в выводе Doxygen. Я испытываю это по крайней мере, комментируя как объявление функции, так и тело функции.