Запустить Doxygen только на выбранных файлах/модулях?

Недавно я начал писать некоторые документы doxygen в существующем проекте, у которого уже есть много комментариев doxygen.

Поскольку я немного учусь - мне нравится выполнять итерацию с внесением изменений и созданием документов, поскольку генерация doc довольно медленная - 3-5 минут. Это становится неработоспособным.

Мне удалось удалить большую часть файлов в исходном дереве, так что doxy только нашел те, которые я редактировал, но это действительно ужасное решение, а не то, что я хотел бы делать часто.

Есть ли способ (например, командная строка или переменная env) - чтобы ограничить, какие файлы/модули используются для генерации документов, - так что восстановление документов может выполняться намного быстрее?

Ответ 1

Да, вы можете настроить поведение Doxygen из командной строки или через переменные среды. Например, если вы хотите включить только один файл (include/somefile.h), вы можете выполнить Doxygen как:

( cat Doxyfile ; echo "INPUT=include/somefile.h" ) | doxygen -

см. Doxygen FAQ "Могу ли я настроить doxygen из командной строки?" для более подробной информации о настройке поведения из командной строки.

В качестве альтернативы, если вы хотите использовать переменные среды, вы можете использовать в конфигурационном файле что-то вроде следующего:

INPUT = $(FILE)

Doxygen выполняет замену переменных среды в своих конфигурационных файлах, позволяя указать, какие файлы следует использовать при использовании:

export FILE=include/somefile.h
doxygen Doxyfile

Подробнее об использовании переменных среды в файлах конфигурации см. Doxygen Configuration.