Javadoc 多行声明语法？

Question

如果我有变量声明:

/**
 * The Resource folder for the program Information.
 */
public static final Path RESOURCE_FOLDER_PATH = Paths.get("", "Resources"),
/**
 * The folder holding all faction information.
 */
FACTION_FOLDER_PATH = Paths.get(RESOURCE_FOLDER_PATH.toString(), "Faction Information");

Javadoc 不会记录后一个 Path 变量。 Javadoc 是否支持这种类型的文档风格还是我必须单独声明它们？

Answer 1

不，不幸的是你不能。

您需要按照以下更清晰、更整洁的方式进行操作:

/**
 * Returns an Image object that can then be painted on the screen. 
 * The url argument must specify an absolute {@link URL}. The name
 * argument is a specifier that is relative to the url argument. 
 * <p>
 * This method always returns immediately, whether or not the 
 * image exists. When this applet attempts to draw the image on
 * the screen, the data will be loaded. The graphics primitives 
 * that draw the image will incrementally paint on the screen. 
 *
 * @param  url  an absolute URL giving the base location of the image
 * @param  name the location of the image, relative to the url argument
 * @return      the image at the specified URL
 * @see         Image
 */
 public Image getImage(URL url, String name) {
        try {
            return getImage(new URL(url, name));
        } catch (MalformedURLException e) {
            return null;
        }
 }