जावाडोक के भीतर एक ईमेल शामिल करने का सही तरीका क्या है?

Question

मुझे अपना ईमेल पता @author टैग के भीतर डालना पसंद है और चाहते हैं कि वे उत्पन्न जेवाडोक में mailto: लिंक क्लिक करने योग्य हों।

मुझे यह सही तरीके से करने के लिए कैसे जाना चाहिए?

/** 
* I currently do the following, but would like to have my name 
* displayed as the link rather than the email itself. 
* 
* @author {@link "mailto:my_email@email.example.com"} 
*/ 
public class Useless { } 

---

/** 
* I've tried this, but get warnings about unexpexted text where my name is. 
* 
* @author {@link "mailto:my_email@email.example.com" "Benoit St-Pierre"} 
*/ 
public class Useless { } 

Answer 1

{@link} जावाडोक विशिष्ट मार्कअप है। हालांकि, जावाडॉक्स एचटीएमएल हैं - इसलिए आप आसानी से

/** 
* Embed HTML directly into the Javadoc. 
* 
* @author <a href="mailto:my_email@email.exmaple.com">Benoit St-Pierre</a> 
*/ 
public class Useless { } 

चाहे यह एक अच्छा विचार हो या नहीं, एक अलग मामला है। :-)