[Doxygen] Как заставить Doxygen НЕ склеивать описания функции, заимплеменченой дважды?
Суть:
есть функция, которая заимплементирована дважды, и в зависимости от #ifdef SMTHNG подхватывается та или иная ее реализация(интерфейс у разных реализаций одинаковый, декларация - одна общая). Мне необходимо, чтобы в html-документации, сгенерированной Doxygen, эта функция определялась как две разные, но он упорно склеивает все в одно.
В принципе, разбить дескрипшн и не париться не проблема, но тогда ссылка на Source Browser, где можно будет посмотреть код реализации, будет одна.
Есть ли решение? Конфиг-файл весь прошуршал - ничего не приглянулось, что могло бы пофиксить сабж.
Не могу себе представить, как заставить doxygen различать функции с одной и той же сигнатурой. Самый реальный способ на мой взгляд - собирать различные варианты документации с разными макросами (PREDEFINED) и затем читать нужный вам. Препроцессор doxygen обрабатывает файлы по такому же принципу, что и компилятор (только не все конструкции поддерживает), поэтому как сама программа компилится отдельно с разными конфигурациями, так должна и документация. Иначе вам нужно все-таки различать эти функции явно.
да, мы тоже решили, что это единственный вариант, но наверное мы не пойдем по такому пути, т.к. в нашем случае придется плодить 5-7 таких вариантов документаций. Хотелось бы all-in-one.
Дмитрий Белякин А зачем вам вообще эти различия в документации держать? Да, реализация отличается, но функции (т.е. интерфейс) по сути одни и те же ведь? Как по мне, реализация на то и реализация, что ей место в самих исходниках, а не в доках)
Простой
Простой