We received this email from  customer  on our developer forum that javac is not able to find the classes in javax.xml.ws.wsaddressing package in JDK6 U4 and U5.

The class javax.xml.ws.wsaddressing.W3CEndpointReference is in rt.jar.
When we compile the attached testcase with rt.jar explicitly in the classpath, it compiles.
But when we do just javac W3CEndpointReferenceTest.java , it fails.

We have tried with JDK6 U4 and JDK6 U5 and we observe the same behavior.
We are hearing similar complaints on our user forums.
Posted Date : 2008-03-07 20:28:13.0

N/A

The package in question is not listed in the make/docs/CORE_PKGS.gmk makefile.
Posted Date : 2008-03-07 22:06:49.0

You need to add the package in question:
   javax.xml.ws.wsaddressing

to the list in j2se/make/docs/CORE_PKGS.gmk.  Look for a macro named CORE_PKGS, and for the following group of entries in the definition of that macro:
 javax.xml.ws                                   \
 javax.xml.ws.handler                           \
 javax.xml.ws.handler.soap                      \
 javax.xml.ws.http                              \
 javax.xml.ws.soap                              \
 javax.xml.ws.spi                               \

You need to add your new package into this list of packages. This will have two effects, both good (I think)

-- the primary effect is that it will add the new package into the list of packages included the generated javadoc for the core Java API, when someone does a "docs build".

-- as a side effect, because it is listed as part of the core (documented) API, it will have the right effect when the build creates the ct.sym file -- in other words, the contents of this package will be included in ct.sym such that using these classes will not cause warnings or errors.

Since you will be changing the contents of the docs build, you should at least warn the Docs team that you are making this change and why.  To review the change I suggest you either ask someone on the docs team, like Eric Armstrong, or a build person, like Kelly O'hair.  At some point, I could imagine the docs team wanting to put an updated docs bundle on java.sun.com (eg see here http://java.sun.com/reference/api/ )
but since changing the API is an unusual occurrence for an update build, I'm not sure how and when the docs team would make that decision.
Posted Date : 2008-03-07 22:13:23.0