2014-07-22 5 views
6

क्या जावाडोक स्पेक में नई सुविधाओं को पेश करने के लिए एक संस्करण प्रक्रिया है? मेरा प्रश्न प्रतीत होता है कि नए टैग: @apiNote, @implSpec, और @implNote जो जावा 8 स्रोत दस्तावेज़ों में दिखाई देते हैं। I'm aware that these tags are not standard and subject to change - अगर यह जावा गॉड्स द्वारा तय किया गया था कि ये टैग जावाडॉक के एक नए संस्करण में मानक हैं, जहां डेवलपर को यह जानकारी मिल सकती है?क्या जावाडोक टूल के लिए कोई वर्जनिंग प्रक्रिया है?

मैं Oracle डॉक्स संदर्भ जावाडोक संस्करण 1.1 से शुरू होकर 1.4 है, जो एक ले जा सकता है एक नया जावाडोक संस्करण ऐसा प्रत्येक जावा संस्करण के साथ कि विश्वास करने के लिए पर समाप्त पढ़ा है, लेकिन मैं करने के लिए कोई सबूत नहीं मिल सकता है इस धारणा का समर्थन करें।

जैवडोक स्पेक/सर्वोत्तम प्रथाओं/स्वीकृत टैग से संबंधित एकमात्र वैध संदर्भ मैंने पाया है: How to Write Doc Comments for the Javadoc Tool

+0

सुनिश्चित नहीं है कि ईमेल थ्रेड जानकारी का विश्वसनीय स्रोत क्यों नहीं है; इसमें उल्लेख है कि वे टैग मानक नहीं हैं, और वे परिवर्तन के अधीन हैं। – Makoto

+1

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

उत्तर

3

जावाडॉक टूल वास्तव में जावा की प्रत्येक प्रमुख रिलीज के साथ नई क्षमताओं को प्राप्त करता है। यदि आप http://docs.oracle.com/javase/8/docs/technotes/guides/javadoc/ पर जाएं और एपीआई संवर्धन अनुभाग देखें, तो आपको 1.4 के बाद से प्रत्येक संस्करण के लिए जावाडोक टूल की नई क्षमताओं का वर्णन करने वाले लिंक मिलेगा।

+0

बिल्कुल वही जो मैं खोज रहा था, धन्यवाद। –

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