У Doxygen есть команда \file, я посмотрел на различные базы кода и, похоже, некоторые проекты используют ее, а некоторые нет.
Необходимость поддерживать это добавляет некоторые накладные расходы (необходимоисправляется при разбиении файлов) иногда разработчики забывают это сделать.
Есть ли способ сделать это, например: использовать первый отформатированный комментарий в файле в качестве комментария \file.
В противном случае, какое хорошее эмпирическое правило для использования \file или нет?
Обратите внимание, я попытался удалить эту команду из всех файлов, и вывод изменилсяменее полезная группировка информации, и порядок некоторой информации изменился, поэтому это имеет значение.