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

Can't deprecate an entire package

XMLWordPrintable

    • 01
    • x86
    • windows_2000



        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)
        ======================================================================

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

                Created:
                Updated:
                Resolved:
                Imported:
                Indexed: