Нужно было добавить спойлеры в doxygen-описание, так, чтобы второстепенные подробности не загромождали основной текст.
Было очевидно, что лезть надо в html.
За вставку html-текста в doxygen отвечают скобки из команд \htmlonly\endhtmlonly. Между ними можно вставить html-скрипт спойлера, а затем заключить нужный текст в специфичные теги.