2009-07-17 3 views
46

के लिए जावाडोक-जैसे दस्तावेज़ीकरण क्या सी ++ के लिए जावाडॉक जैसे समान दस्तावेज उत्पादन प्रणाली हैं? जावाडोक अच्छा उत्पादन पैदा करता है; यह बहुत अच्छा होगा अगर आप अन्य भाषाओं में ऐसा कुछ इस्तेमाल कर सकते हैं।सी ++

उत्तर

53

कई उपकरण है कि सी के लिए JavaDoc की तरह काम करता हैं ++ सबसे लोकप्रिय उपकरण शायद Doxygen है। यह जावाडॉक जैसी टिप्पणियों, और कई भाषाओं (जैसे, सी ++, सी, जावा, ऑब्जेक्टिव-सी, पायथन, पीएचपी, सी #) को संभाल सकता है। सीएसएस का उपयोग कर एचटीएमएल आउटपुट की शैली को ट्वीव करने के लिए इसका बहुत अच्छा समर्थन है (उदाहरण के लिए users list देखें)।

दो महत्वपूर्ण मुद्दों जब प्रलेखन प्रणाली को चुनने यकीन है कि यह करने के लिए

  • दस्तावेज़ संस्थाओं है कि आप में रुचि रखते हैं आप की अनुमति देता है बनाने के लिए है। आप कोड संरचना निम्न या के अनुसार प्रणाली दस्तावेज़ करना चाहते हैं कुछ अन्य मॉड्यूल विभाजन।
  • आउटपुट स्वरूपित करना चाहते हैं जैसा आप चाहते हैं। जब प्रलेखन आपकी सामान्य प्रोजेक्ट शैली के साथ फिट बैठता है तो यह बेहतर होता है।

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

+0

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

11

आप जावाडोक विशेष रूप से उपयोग नहीं कर सकते Doxygen

20

नहीं है, लेकिन वहाँ है कि आप क्या चाहते हैं उपकरणों के एक जोड़े हैं। सबसे अधिक लोग उपयोग करने के लिए करते हैं Doxygen है। यहाँ Doxygen और डॉक्टर के लिए ++ कुछ लिंक कर रहे हैं:

Doxygen
Doc++

+0

डॉक्सीजन महान काम करता है और बहुत बड़ी परियोजनाओं में इसका उपयोग किया जाता है। –

0

मैं अपने पायथन परियोजनाओं के लिए बस Sphinx का उपयोग शुरू कर रहा हूं। इसका होम पेज कहता है "सी/सी ++ पहले ही समर्थित है"।

यह "reStructuredText" नामक हल्के मार्कअप का उपयोग करता है।

मैंने अभी अपनी पाइथन परियोजनाओं के लिए इसका उपयोग करना शुरू कर दिया है, और आउटपुट के रूप में बहुत कुछ देखा है।