2016-03-03 7 views
9

जावा के जावाडोक में, {@inheritDoc} tag का उपयोग करके सबक्लास में विधि के दस्तावेज़ को प्राप्त करने का एक तरीका है।मैं केडीओसी दस्तावेज कैसे प्राप्त करूं?

क्या कोटलिन के केडीओसी में ऐसा करने का कोई तरीका है? एक विरासत से एक के लिए एक आधार के सदस्य से

abstract class Base { 
    /** 
    * Some KDoc documentation here. 
    */ 
    abstract fun foo() 
} 

class Derived: Base() { 
    /** 
    * Here is all the documentation from Base#foo's KDoc inherited. 
    * 
    * And here goes something more in addition. 
    */ 
    override fun foo() { /* ... */ } 
} 
+0

करता है '{@inheritDoc}' काम नहीं? क्या तुमने कोशिश की? – CaseyB

+0

@CaseyB, हाँ, मैंने किया, और न तो इंटेलिजे और न ही डोक्का इसे समझता है, वे इसे टेक्स्ट के रूप में दिखाते हैं। – hotkey

+2

मुझे अपनी खोज को दस्तावेज करने वाला कोई भी चीज़ नहीं मिल रहा है, लेकिन मैं जो कह सकता हूं उससे कोटलिन डॉक्टर को ओवरराइड पर कोई दस्तावेज निर्दिष्ट नहीं होने पर फ़ंक्शन ओवरराइड करते समय दस्तावेज़ को विरासत में मिला है। अब मैं सोच रहा हूं कि आधार दस्तावेज "विस्तार"/"शामिल" कैसे करें ... – mfulton26

उत्तर

10

Dokka हमेशा प्रतियां प्रलेखन अगर विरासत में मिला सदस्य अपने स्वयं के प्रलेखन नहीं है:

मूल रूप से, मैं क्या करना चाहते हैं निम्नलिखित है। विरासत सदस्य में दिए गए अतिरिक्त पाठ के साथ आधार सदस्य दस्तावेज़ को गठबंधन करने का कोई तरीका नहीं है।

(Dokka @inheritdoc जावाडोक टैग का समर्थन नहीं करता है क्योंकि यह अनिवार्य रूप से जो मैं सुपर बेकार और अनावश्यक लगता है केवल /** @inheritdoc */ से मिलकर टिप्पणियों के प्रसार की ओर जाता है।)

+4

फिर भी किसी कारण के लिए जब मैंने बिना किसी दस्तावेज़ के विरासत वाले फ़ंक्शन पर 'Ctrl + Q' दबाया, तो यह कोई भी नहीं दिखाता है, हालांकि बेस फ़ंक्शन ने इसे निर्दिष्ट किया है और जब मैं इसे' Ctrl + B' करता हूं और 'Ctrl दबाता हूं आधार समारोह पर + क्यू', दस्तावेज दिखाया गया है। शायद यह कुछ विचार-प्लगइन बग है। – dimsuz

+1

@yole जब मैंने जावा क्लास/इंटरफ़ेस से ओवरराइड विधि पर त्वरित दस्तावेज़ शॉर्टकट मारा, तो मुझे बेस क्लास/इंटरफ़ेस में कुछ दस्तावेज़ों के दौरान कोई दस्तावेज़ नहीं दिखाई देता है। यह वास्तव में असुविधाजनक है। क्या उस पर कोई खुली समस्या है? –

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