में नेमस्पेस के बारे में डॉक्सिजन जागरूक होने के बाद हमारे पास एक सी ++ प्रोजेक्ट है जिसे हम डॉक्सिजन का उपयोग करके दस्तावेज करते हैं, कक्षाओं के लिए हेडर के अंदर केवल डॉक्सिजन टिप्पणियां डालते हैं, हम सीपीपी के अंदर स्थिर कार्य दस्तावेज करते हैं।सीपीपी
हमारी डॉक्सिजन कॉन्फ़िगरेशन फ़ाइलें प्रोजेक्ट के अंदर फ़ाइल किसी भी हेडर/एचपीपी)/कार्यान्वयन/सीपीपी) को फसल करती हैं। इसके अलावा, हमारे पास कुछ स्वतंत्र घटक (और बाहरी) हैं जिन्हें हम नामस्थानों के अंदर अलग करते हैं।
परियोजना एक तरीका है कि हम (प्रॉक्सी पैटर्न के व्यापक उपयोग के कारण) बहुरूपता का उपयोग किया जाता है
यह एक आम बात है के रूप में, हम हैडर अंदर निर्देशों का उपयोग न करे और हम कार्यान्वयन में इसका इस्तेमाल करते हैं फ़ाइल।
आमतौर पर, हम शीर्षक में है:
warning: no uniquely matching class member found for f(A)
possible candidates:
void f(N1::N2::A)
void f(N1::N2::B)
:
/**
* @brief
* test from A
*/
void f(N1::N2::A);
/**
* @brief
* test from A
*/
void f(N1::N2::B);
कार्यान्वयन के अंदर, हम
using namespace N1::N2;
void f(A) { }
void f(B) { }
जब Doxygen चल रहा है, वह भ्रमित और पैदा करता है लगता है त्रुटि संदेश है किसी भी विचार से इन त्रुटियों से छुटकारा पाने के लिए और "उपयोग" निर्देश के बारे में डॉक्सिजन को जागरूक कैसे किया जाए? जैसे मैं एक साफ समाधान एक समाधान के बजाय की तलाश में हूँ दिखता है:
संपादित
- बुरी खबर, बग ट्रैकर पर खोला जा रहा है: https://bugzilla.gnome.org/show_bug.cgi?id=617285, https://bugzilla.gnome.org/show_bug.cgi?id=154880।
सामान्य रूप से, यदि आप सी ++ कोड पर नाम-सटीक लुकअप चाहते हैं, तो आपको एक पूर्ण सी ++ फ्रंट एंड की आवश्यकता है। AFAICT, Doxygen करता है एक पूर्ण सी ++ अंत नहीं है। (इस वजह से, मैंने हमेशा सोचा है कि कैसे सी ++ उपयोगकर्ता डॉक्सिजन के साथ इतना मोहक हो सकते हैं; कुछ भी बेहतर नहीं है?) यदि आप भाग्यशाली हैं, तो आपको विशेष मामलों के लिए एक समाधान मिल जाएगा। –
बेहतर की कमी, निश्चित रूप से। यह व्यापक रूप से उपलब्ध है और सी के साथ भी सौदों ... – Bruce
आपको अपने संपादन को उत्तर के रूप में पोस्ट करना चाहिए और कम से कम बग ठीक होने तक इसे स्वीकार करना चाहिए। –