Converts the documentation to JavaDoc instead of ScalaDoc

Author: viktorklang

spi/src/main/java/org/reactivestreams/api/Consumer.java

@@ -4,7 +4,7 @@
 
 /**
  * A Consumer is the logical sink of elements of a given type.
- * The underlying implementation is done by way of a [[org.reactivestreams.spi.Subscriber]].
+ * The underlying implementation is done by way of a {@link org.reactivestreams.spi.Subscriber Subscriber}.
  * This interface is the user-level API for a sink while a Subscriber is the SPI.
  * 
  * Implementations of this interface will typically offer domain- or language-specific
@@ -13,7 +13,7 @@
 public interface Consumer<T> {
 
   /**
-   * Get the underlying Subscriber for this Consumer. This method should only be used by
+   * Get the underlying {@link org.reactivestreams.spi.Subscriber Subscriber} for this Consumer. This method should only be used by
    * implementations of this API.
    * 
    * @return the underlying subscriber for this consumer

spi/src/main/java/org/reactivestreams/api/Processor.java

@@ -4,7 +4,7 @@
  * A Processor is a stand-alone representation of a transformation for
  * elements from In to Out types. Implementations of this API will provide
  * factory methods for creating Processors and connecting them to
- * [[Producer]] and [[Consumer]].
+ * {@link org.reactivestreams.api.Producer Producer} and {@link org.reactivestreams.api.Consumer Consumer}.
  */
 public interface Processor<I, O> extends Consumer<I>, Producer<O> {
 }

spi/src/main/java/org/reactivestreams/api/Producer.java

@@ -4,7 +4,7 @@
 
 /**
  * A Producer is the logical source of elements of a given type. 
- * The underlying implementation is done by way of a [[org.reactivestreams.spi.Publisher]].
+ * The underlying implementation is done by way of a {@link org.reactivestreams.spi.Publisher Publisher}.
  * This interface is the user-level API for a source while a Publisher is the
  * SPI.
  * 
@@ -14,7 +14,7 @@
 public interface Producer<T> {
 
   /**
-   * Get the underlying Publisher for this Producer. This method should only be used by
+   * Get the underlying {@link org.reactivestreams.spi.Publisher Publisher} for this Producer. This method should only be used by
    * implementations of this API.
    * 
    * @return the underlying publisher for this producer
@@ -23,8 +23,8 @@ public interface Producer<T> {
 
   /**
    * Connect the given consumer to this producer. This means that the
-   * Subscriber underlying the Consumer subscribes to this Producer’s
-   * underlying Publisher, which will initiate the transfer of the produced
+   * Subscriber underlying the {@link org.reactivestreams.api.Consumer Consumer} subscribes to this Producer’s
+   * underlying {@link org.reactivestreams.spi.Publisher Publisher}, which will initiate the transfer of the produced
    * stream of elements from producer to consumer until either of three things
    * happen:
    * <ul>

spi/src/main/java/org/reactivestreams/spi/Publisher.java

@@ -1,14 +1,14 @@
 package org.reactivestreams.spi;
 
 /**
- * A Publisher is a source of elements of a given type. One or more [[Subscriber]] may be connected
+ * A Publisher is a source of elements of a given type. One or more {@link org.reactivestreams.spi.Subscriber Subscriber} may be connected
  * to this Publisher in order to receive the published elements, contingent on availability of these
- * elements as well as the presence of demand signaled by the Subscriber via [[Subscription#requestMore]].
+ * elements as well as the presence of demand signaled by the Subscriber via {@link org.reactivestreams.spi.Subscription#requestMore(int) requestMore}.
  */
 public interface Publisher<T> {
 
   /**
-   * Subscribe the given [[Subscriber]] to this Publisher. A Subscriber can at most be subscribed once
+   * Subscribe the given {@link org.reactivestreams.spi.Subscriber Subscriber} to this Publisher. A Subscriber can at most be subscribed once
    * to a given Publisher, and to at most one Publisher in total.
    * 
    * @param subscriber The subscriber to register with this publisher.

spi/src/main/java/org/reactivestreams/spi/Subscriber.java

@@ -1,39 +1,39 @@
 package org.reactivestreams.spi;
 
 /**
- * A Subscriber receives elements from a [[Publisher]] based on the [[Subscription]] it has.
+ * A Subscriber receives elements from a {@link org.reactivestreams.spi.Publisher Publisher} based on the {@link org.reactivestreams.spi.Subscription Subscription} it has.
  * The Publisher may supply elements as they become available, the Subscriber signals demand via 
- * [[Subscription#requestMore]] and elements from when supply and demand are both present.
+ * {@link org.reactivestreams.spi.Subscription#requestMore(int) requestMore} and elements from when supply and demand are both present.
  */
 public interface Subscriber<T> {
 
   /**
-   * The [[Publisher]] generates a [[Subscription]] upon [[Publisher#subscribe]] and passes
+   * The {@link org.reactivestreams.spi.Publisher Publisher} generates a {@link org.reactivestreams.spi.Subscription Subscription} upon {@link org.reactivestreams.spi.Publisher#subscribe(org.reactivestreams.spi.Subscriber) subscribe} and passes
    * it on to the Subscriber named there using this method. The Publisher may choose to reject
-   * the subscription request by calling [[#onError]] instead.
+   * the subscription request by calling {@link #onError onError} instead.
    * 
    * @param subscription The subscription which connects this subscriber to its publisher.
    */
   public void onSubscribe(Subscription subscription);
 
   /**
-   * The [[Publisher]] calls this method to pass one element to this Subscriber. The element
+   * The {@link org.reactivestreams.spi.Publisher Publisher} calls this method to pass one element to this Subscriber. The element
    * must not be <code>null</code>. The Publisher must not call this method more often than
-   * the Subscriber has signaled demand for via the corresponding [[Subscription]].
+   * the Subscriber has signaled demand for via the corresponding {@link org.reactivestreams.spi.Subscription Subscription}.
    * 
    * @param element The element that is passed from publisher to subscriber.
    */
   public void onNext(T element);
 
   /**
-   * The [[Publisher]] calls this method in order to signal that it terminated normally.
+   * The {@link org.reactivestreams.spi.Publisher Publisher} calls this method in order to signal that it terminated normally.
    * No more elements will be forthcoming and none of the Subscriber’s methods will be
    * called hereafter.
    */
   public void onComplete();
 
   /**
-   * The [[Publisher]] calls this method to signal that the stream of elements has failed
+   * The {@link org.reactivestreams.spi.Publisher Publisher} calls this method to signal that the stream of elements has failed
    * and is being aborted. The Subscriber should abort its processing as soon as possible.
    * No more elements will be forthcoming and none of the Subscriber’s methods will be
    * called hereafter.

spi/src/main/java/org/reactivestreams/spi/Subscription.java

@@ -1,25 +1,25 @@
 package org.reactivestreams.spi;
 
 /**
- * A Subscription models the relationship between a [[Publisher]] and a [[Subscriber]].
+ * A Subscription models the relationship between a {@link org.reactivestreams.spi.Publisher Publisher} and a {@link org.reactivestreams.spi.Subscriber Subscriber}.
  * The Subscriber receives a Subscription so that it can ask for elements to be delivered
- * using [[Subscription#requestMore]]. The Subscription can be disposed of by canceling it.
+ * using {@link org.reactivestreams.spi.Subscription#requestMore(int) requestMore}. The Subscription can be disposed of by canceling it.
  */
 public interface Subscription {
 
   /**
-   * Cancel this subscription. The [[Publisher]] to which produced this Subscription 
-   * will eventually stop sending more elements to the [[Subscriber]] which owns
+   * Cancel this subscription. The {@link org.reactivestreams.spi.Publisher Publisher} to which produced this Subscription 
+   * will eventually stop sending more elements to the {@link org.reactivestreams.spi.Subscriber Subscriber} which owns
    * this Subscription. This may happen before the requested number of elements has
    * been delivered, even if the Publisher would still have more elements.
    */
   public void cancel();
 
   /**
-   * Request more data from the [[Publisher]] which produced this Subscription.
+   * Request more data from the {@link org.reactivestreams.spi.Publisher Publisher} which produced this Subscription.
    * The number of requested elements is cumulative to the number requested previously.
    * The Publisher may eventually publish up to the requested number of elements to
-   * the [[Subscriber]] which owns this Subscription.
+   * the {@link org.reactivestreams.spi.Subscriber Subscriber} which owns this Subscription.
    * 
    * @param elements The number of elements requested.
    */