В моей библиотеке много перегруженных функций вида:
/// \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 был бы признателен.