2008-10-14 18 views
14

डॉक्सीजन थोड़ा धीमा है - मेरी पूरी परियोजना को संसाधित करने में लगभग कुछ मिनट लगते हैं, इसलिए छोटे वृद्धिशील परिवर्तनों के लिए यह वास्तव में मेरे शेष कोड को बनाने से अधिक लंबा है। बिना किसी दस्तावेज़ीकरण के हजारों फाइलें हैं, इसलिए मुझे लगता है कि यह अपना अधिकांश समय प्रसंस्करण कर रहा है। क्या किसी दस्तावेज़ के बिना फ़ाइलों को छोड़ने का कोई तरीका है?तेजी से चलाने के लिए डॉक्सिजन कैसे प्राप्त करें?

इसे केवल बदली गई फ़ाइलों को संसाधित करने के बारे में क्या है?

उत्तर

11

Doxygen प्रलेखन से:

मैं अपने निर्देशिका वृक्ष से सभी परीक्षण निर्देशिका बाहर कर सकते हैं?

सीधे शब्दों विन्यास फाइल में इस की तरह एक को बाहर पैटर्न डाल:

EXCLUDE_PATTERNS = /परीक्षण/

तो, आप फ़ाइलों को बाहर करने के लिए पैटर्न का उपयोग किया जाना चाहिए। यह लंबे समय से रहा है क्योंकि मैंने डॉक्सिजन का उपयोग किया है, लेकिन मुझे केवल बदली गई फ़ाइलों को संसाधित करने के लिए कोई विकल्प याद नहीं है।

+0

यह शायद सबसे अच्छा विचार है जिसके बारे में मैं सोच सकता हूं - मैं उन निर्देशिकाओं को बहिष्कृत कर सकता हूं जिनमें अभी तक कोई दस्तावेज शामिल नहीं है। –

3

डॉक्सिजन फाइलों के बीच कनेक्शन खोजने में अच्छा है, या तो बदल गया है या नहीं। लेकिन डॉक्सिजन को अपरिवर्तित फ़ाइलों के बारे में जानकारी याद नहीं है, इसलिए इसे हर बार पूरे कोडबेस को संसाधित करना होगा।

एक समाधान हो सकता है कि इस परियोजना को व्यवस्थित किया जाए, जैसे कि कभी भी बदली गई फाइलें एक मॉड्यूल से संबंधित नहीं होतीं जिसे डॉक्सिजन स्कोप से बाहर रखा गया है और जिसका दस्तावेज़ पहले से ही उपलब्ध है। तो नए मौजूदा दस्तावेज को इस मौजूदा मॉड्यूल दस्तावेज से जोड़ने के लिए डॉक्सिजन को बताना संभव होगा।

आगे बढ़ना, मॉड्यूल द्वारा डोक्सीजन चलने वाला मॉड्यूल बनाना भी संभव होगा, केवल मॉड्यूल और एक शीर्ष स्तर के दस्तावेज़ों को प्रोसेस करना होगा जो सभी मॉड्यूल दस्तावेज़ों से लिंक हो।

6

मैंने पाया कि विकल्प SEARCH_INCLUDES को बंद करना एक बड़ा अंतर बना। यह पूरे मंच एसडीके के माध्यम से देख रहा था और संकलक के लिए पथ शामिल था जिसे किसी भी तरह से दस्तावेज नहीं किया गया था और जेनरेट किए गए दस्तावेज़ में प्रकट नहीं होगा।

5

एक DOT_NUM_THREADS विकल्प हैं जो मल्टीकोर मशीनों पर प्रदर्शन बढ़ा सकते हैं। दुर्भाग्यवश डॉक्सिजन खुद ही एक धागा है। http://www.stack.nl/~dimitri/doxygen/external.html

1

मुझे नहीं लगता कि Doxygen एक सामान्य देव चक्र पर चलने होने एक अच्छा है:

एक और दृष्टिकोण मॉड्यूल प्रत्येक मॉड्यूल के लिए एक अलग Doxygen उदाहरण चलाने के लिए और जिसके परिणामस्वरूप टैग एक साथ linkt में अपने कोड का आयोजन किया जाएगा विचार। हमारे Doxygen बिल्ड हमारे निरंतर एकीकरण सर्वर की जिम्मेदारियों के हिस्से के रूप में चलता है।

यह कहा गया है कि गायब दस्तावेज़ों को पकड़ने के लिए प्रत्येक बिल्ड को डॉक्सिजन चलाने के कुछ फायदे हैं। तो मैं devss को हटाने के लिए devxgen कॉन्फ़िगरेशन को ट्रिम कर दूंगा, और यहां तक ​​कि इसे सेब को एक्सकोड में आयात करना बंद कर दूंगा।

संबंधित मुद्दे