Doxygen, işlem yapmayacaktır main.cpp

Question

Doxygen kullanmaya yeni başlıyorum ve sorunsuz çalışabilmeyi başardım. Sınıflarımı ve yapılarımı belgelemeyi başardım ve HTML dosyalarını mükemmel bir şekilde oluşturuyor. Çalıştığım sorun, main.cpp dosyamı ayrıştırmayacak. Tüm sınıflar ve yapıların kendi .h ve .cpp dosyaları vardır ve bunlar iyi işlemektedir. Main.cpp belgelerini yapmak için Doxygen'i nasıl alabilirim? Programın başladığı ve bittiği yer olan bir .h dosyası yok. Ana için .h dosyasına ne yazacağımı bile bilmiyorum. Windows'da Doxywizard kullanıyorum.

Düzenleme:

Ben ana bu koymak ve bir ana sayfasını oluşturur:

/** 
@mainpage 

This is a test application. 

@author Alex 
@date 10/21/2010 
@version 1.0 
*/ 

Ama sonra öteye fonksiyon prototipleri Bunu alabilir ve onu çözümlenen almaz vardır dosyanın aşağı : boş

/** 
@brief Error handler for the PDF writer. 

It does nothing. It just has to exist. 
*/ 
void error_handler (HPDF_STATUS error_no, 
        HPDF_STATUS detail_no, 
        void   *user_data) 
{ 
} 

Answer 1

Bunu main.cpp'nin üstüne koydum ve işe yaradı. Git rakamı.

/** 
@file main.cpp 
*/ 

Answer 2

INPUT ise ve FILE_PATTERNS, geçerli dizinde .cpp dosyaları (ve diğer birçok desen) * aramak gerekir. (Doxygen manual gelen bu.)

sizinki boş olduğundan, ben iki şeyden biri size almıyorsanız main.cpp belgelerine oluyor bekliyoruz:

1. main.cpp akımı değil dizin. Bunu devre dışı bırakmak için, Doxygen dosyasını hem hem de config dosyanızı ve main.cpp ile çalıştırdığınızdan emin olun.
2. main.cpp belgelerinizde bir sözdizimi hatası var. Doxygen, bir hatayla karşılaştığı zaman genel olarak iptal etmediği için bu durumun tespit edilmesi zor olabilir - bunun yerine sadece atlıyor. Sorun buysa, dokümanlar satırını oluştururken Doxygen'ın çıktısını tarayın.

Bu fikirlerden hiçbiri sorununuzu çözmezse, daha fazla bilgiye ihtiyacımız olabilir. ls -R'un çıktısı, Doxygen çalışmasının çıkışı vb. İyi şanslar!

Answer 3

Ben doxygen manual itibaren bu biraz araştırma ... yaptı: Önemli

: küresel fonksiyonları, değişkenler, typedefs, ve çeteleler belgeler sadece dahil edilecektir İçinde bulundukları dosya çıktıları da belgelidir.

İşte işte!