जावाडोक

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

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

जावाडोक जावा में प्रदर्शन को प्रभावित नहीं करता है क्योंकि संकलन के समय सभी टिप्पणियाँ हटा दी जाती हैं। टिप्पणियाँ और जावाडोक लिखना कोड को बेहतर ढंग से समझने और इस प्रकार इसे बेहतर बनाए रखने के लिए है।

इतिहास
जावाडोक एक प्रारंभिक जावा लेंग्वेज प्रलेखीकरण जनरेटर था। प्रलेखीकरण जनरेटर के उपयोग से पहले तकनीकी लेखकों का उपयोग करने की प्रथा थी जो सामान्यत: सॉफ़्टवेयर के लिए केवल स्टैंडअलोन प्रलेख लिखते थे, लेकिन इस प्रलेख को सॉफ़्टवेयर के साथ समन्वयित रखना बहुत कठिन था।

जावा द्वारा पहली रिलीज़ के बाद से जावाडोक का उपयोग किया गया है, और सामान्यत: जावा डेवलपमेंट किट की हर नई रिलीज़ पर इसे अपडेट किया जाता है।   जावाडोक के सिंटैक्स का अनुकरण अन्य लेंग्वेजओं के लिए प्रलेखीकरण प्रणालियों द्वारा किया गया है, जिसमें क्रॉस-लैंग्वेज डॉक्सिजन, जावास्क्रिप्ट के लिए  जेएसडॉक  सिस्टम और ऐप्पल के हेडरडॉक सम्मलित हैं।

जावाडोक टिप्पणी की संरचना
जावाडोक टिप्पणी को मानक बहु लाइन टिप्पणी टैग द्वारा कोड से अलग किया जाता है  और. आरंभिक टैग (जिसे आरंभ-टिप्पणी सीमांकक कहा जाता है) में एक अतिरिक्त तारांकन चिह्न होता है.


 * 1) पहला पैराग्राफ प्रलेखित विधि का विवरण है।
 * 2) विवरण के बाद अलग-अलग संख्या में वर्णनात्मक टैग हैं, जो दर्शाते हैं:
 * 3) विधि के पैरामीटर
 * 4) विधि क्या लौटाती है
 * 5) कोई भी अपवाद जो विधि फेंक सकती है
 * 6) अन्य कम-सामान्य टैग जैसे   (टैग भी देखें)

जावाडोक का अवलोकन
प्रलेख टिप्पणियाँ लिखने की मूल संरचना उन्हें अंदर एम्बेड करना है। . जावाडोक टिप्पणी ब्लॉक आइटम के ठीक ऊपर स्थित है बिना किसी अलग नई लाइन के ध्यान दें कि कोई भी आयात विवरण वर्ग घोषणा से पहले होना चाहिए। वर्ग घोषणा में सामान्यत: सम्मलित होते हैं:

विधियों के लिए (1) एक संक्षिप्त, संक्षिप्त, एक पंक्ति का विवरण है बताएं कि आइटम क्या करता है. इसके बाद (2) एक लंबा समय आता है विवरण जो कई अनुच्छेदों तक फैला हो सकता है। विवरण यहाँ पूर्ण रूप से समझाया जा सकता है। यह अनुभाग है वैकल्पिक, अंत में, स्वीकृत इनपुट को सूचीबद्ध करने के लिए (3) एक टैग अनुभाग है विधि के तर्क और वापसी मान ध्यान दें कि सभी जावाडोक को एचटीएमएल के रूप में माना जाता है इसलिए एकाधिक पैराग्राफ अनुभाग द्वारा अलग किए गए हैं पैराग्राफ़ ब्रेक टैग।

वेरीयेबल को अपवाद के साथ विधियों के समान ही प्रलेखित किया जाता है भाग (3) हटा दिया गया है। यहां वेरिएबल में केवल लघु सम्मलित है विवरण:

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

इसके अतिरिक्त, प्रत्येक वेरीयेबल को अलग से लिखने और प्रलेखित करने की अनुशंसा की जाती है:

जावाडोक टैग की तालिका
कुछ उपलब्ध जावाडोक टैग नीचे दी गई तालिका में सूचीबद्ध हैं:

उदाहरण
किसी विधि का प्रलेखीकरण करने के लिए जावाडोक का एक उदाहरण इस प्रकार है। ध्यान दें कि इस उदाहरण में रिक्ति और वर्णों की संख्या कन्वेंशन स्थिति के अनुसार है।

डॉकलेट्स
डॉकलेट प्रोग्राम जावा (प्रोग्रामिंग लेंग्वेज) में लिखे कोड से प्रलेख तैयार करने के लिए जावाडोक टूल के साथ काम करते हैं। डॉकलेट जावा प्रोग्रामिंग लेंग्वेज में लिखे गए हैं और इसका उपयोग करते हैं को:
 * प्रलेख में कौन सी सामग्री सम्मलित करनी है उसका चयन करें।
 * सामग्री की प्रस्तुति को प्रारूपित करें।
 * वह फ़ाइल बनाएं जिसमें प्रलेख सम्मलित हो वह जावाडोक के साथ सम्मलित होकर फ्रेम-आधारित एचटीएमएल फ़ाइलों के रूप में एपीआई प्रलेख तैयार करता है। वेब पर कई गैर-मानक प्रलेख उपलब्ध हैं, अधिकांशत: मुफ़्त में। इनका उपयोग इसके लिए किया जा सकता है।
 * अन्य गैर-एपीआई प्रकार के प्रलेख बनाएं।
 * प्रलेख को पीडीएफ जैसे अन्य गैर-एचटीएमएल फ़ाइल प्रकारों में आउटपुट करें।
 * खोज जैसी अतिरिक्त सुविधाओं के साथ या जावा क्लासेस से उत्पन्न एम्बेडेड एकीकृत मॉडलिंग लेंग्वेज आरेखों के साथ प्रलेख को एचटीएमएल के रूप में आउटपुट करें।

यह भी देखें

 * प्रलेखीकरण जनरेटर की तुलना।
 * सी शार्प सिंटैक्स#एक्सएमएल डॉक्यूमेंटेशन सिस्टम|नेट एक्सएमएल डॉक्यूमेंटेशन टिप्पणियाँ।

बाहरी संबंध

 * Java Platform, Standard Edition जावाडोक Guide
 * JSR 260 जावाडोक Tag Technology Update Java Specification Request (defines new जावाडोक tags)
 * Improve on जावाडोक with ashkelon
 * Globaldocs: A viewer to browse multiple जावाडोकs simultaneously.
 * Various Java documentations converted to Windows Help format