Как избавиться от странного предупреждения о кислородном

Question

При запуске doxygen над одним конкретным довольно большим проектом на языке C, состоящим из множества файлов (все это полностью документировано, я думаю), тогда я всегда нахожу это предупреждение в нижней части вывода:

<@1>:1: warning: parameters of member @1 are not (all) documented 

Как я могу найти и удалить триггер этого предупреждения?

Обратите внимание, что рассматриваемый проект слишком велик (и проблема не достаточно важна) для деления пополам или других методов поиска на основе проб и ошибок.

Answer 1

Поймите, это старый вопрос, но я столкнулся с этим поведением и не нашел решение в Интернете.

Нашел файл с нарушением правил, выполнив Doxygen и посмотрев, где появляется сообщение об ошибке на выходе (убедитесь, что вы не подавляете stdout, или вы просто получите ошибку без контекста).

В моем случае ошибка появилась после строки «Генерирование графика зависимостей для группы [имя]». Посмотрев на соответствующий файл, я обнаружил недокументированное, неназванное перечисление. Члены перечисления все еще были задокументированы. например

enum 
{ 
    X = 1, /**< Documented. */ 
    ... 
} 

Я предполагаю, что это отсутствие имени на перечисление, которое было бросание Doxygen и вызвавшего бесполезные сообщения. Добавление имени приводит к созданию более полезных сообщений об ошибках. Документирование перечисления (с именем или без имени) удаляет ошибку.