Avatar ·

Javadoc में विधियों को सही तरीके से कैसे संदर्भित करें और {@link} क्या है?

सभी को नमस्ते! मैंने अभी Java सीखना शुरू किया है और अपने प्रोजेक्ट के लिए दस्तावेज़ीकरण लिख रहा हूँ। मुझे एक समस्या का सामना करना पड़ा: मैं Javadoc टिप्पणियों में किसी अन्य विधि का लिंक देना चाहता हूँ ताकि दस्तावेज़ीकरण पढ़ने में सुविधा हो। उदाहरण के लिए, मेरे पास `Calculator` क्लास है जिसमें `add()` और `sumAndPrint()` विधियाँ हैं। दूसरी विधि में मैं विवरण में बताना चाहता हूँ कि यह `add()` को कॉल करती है। मैंने सिर्फ `#add` या `{@link add}` लिखने की कोशिश की, लेकिन यह काम नहीं किया — जनरेटेड HTML दस्तावेज़ीकरण में लिंक दिखाई नहीं देता। आधिकारिक दस्तावेज़ीकरण में `{@link #methodName}` के बारे में कुछ लिखा है, लेकिन मुझे समझ नहीं आ रहा कि अगर विधि किसी दूसरे क्लास में हो या पैरामीटर के साथ हो तो पूरा पथ सही तरीके से कैसे निर्दिष्ट करें। यहाँ मेरे कोड का उदाहरण है: ```java /** * सरल अंकगणितीय संक्रियाओं के लिए कैलकुलेटर। */ public class Calculator { ```