A clarification for the use of metadata-complete in the application
client deployment descriptor follows below.  This should be added to
section EE.10.6 ("Packaging and Deployment"), after Table EE.10.1.

------

The metadata-complete attribute defines whether the application client
deployment descriptor is complete, or whether the class files
available to the application client module should be examined for
annotations that specify deployment information.  Deployment
information, in this sense, refers to any information that could have
been specified by the application client deployment descriptor for the
module.

If the value of the metadata-complete attribute is specified as
“true”, the deployment tool must ignore any annotations that specify
such deployment information in the class files packaged in the
application client jar file.  Such annotations must also be ignored in
the class files that are available to the application client module
according to section EE.8.5.2 of the Java EE Platform specification
("Deploying a Java EE Application") except for those class files that
are available to another module for which the metadata-complete
attribute is not specified or whose value is set to "false".

Note that a "true" value for the metadata-complete attribute does
*not* preempt the processing of *all* annotations, only those
listed below.

The annotations to which the metadata-complete attribute applies
consist of the following: 

  javax.annotation.PostConstruct
  javax.annotation.PreDestroy
  javax.annotation.Resource
  javax.annotation.Resources
  javax.annotation.sql.DataSourceDefinition
  javax.annotation.sql.DataSourceDefinitions

  javax.ejb.EJB
  javax.ejb.EJBs

  javax.jms.JMSConnectionFactoryDefinition
  javax.jms.JMSConnectionFactoryDefinitions
  javax.jms.JMSDestinationDefinition
  javax.jms.JMSDestinationDefinitions

  javax.mail.MailSessionDefinition
  javax.mail.MailSessionDefinitions

  javax.persistence.PersistenceUnit
  javax.persistence.PersistenceUnits
 
  javax.resource.AdministeredObjectDefinition
  javax.resource.AdministeredObjectDefinitions
  javax.resource.ConnectionFactoryDefinition
  javax.resource.ConnectionFactoryDefinitions

  javax.xml.ws.WebServiceRef
  javax.xml.ws.WebServiceRefs

If the metadata-complete attribute is not specified or its value is
“false”, the deployment tool must examine the class files for all such
annotations.