जावाडोक को बताएं कि मेरी अवधि वाक्य को समाप्त नहीं करती है

Question

जावाडोक सारांश वाक्य के रूप में दस्तावेज़ टिप्पणी के पहले "वाक्य" का उपयोग करता है। यह मानता है कि एक स्पेस, टैब, या लाइन टर्मिनेटर के बाद की अवधि वाक्य समाप्त होती है। मान लीजिए कि मैं "उदा।" जैसे संक्षिप्त नाम चाहता हूं या "आदि" मेरे सारांश में; क्या जवाडोक को यह बताने का कोई तरीका है कि इसे वाक्य के अंत के रूप में न मानें? मैं . के साथ अवधि को प्रतिस्थापित कर सकता हूं लेकिन मुझे आश्चर्य है कि अगर कोई बदसूरत तरीका है।

Answer 1

पहली वाक्य में अवधि से बचने के लिए सबसे अच्छा है। How to Write Doc Comments for the Javadoc Tool में यह सुझाव दिया जाता है कि आप एक समाधान के रूप अंतरिक्ष चरित्र बदलना चाहिए:

/** 
* This is a simulation of Prof. Knuth's MIX computer. 
*/ 

/** 
    * This is a simulation of Prof.<!-- --> Knuth's MIX computer. 
    */ 

व्यक्तिगत रूप से, मैं सिर्फ डॉट को छोड़ अगर मैं संक्षिप्त रूपों को पूरी तरह से बचने नहीं कर सकता है।