Chỉ chạy Doxygen trên các tệp/mô-đun được chọn?

Question

Gần đây tôi bắt đầu viết một số tài liệu doxygen trong một dự án hiện có đã có khá nhiều ý kiến ​​doxygen.

Vì tôi đang học một chút - tôi muốn lặp lại với việc chỉnh sửa và tạo tài liệu, vì việc tạo tài liệu khá chậm - 3-5 phút. Điều này trở nên không thể thực hiện được.

Tôi quản lý bằng cách xóa hầu hết các tệp trong cây nguồn để doxy chỉ tìm thấy những tệp tôi đang chỉnh sửa nhưng đây thực sự là giải pháp khủng khiếp và không phải thứ tôi muốn làm thường xuyên.

Có cách nào (dòng lệnh arg hoặc biến env cho ví dụ) - để giới hạn tệp/mô-đun nào được sử dụng để tạo tài liệu - vì vậy việc tạo lại tài liệu có thể được thực hiện nhanh hơn nhiều không?

Answer 1

Có, bạn có thể tùy chỉnh hành vi của Doxygen từ dòng lệnh hoặc qua biến môi trường. Ví dụ, nếu bạn chỉ muốn bao gồm một tập tin (include/somefile.h), bạn có thể thực hiện Doxygen như:

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

thấy Doxygen FAQ 's 'Tôi có thể cấu hình doxygen từ dòng lệnh?' để biết thêm chi tiết về cách tùy chỉnh hành vi từ dòng lệnh.

Ngoài ra, nếu bạn muốn sử dụng biến môi trường, bạn có thể sử dụng chỉ định một cái gì đó như sau trong tập tin cấu hình của bạn:

INPUT = $(FILE) 

Doxygen thực hiện thay biến môi trường trên các tập tin cấu hình của nó, cho phép bạn xác định các tập tin (s) nên được hành động khi sử dụng:

export FILE=include/somefile.h 
doxygen Doxyfile 

Xem Doxygen Configuration để biết chi tiết về cách sử dụng biến môi trường trong tệp cấu hình.