简体   繁体   中英

Netbeans not generating javadoc properly

This is an example of class that I have written for my project and it's documented in italian:

/**
 * Eccezione da lanciare nel caso si verifichi un guasto al motore.
 * Eredita da <a  href="http://docs.oracle.com/javase/1.4.2/docs/api/java/lang/Exception.html">
 * java.lang.Exception </a>.
 * 
 * @author Ramy Al Zuhouri
 * @version 1.0
 */
package truckingCompany.utilities;

public class EngineFailureException extends Exception
{
    /**
     * Viene chiamato il costruttore della superclasse Exception, con un 
     * messaggio che descrive l' accaduto.
     */
    public EngineFailureException()
    {
        super("Guasto al motore durante il rientro alla base");
    }
}

But there is a problem generating javadoc: the upper part of comments aren't seen in the html page generated.
So all this part:

/*
 * Eccezione da lanciare nel caso si verifichi un guasto al motore.
 * Eredita da <a  href="http://docs.oracle.com/javase/1.4.2/docs/api/java/lang/Exception.html">
 * java.lang.Exception </a>.
 * 
 * @author Ramy Al Zuhouri
 * @version 1.0
 */

Isn't shown in the page.How to force netbeans to include also these comments?

It's because that isn't a javadoc comment. Javadoc comments look like:

/**
*
*
*/

Whereas yours is:

/*
*
*
*/

Notice the difference in the first line? If you add another * to the top line to make it /** it should work fine.

For more information on comment types in Java read here.

您是否尝试将其放在类之上而不是包装之上?

The technical post webpages of this site follow the CC BY-SA 4.0 protocol. If you need to reprint, please indicate the site URL or the original address.Any question please contact:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM