When building documentation, both OpenJDK6 and OpenJDK7 spit out a number of warnings when building documentation:
/mnt/builder/jdk6/impsrc/javax/rmi/PortableRemoteObject.java:171: warning - Tag @link: reference not found: Stub#connect /mnt/builder/jdk6/impsrc/org/omg/CORBA/SetOverrideType.java:50: warning - Tag @link: reference not found: omg.org.CORBA.Object._se\ t_policy_override /mnt/builder/jdk6/impsrc/org/omg/CORBA/TCKind.java:552: warning - Tag @return cannot be used in constructor documentation. It can\ only be used in the following types of documentation: method. /mnt/builder/jdk6/impsrc/org/omg/CORBA/UnknownUserException.java:62: warning - @ is an unknown tag. /mnt/builder/jdk6/impsrc/org/omg/CORBA/portable/ServantObject.java:48: warning - Tag @return cannot be used in field documentation\ . It can only be used in the following types of documentation: method. /mnt/builder/jdk6/impsrc/org/omg/CosNaming/_NamingContextExtStub.java:301: warning - @parm is an unknown tag. /mnt/builder/jdk6/impsrc/org/omg/CosNaming/_NamingContextStub.java:146: warning - @parm is an unknown tag. /mnt/builder/jdk6/impsrc/org/omg/CosNaming/NamingContextOperations.java:89: warning - @parm is an unknown tag. /mnt/builder/jdk6/impsrc/org/omg/PortableInterceptor/IORInfoOperations.java:54: warning - @param argument "a_component" is not a p\ arameter name. /mnt/builder/jdk6/impsrc/org/omg/PortableInterceptor/IORInfoOperations.java:72: warning - @param argument "a_component" is not a p\ arameter name. This patch against OpenJDK7: http://cr.openjdk.java.net/~andrew/build/webrev.04/corba.patch fixes the warnings. Is this ok to push? If so, can I have a bug ID for it? Joe, would this also be ok for 6? Thanks, -- Andrew :-) Free Java Software Engineer Red Hat, Inc. (http://www.redhat.com) Support Free Java! Contribute to GNU Classpath and the OpenJDK http://www.gnu.org/software/classpath http://openjdk.java.net PGP Key: 94EFD9D8 (http://subkeys.pgp.net) Fingerprint: F8EF F1EA 401E 2E60 15FA 7927 142C 2591 94EF D9D8