Does nobody build documentation?
Andrew John Hughes
gnu_andrew at member.fsf.org
Thu Jan 7 13:32:03 PST 2010
With OpenJDK7 b78:
>>>Recursively making docs docs @ Thu Jan 7 21:01:48 GMT 2010 ...
make[3]: Entering directory
`/home/andrew/projects/openjdk/upstream/icedtea/jdk/make/docs'
rm -f -r /mnt/builder/icedtea/docs/api
/bin/mkdir -p /mnt/builder/icedtea/docs/api
/usr/lib/jvm/icedtea6/bin/java -XX:-PrintVMOptions
-XX:+UnlockDiagnosticVMOptions -XX:-LogVMOutput -Xmx1024m -Xms128m
-XX:PermSize=32m -XX:MaxPermSize=160m
"-Xbootclasspath/p:/mnt/builder/icedtea/langtools/dist/bootstrap/lib/javadoc.jar:/mnt/builder/icedtea/langtools/dist/bootstrap/lib/javac.jar:/mnt/builder/icedtea/langtools/dist/bootstrap/lib/doclets.jar"
-jar /mnt/builder/icedtea/langtools/dist/bootstrap/lib/javadoc.jar
-XDignore.symbol.file=true -source 1.5 -quiet -use -keywords -tag
beaninfo:X -tag revised:X -tag since.unbundled:X -tag spec:X -tag
Note:X -tag ToDo:X -tag 'jls3:a:See <cite><a
href="http://java.sun.com/docs/books/jls/"> The Java Language
Specification, Third Edition</a></cite>:' -encoding ISO-8859-1
-splitIndex -doctitle 'Java™ Platform, Standard Edition
7<br>API Documentation''<br><strong>DRAFT 'internal-b00'</strong>'
-windowtitle 'Java Platform SE 7'" b00" -header
'<strong>Java™ Platform<br>Standard Ed. 7</strong>''<br><strong>DRAFT 'internal-b00'</strong>'
-top '<div style="background-color: #EEEEEE"> <div style="padding:
6px; margin-top: 2px; margin-bottom: 6px; margin-left: 6px;
margin-right: 6px; text-align: justify; font-size: 80%; font-family:
Helvetica, Arial, sans-serif; font-weight: normal;"> Please note that
this documentation is not final and is subject to change. </div>
</div>' -bottom '<font size="-1"><a
href="http://bugs.sun.com/services/bugreport/index.jsp">Submit a bug
or feature</a> <p>Copyright 2010 Sun Microsystems, Inc. All Rights
Reserved. Use is subject to <a
href="{@docroot}/../legal/license.html">license terms</a>.</font>'
\
-d /mnt/builder/icedtea/docs/api \
-sourcepath
"../../src/share/classes:../../src/solaris/classes:/mnt/builder/icedtea/gensrc:../../src/share/doc/stub:/share/classes:/mnt/builder/icedtea/impsrc"
\
java.applet java.awt java.awt.color
java.awt.datatransfer java.awt.dnd java.awt.event java.awt.font
java.awt.geom java.awt.im java.awt.im.spi java.awt.image
java.awt.image.renderable java.awt.print java.beans
java.beans.beancontext java.dyn java.io java.lang java.lang.annotation
java.lang.instrument java.lang.management java.lang.ref
java.lang.reflect java.math java.net java.nio java.nio.channels
java.nio.channels.spi java.nio.charset java.nio.charset.spi
java.nio.file java.nio.file.attribute java.nio.file.spi java.rmi
java.rmi.activation java.rmi.dgc java.rmi.registry java.rmi.server
java.security java.security.acl java.security.cert
java.security.interfaces java.security.spec java.sql java.text
java.text.spi java.util java.util.concurrent
java.util.concurrent.atomic java.util.concurrent.locks java.util.jar
java.util.logging java.util.prefs java.util.regex java.util.spi
java.util.zip javax.accessibility javax.activation javax.activity
javax.annotation javax.annotation.processing javax.crypto
javax.crypto.interfaces javax.crypto.spec javax.imageio
javax.imageio.event javax.imageio.metadata javax.imageio.plugins.jpeg
javax.imageio.plugins.bmp javax.imageio.spi javax.imageio.stream
javax.jws javax.jws.soap javax.lang.model javax.lang.model.element
javax.lang.model.type javax.lang.model.util javax.management
javax.management.loading javax.management.monitor
javax.management.relation javax.management.openmbean
javax.management.timer javax.management.modelmbean
javax.management.remote javax.management.remote.rmi javax.naming
javax.naming.directory javax.naming.event javax.naming.ldap
javax.naming.spi javax.net javax.net.ssl javax.print
javax.print.attribute javax.print.attribute.standard javax.print.event
javax.rmi javax.rmi.CORBA javax.rmi.ssl javax.script
javax.security.auth javax.security.auth.callback
javax.security.auth.kerberos javax.security.auth.login
javax.security.auth.spi javax.security.auth.x500 javax.security.cert
javax.security.sasl javax.sound.sampled javax.sound.sampled.spi
javax.sound.midi javax.sound.midi.spi javax.sql javax.sql.rowset
javax.sql.rowset.serial javax.sql.rowset.spi javax.swing
javax.swing.border javax.swing.colorchooser javax.swing.filechooser
javax.swing.event javax.swing.table javax.swing.text
javax.swing.text.html javax.swing.text.html.parser
javax.swing.text.rtf javax.swing.tree javax.swing.undo
javax.swing.plaf javax.swing.plaf.basic javax.swing.plaf.metal
javax.swing.plaf.multi javax.swing.plaf.nimbus javax.swing.plaf.synth
javax.tools javax.transaction javax.transaction.xa javax.xml.parsers
javax.xml.bind javax.xml.bind.annotation
javax.xml.bind.annotation.adapters javax.xml.bind.attachment
javax.xml.bind.helpers javax.xml.bind.util javax.xml.soap javax.xml.ws
javax.xml.ws.handler javax.xml.ws.handler.soap javax.xml.ws.http
javax.xml.ws.soap javax.xml.ws.spi javax.xml.ws.wsaddressing
javax.xml.transform javax.xml.transform.sax javax.xml.transform.dom
javax.xml.transform.stax javax.xml.transform.stream javax.xml
javax.xml.crypto javax.xml.crypto.dom javax.xml.crypto.dsig
javax.xml.crypto.dsig.dom javax.xml.crypto.dsig.keyinfo
javax.xml.crypto.dsig.spec javax.xml.datatype javax.xml.validation
javax.xml.namespace javax.xml.xpath javax.xml.stream
javax.xml.stream.events javax.xml.stream.util org.ietf.jgss
org.omg.CORBA org.omg.CORBA.DynAnyPackage org.omg.CORBA.ORBPackage
org.omg.CORBA.TypeCodePackage org.omg.stub.java.rmi
org.omg.CORBA.portable org.omg.CORBA_2_3 org.omg.CORBA_2_3.portable
org.omg.CosNaming org.omg.CosNaming.NamingContextExtPackage
org.omg.CosNaming.NamingContextPackage org.omg.SendingContext
org.omg.PortableServer org.omg.PortableServer.CurrentPackage
org.omg.PortableServer.POAPackage
org.omg.PortableServer.POAManagerPackage
org.omg.PortableServer.ServantLocatorPackage
org.omg.PortableServer.portable org.omg.PortableInterceptor
org.omg.PortableInterceptor.ORBInitInfoPackage org.omg.Messaging
org.omg.IOP org.omg.IOP.CodecFactoryPackage org.omg.IOP.CodecPackage
org.omg.Dynamic org.omg.DynamicAny org.omg.DynamicAny.DynAnyPackage
org.omg.DynamicAny.DynAnyFactoryPackage org.w3c.dom org.w3c.dom.events
org.w3c.dom.bootstrap org.w3c.dom.ls org.xml.sax org.xml.sax.ext
org.xml.sax.helpers
../../src/share/classes/java/awt/Component.java:6029: EventQueueItem
is not public in sun.awt; cannot be accessed from outside package
transient sun.awt.EventQueueItem[] eventCache;
^
../../src/share/classes/java/awt/EventQueue.java:45: EventQueueItem is
not public in sun.awt; cannot be accessed from outside package
import sun.awt.EventQueueItem;
^
../../src/share/classes/java/lang/management/PlatformComponent.java:42:
Util is not public in sun.management; cannot be accessed from outside
package
import sun.management.Util;
^
../../src/share/classes/sun/font/FontManagerForSGE.java:39: interface
expected here
public interface FontManagerForSGE extends FontManager {
^
../../src/share/classes/com/sun/jmx/mbeanserver/DefaultMXBeanMappingFactory.java:29:
cannot find symbol
import static com.sun.jmx.mbeanserver.MXBeanIntrospector.typeName;
^
symbol: static typeName
location: class MXBeanIntrospector
../../src/share/classes/java/dyn/CallSite.java:120: warning - Tag
@link: can't find bootstrapInvokeDynamic in java.dyn.Linkage
../../src/share/classes/java/dyn/MethodType.java:247: warning - Tag
@link: can't find make(java.lang.Class, java.lang.Class[], boolean) in
java.dyn.MethodType
../../src/share/classes/java/dyn/MethodType.java:287: warning - Tag
@link: can't find make(java.lang.Class, java.lang.Class[], boolean) in
java.dyn.MethodType
../../src/share/classes/java/dyn/MethodType.java:271: warning - Tag
@link: can't find make(java.lang.Class, java.lang.Class[], boolean) in
java.dyn.MethodType
../../src/share/classes/java/dyn/MethodType.java:259: warning - Tag
@link: can't find make(java.lang.Class, java.lang.Class[], boolean) in
java.dyn.MethodType
../../src/share/classes/java/dyn/MethodType.java:213: warning - Tag
@link: can't find make(java.lang.Class, java.lang.Class[], boolean) in
java.dyn.MethodType
../../src/share/classes/java/lang/management/PlatformManagedObject.java:52:
warning - Tag @linkplain: reference not found:
ManagementFactory.getPlatformMBeanServer
platform MBeanServer
../../src/share/classes/java/rmi/activation/Activatable.java:98:
warning - Tag @link: missing '#':
"exportObject(Remote,String,MarshalledObject,boolean,port)
exportObject"
../../src/share/classes/java/rmi/activation/Activatable.java:98:
warning - Tag @link: can't find
exportObject(Remote,String,MarshalledObject,boolean,port) in
java.rmi.activation.Activatable
../../src/share/classes/java/rmi/activation/Activatable.java:148:
warning - Tag @link: missing '#':
"exportObject(Remote,String,MarshalledObject,boolean,port,RMIClientSocketFactory,RMIServerSocketFactory)
exportObject"
../../src/share/classes/java/rmi/activation/Activatable.java:148:
warning - Tag @link: can't find
exportObject(Remote,String,MarshalledObject,boolean,port,RMIClientSocketFactory,RMIServerSocketFactory)
in java.rmi.activation.Activatable
../../src/share/classes/java/rmi/activation/Activatable.java:339:
warning - Tag @link: missing '#':
"exportObject(Remote,String,MarshalledObject,boolean,port,RMIClientSocketFactory,RMIServerSocketFactory)
exportObject"
../../src/share/classes/java/rmi/activation/Activatable.java:339:
warning - Tag @link: can't find
exportObject(Remote,String,MarshalledObject,boolean,port,RMIClientSocketFactory,RMIServerSocketFactory)
in java.rmi.activation.Activatable
../../src/share/classes/java/rmi/registry/LocateRegistry.java:202:
warning - Tag @link: missing '#':
"UnicastRemoteObject.exportObject(Remote,int)
UnicastRemoteObject.exportObject"
../../src/share/classes/java/rmi/registry/LocateRegistry.java:202:
warning - Tag @link: can't find
UnicastRemoteObject.exportObject(Remote,int) in
java.rmi.registry.LocateRegistry
../../src/share/classes/java/rmi/registry/LocateRegistry.java:234:
warning - Tag @link: missing '#':
"UnicastRemoteObject.exportObject(Remote,int,RMIClientSocketFactory,RMIServerSocketFactory)
UnicastRemoteObject.exportObject"
../../src/share/classes/java/rmi/registry/LocateRegistry.java:234:
warning - Tag @link: can't find
UnicastRemoteObject.exportObject(Remote,int,RMIClientSocketFactory,RMIServerSocketFactory)
in java.rmi.registry.LocateRegistry
../../src/share/classes/java/rmi/server/RemoteObjectInvocationHandler.java:143:
warning - @see tag has no arguments.
../../src/share/classes/java/rmi/server/RemoteObjectInvocationHandler.java:143:
warning - Tag @see: reference not found:
../../src/share/classes/java/security/cert/CertPathValidatorException.java:227:
warning - Tag @link: reference not found: getIndex
../../src/share/classes/java/text/Bidi.java:128: warning - Tag @see:
reference not found: TextAttribute#BIDI_EMBEDDING
../../src/share/classes/java/text/Bidi.java:128: warning - Tag @see:
reference not found: TextAttribute#NUMERIC_SHAPING
../../src/share/classes/java/text/Bidi.java:128: warning - Tag @see:
reference not found: TextAttribute#RUN_DIRECTION
../../src/share/classes/java/util/logging/PlatformLoggingMXBean.java:59:
warning - @See is an unknown tag -- same as a known tag except for
case.
../../src/share/classes/javax/accessibility/AccessibleContext.java:318:
warning - Tag @see: can't find AccessibleText.AccessibleTextSequence
in javax.accessibility.AccessibleContext
../../src/share/classes/javax/accessibility/AccessibleContext.java:341:
warning - Tag @see: can't find
AccessibleText.AccessibleAttributeSequence in
javax.accessibility.AccessibleContext
../../src/share/classes/javax/accessibility/AccessibleContext.java:301:
warning - Tag @see: can't find AccessibleText.AccessibleTextSequence
in javax.accessibility.AccessibleContext
../../src/share/classes/javax/accessibility/AccessibleExtendedText.java:54:
warning - Tag @see: reference not found:
AccessibleText.AccessibleTextChunk
../../src/share/classes/javax/accessibility/AccessibleKeyBinding.java:49:
warning - Tag @see: can't find getAccessibleKeyBinding in
javax.accessibility.AccessibleContext
../../src/share/classes/javax/accessibility/AccessibleKeyBinding.java:49:
warning - Tag @link: can't find getAccessibleKeyBinding in
javax.accessibility.AccessibleContext
/mnt/builder/icedtea/impsrc/javax/jws/WebMethod.java:54: warning -
@specdefault is an unknown tag.
/mnt/builder/icedtea/impsrc/javax/jws/WebParam.java:70: warning -
@specdefault is an unknown tag.
/mnt/builder/icedtea/impsrc/javax/jws/WebParam.java:82: warning -
@specdefault is an unknown tag.
/mnt/builder/icedtea/impsrc/javax/jws/WebParam.java:95: warning -
@specdefault is an unknown tag.
/mnt/builder/icedtea/impsrc/javax/jws/WebParam.java:107: warning -
@specdefault is an unknown tag.
/mnt/builder/icedtea/impsrc/javax/jws/WebResult.java:59: warning -
@specdefault is an unknown tag.
/mnt/builder/icedtea/impsrc/javax/jws/WebResult.java:71: warning -
@specdefault is an unknown tag.
/mnt/builder/icedtea/impsrc/javax/jws/WebResult.java:84: warning -
@specdefault is an unknown tag.
/mnt/builder/icedtea/impsrc/javax/jws/WebService.java:52: warning -
@specdefault is an unknown tag.
/mnt/builder/icedtea/impsrc/javax/jws/WebService.java:68: warning -
@specdefault is an unknown tag.
/mnt/builder/icedtea/impsrc/javax/jws/WebService.java:79: warning -
@specdefault is an unknown tag.
/mnt/builder/icedtea/impsrc/javax/jws/WebService.java:92: warning -
@specdefault is an unknown tag.
../../src/share/classes/javax/management/MBeanServerDelegate.java:218:
cannot find symbol
Util.newObjectName("JMImplementation:type=MBeanServerDelegate");
^
symbol: method newObjectName(String)
location: class Util
../../src/share/classes/javax/management/ObjectName.java:1920: cannot
find symbol
public static final ObjectName WILDCARD = Util.newObjectName("*:*");
^
symbol: method newObjectName(String)
location: class Util
/mnt/builder/icedtea/impsrc/javax/rmi/PortableRemoteObject.java:171:
warning - Tag @link: reference not found: Stub#connect
/mnt/builder/icedtea/impsrc/org/omg/CORBA/SetOverrideType.java:50:
warning - Tag @link: reference not found:
omg.org.CORBA.Object._set_policy_override
/mnt/builder/icedtea/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/icedtea/impsrc/org/omg/CORBA/UnknownUserException.java:62:
warning - @ is an unknown tag.
/mnt/builder/icedtea/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/icedtea/impsrc/org/omg/CosNaming/_NamingContextExtStub.java:301:
warning - @parm is an unknown tag.
/mnt/builder/icedtea/impsrc/org/omg/CosNaming/_NamingContextStub.java:146:
warning - @parm is an unknown tag.
/mnt/builder/icedtea/impsrc/org/omg/CosNaming/NamingContextOperations.java:89:
warning - @parm is an unknown tag.
/mnt/builder/icedtea/impsrc/org/omg/PortableInterceptor/IORInfoOperations.java:54:
warning - @param argument "a_component" is not a parameter name.
/mnt/builder/icedtea/impsrc/org/omg/PortableInterceptor/IORInfoOperations.java:72:
warning - @param argument "a_component" is not a parameter name.
2 errors
57 warnings
The build fails at that point. The errors seem odd; there seems to be
an issue with javadoc correctly parsing the access/type of classes in
these files, which presumably compiled fine earlier in the build.
Some of the warnings have been fixed by Joe Darcy but presumably
weren't promoted in time for b78.
The build completes if NO_DOCS=true is set.
--
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
More information about the jdk7-dev
mailing list