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

Can't deprecate an entire package

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Resolved
    • Priority: P4
    • Resolution: Fixed
    • Affects Version/s: 1.4.2
    • Fix Version/s: 1.4.2_01
    • Component/s: docs
    • Labels:
    • Subcomponent:
    • Resolved In Build:
      01
    • CPU:
      x86
    • OS:
      windows_2000

      Backports

        Description



        Name: gm110360 Date: 07/16/2003


        FULL PRODUCT VERSION :
        java version "1.4.2"
        Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28)
        Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)

        FULL OS VERSION :
        Windows 2000 Professional

        A DESCRIPTION OF THE PROBLEM :
        Can't deprecate an entire package.
        %JAVA_HOME%/docs/tooldocs/windows/javadoc.html#packagetags states that you can use the @deprecated tag in package.html. However when I do this it has no influence on the generated documentation.
        Also, javac does not generate warnings for classes using this package. This is just a minor problem because all the classes inside the package are deprecated as well so javac will generate warnings either way.

        The contents of package.html are:
        <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
        <html>
        <body bgcolor="white">
        <h2>Package Specification</h2>
        <!-- Put @see and @since tags down here. -->
        @deprecated
        </body>
        </html>



        REPRODUCIBILITY :
        This bug can be reproduced always.

        CUSTOMER SUBMITTED WORKAROUND :
        For javac, deprecate every class inside the package.
        (Incident Review ID: 191009)
        ======================================================================

          Attachments

            Issue Links

              Activity

                People

                Assignee:
                dkramersunw Douglas Kramer (Inactive)
                Reporter:
                gmanwanisunw Girish Manwani (Inactive)
                Votes:
                0 Vote for this issue
                Watchers:
                0 Start watching this issue

                  Dates

                  Created:
                  Updated:
                  Resolved:
                  Imported:
                  Indexed: