Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8044739

Public APIs should have consistent and correct @since information

XMLWordPrintable

    • Icon: Task Task
    • Resolution: Fixed
    • Icon: P4 P4
    • None
    • None
    • other-libs
    • None

      Currently in OpenJDK, @since tag is not applied consistently. Quite a few don't even have @since information, and among those have them, various format are used, for example, there are JDK1.0, JDK 1.0, 1.0 all referring to JDK 1.0.

      A consistent and accurate @since tag is an important information, particularly when developer need to ensure compatibility to previous versions of Java platform.

        1.
        		 Convert all JDK versions used in @since tag to 1.n[.n] in jdk repo Sub-task Resolved Henry Jen  
        2.
        		 Add missing @since tag under java.beans.* Sub-task Resolved Henry Jen  
        3.
        		 Add missing @since tag under javax.sql.** Sub-task Resolved Henry Jen  
        4.
        		 Add missing @since tag under javax.swing.* Sub-task Resolved Henry Jen  
        5.
        		 @since should have JDK version Sub-task Closed Henry Jen  
        6.
        		 @since tag cleanup in corba Sub-task Closed Henry Jen  
        7.
        		 @since tag cleanup in jaxp Sub-task Resolved Henry Jen  
        8.
        		 @since tag cleanup in jaxws Sub-task Resolved Henry Jen  
        9.
        		 Add @since 1.9 to new packages added in jaxp Sub-task Resolved Henry Jen  

            henryjen Henry Jen
            henryjen Henry Jen
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved: