= #17380 fix doc comments for java8 doclint

* actor and cluster-metrics comments
* agent/camel/cluster/osgi/persistence/remote comments
* comments in contrib/persistence-tck/multi-node/typed

akka-camel/src/main/scala/akka/camel/Camel.scala

@@ -80,9 +80,6 @@ class CamelSettings private[camel] (config: Config, dynamicAccess: DynamicAccess
    */
   final val AutoAck: Boolean = config.getBoolean("akka.camel.consumer.auto-ack")
 
-  /**
-   *
-   */
   final val JmxStatistics: Boolean = config.getBoolean("akka.camel.jmx")
 
   /**
@@ -127,7 +124,6 @@ class CamelSettings private[camel] (config: Config, dynamicAccess: DynamicAccess
  *
  * @see akka.actor.ExtensionId
  * @see akka.actor.ExtensionIdProvider
- *
  */
 object CamelExtension extends ExtensionId[Camel] with ExtensionIdProvider {
 

akka-camel/src/main/scala/akka/camel/CamelMessage.scala

@@ -49,7 +49,6 @@ case class CamelMessage(body: Any, headers: Map[String, Any]) {
    * in a [[scala.util.Success]]. If an exception occurs during the conversion to the type <code>T</code> or when the header cannot be found,
    * the exception is returned in a [[scala.util.Failure]].
    *
-   * <p>
    * The CamelContext is accessible in a [[akka.camel.javaapi.UntypedConsumerActor]] and [[akka.camel.javaapi.UntypedProducerActor]]
    * using the `getCamelContext` method, and is available on the [[akka.camel.CamelExtension]].
    *
@@ -60,7 +59,7 @@ case class CamelMessage(body: Any, headers: Map[String, Any]) {
   /**
    * Java API: Returns the header by given <code>name</code> parameter. The header is  converted to type <code>T</code> as defined by the <code>clazz</code> parameter.
    * An exception is thrown when the conversion to the type <code>T</code> fails or when the header cannot be found.
-   * <p>
+   *
    * The CamelContext is accessible in a [[akka.camel.javaapi.UntypedConsumerActor]] and [[akka.camel.javaapi.UntypedProducerActor]]
    * using the `getCamelContext` method, and is available on the [[akka.camel.CamelExtension]].
    */
@@ -133,7 +132,6 @@ case class CamelMessage(body: Any, headers: Map[String, Any]) {
 
 /**
  * Companion object of CamelMessage class.
- *
  */
 object CamelMessage {
 
@@ -176,7 +174,6 @@ object CamelMessage {
 /**
  * Positive acknowledgement message (used for application-acknowledged message receipts).
  * When `autoAck` is set to false in the [[akka.camel.Consumer]], you can send an `Ack` to the sender of the CamelMessage.
- *
  */
 case object Ack {
   /** Java API to get the Ack singleton */

akka-camel/src/main/scala/akka/camel/Consumer.scala

@@ -14,8 +14,6 @@ import scala.language.existentials
 
 /**
  * Mixed in by Actor implementations that consume message from Camel endpoints.
- *
- *
  */
 trait Consumer extends Actor with CamelSupport {
   import Consumer._

akka-camel/src/main/scala/akka/camel/Producer.scala

@@ -54,7 +54,7 @@ trait ProducerSupport extends Actor with CamelSupport {
    * actually sent it is pre-processed by calling <code>transformOutgoingMessage</code>. If <code>oneway</code>
    * is <code>true</code>, an in-only message exchange is initiated, otherwise an in-out message exchange.
    *
-   * @see Producer#produce(Any, ExchangePattern)
+   * @see Producer#produce
    */
   protected def produce: Receive = {
     case CamelProducerObjects(endpoint, processor) ⇒
@@ -119,7 +119,7 @@ trait ProducerSupport extends Actor with CamelSupport {
      * response is received asynchronously, the <code>receiveAfterProduce</code> is called
      * asynchronously. The original sender is preserved.
      *
-     * @see CamelMessage#canonicalize(Any)
+     * @see CamelMessage#canonicalize
      * @param endpoint the endpoint
      * @param processor the processor
      * @param msg message to produce

akka-camel/src/main/scala/akka/camel/internal/ActivationMessage.scala

@@ -1,8 +1,7 @@
-package akka.camel.internal
-
 /**
  * Copyright (C) 2009-2015 Typesafe Inc. <http://www.typesafe.com>
  */
+package akka.camel.internal
 
 import akka.actor.ActorRef
 

akka-camel/src/main/scala/akka/camel/internal/CamelExchangeAdapter.scala

@@ -9,7 +9,7 @@ import akka.camel.{ FailureResult, AkkaCamelException, CamelMessage }
 
 /**
  * INTERNAL API
- * Adapter for converting an [[org.apache.camel.Exchange]] to and from [[akka.camel.CamelMessage]] and [[akka.camel.Failure]] objects.
+ * Adapter for converting an [[org.apache.camel.Exchange]] to and from [[akka.camel.CamelMessage]] and [[akka.camel.FailureResult]] objects.
  * The org.apache.camel.Message is mutable and not suitable to be used directly as messages between Actors.
  * This adapter is used to convert to immutable messages to be used with Actors, and convert the immutable messages back
  * to org.apache.camel.Message when using Camel.
@@ -62,8 +62,6 @@ private[camel] class CamelExchangeAdapter(val exchange: Exchange) {
    * on the AkkaCamelException.
    *
    * If the exchange is out-capable then the headers of Exchange.getOut are used, otherwise the headers of Exchange.getIn are used.
-   *
-   * @see AkkaCamelException
    */
   def toAkkaCamelException: AkkaCamelException = toAkkaCamelException(Map.empty)
 
@@ -78,8 +76,6 @@ private[camel] class CamelExchangeAdapter(val exchange: Exchange) {
    *
    * @param headers additional headers to set on the exception in addition to those
    *                in the exchange.
-   *
-   * @see AkkaCamelException
    */
   def toAkkaCamelException(headers: Map[String, Any]): AkkaCamelException = {
     import scala.collection.JavaConversions._
@@ -88,8 +84,6 @@ private[camel] class CamelExchangeAdapter(val exchange: Exchange) {
 
   /**
    * Creates an immutable Failure object from the adapted Exchange so it can be used internally between Actors.
-   *
-   * @see Failure
    */
   def toFailureMessage: FailureResult = toFailureResult(Map.empty)
 
@@ -98,8 +92,6 @@ private[camel] class CamelExchangeAdapter(val exchange: Exchange) {
    *
    * @param headers additional headers to set on the created CamelMessage in addition to those
    *                in the Camel message.
-   *
-   * @see Failure
    */
   def toFailureResult(headers: Map[String, Any]): FailureResult = {
     import scala.collection.JavaConversions._

akka-camel/src/main/scala/akka/camel/internal/DefaultCamel.scala

@@ -47,7 +47,7 @@ private[camel] class DefaultCamel(val system: ExtendedActorSystem) extends Camel
   /**
    * Starts camel and underlying camel context and template.
    * Only the creator of Camel should start and stop it.
-   * @see akka.camel.DefaultCamel#shutdown()
+   * @see akka.camel.internal.DefaultCamel#shutdown
    */
   def start(): this.type = {
     context.start()
@@ -61,7 +61,7 @@ private[camel] class DefaultCamel(val system: ExtendedActorSystem) extends Camel
    * Only the creator of Camel should shut it down.
    * There is no need to stop Camel instance, which you get from the CamelExtension, as its lifecycle is bound to the actor system.
    *
-   * @see akka.camel.DefaultCamel#start()
+   * @see akka.camel.internal.DefaultCamel#start
    */
   def shutdown(): Unit = {
     try context.stop() finally {

akka-camel/src/main/scala/akka/camel/internal/component/ActorComponent.scala

@@ -30,8 +30,6 @@ import scala.util.{ Failure, Success, Try }
  * `ActorComponent` to the [[org.apache.camel.CamelContext]] under the 'actor' component name.
  * Messages are sent to [[akka.camel.Consumer]] actors through a [[akka.camel.internal.component.ActorEndpoint]] that
  * this component provides.
- *
- *
  */
 private[camel] class ActorComponent(camel: Camel, system: ActorSystem) extends DefaultComponent {
   /**
@@ -51,8 +49,6 @@ private[camel] class ActorComponent(camel: Camel, system: ActorSystem) extends D
  * Actors are referenced using actor endpoint URIs of the following format:
  * <code>[actorPath]?[options]%s</code>,
  * where <code>[actorPath]</code> refers to the actor path to the actor.
- *
- *
  */
 private[camel] class ActorEndpoint(uri: String,
                                    comp: ActorComponent,
@@ -87,7 +83,6 @@ private[camel] class ActorEndpoint(uri: String,
 /**
  * INTERNAL API
  * Configures the `ActorEndpoint`. This needs to be a `bean` for Camel purposes.
- *
  */
 private[camel] trait ActorEndpointConfig {
   def path: ActorEndpointPath
@@ -99,12 +94,10 @@ private[camel] trait ActorEndpointConfig {
 }
 
 /**
- * Sends the in-message of an exchange to an untyped actor, identified by an [[akka.camel.internal.component.ActorEndPoint]]
- *
- * @see akka.camel.component.ActorComponent
- * @see akka.camel.component.ActorEndpoint
- *
+ * Sends the in-message of an exchange to an untyped actor, identified by an [[akka.camel.internal.component.ActorEndpoint]]
  *
+ * @see akka.camel.internal.component.ActorComponent
+ * @see akka.camel.internal.component.ActorEndpoint
  */
 private[camel] class ActorProducer(val endpoint: ActorEndpoint, camel: Camel) extends DefaultProducer(endpoint) with AsyncProcessor {
   /**

akka-camel/src/main/scala/akka/camel/javaapi/UntypedProducerActor.scala

@@ -11,8 +11,6 @@ import org.apache.camel.impl.DefaultCamelContext
 
 /**
  * Subclass this abstract class to create an untyped producer actor. This class is meant to be used from Java.
- *
- *
  */
 abstract class UntypedProducerActor extends UntypedActor with ProducerSupport {
   /**