#559 JavadocStyle generates false "Unclosed HTML tag"

release_1.0
open
nobody
JavaDoc (21)
5
2014-02-09
2009-04-20
Toby Byron
No

This fragment of javadoc
*


    *
  1. it must take no arguments (the current command line interface is too crude to pass any in)


  2. *
  3. it must not have private access (recommendation: for simplicity, use default access)

  4. *

causes the JavadocStyle check to report a false problem:
Unclosed HTML tag found:

    If I remove the html comment which occurs after the first
  1. tag, then the error is not reported. Clearly, the JavadocStyle check is tripping up over the html comment.

Discussion

  • dito for the </nl> in this javadoc fragment:

    /**
     * Retrieve configuration setting. No alias resolution is used !
     *
     * Order of lookups:
     * <nl>
     * <li> plugin method {@link #getConfigurationSetting00(java.lang.String)}</li>
     * <li> system property </li>
     * <li> environment variable </li>
     * <li> plugin method {@link #getConfigurationSetting99(java.lang.String)}</li>
     * </nl>
    * .....
     */
    
     
  • Roman Ivanov
    Roman Ivanov
    2014-02-06

    • labels: --> JavaDoc
    • Group: --> release_1.0