Группировка перегрузок в doxygen

В моей библиотеке много перегруженных функций вида:

/// \brief Does thing.
///
/// \details The thing that is done is very special.
template<typename T>
void do_stuff(const T& t);

/// \brief Does thing repeatedly. 
/// \copydetails do_stuff()
template<typename T>
void do_stuff(const T& t, std::size_t x);

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

Я мог представить себе, что это:

Результат документации должен выглядеть следующим образом:

template<typename T>
void do_stuff(const T& t);                (1)

template<typename T>
void do_stuff(const T& t, std::size_t x); (2)

The things that is done is very special.

(1) Does thing.

(2) Does thing repeatedly.

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

Есть ли способ добиться этого легко? Даже намеки, чтобы взломать его в doxygen был бы признателен.

14
задан pmr 8 August 2012 в 08:39
поделиться