Styling unification. (reactive-streams#485)

* Styling unification

Author: tomislavhofman

Diff for: CopyrightWaivers.txt

@@ -46,4 +46,5 @@ olegdokuka     | Oleh Dokuka, [email protected], Netifi Inc.
 Scottmitch     | Scott Mitchell, [email protected], Apple Inc.
 retronym       | Jason Zaugg, [email protected], Lightbend Inc.
 sullis         | Sean Sullivan, [email protected]
+tomislavhofman | Tomislav Hofman, [email protected]
 

Diff for: api/src/main/java/org/reactivestreams/Processor.java

@@ -12,7 +12,7 @@
 package org.reactivestreams;
 
 /**
- * A Processor represents a processing stage—which is both a {@link Subscriber}
+ * A {@link Processor} represents a processing stage—which is both a {@link Subscriber}
  * and a {@link Publisher} and obeys the contracts of both.
  *
  * @param <T> the type of element signaled to the {@link Subscriber}

Diff for: api/src/main/java/org/reactivestreams/Publisher.java

@@ -15,10 +15,10 @@
  * A {@link Publisher} is a provider of a potentially unbounded number of sequenced elements, publishing them according to
  * the demand received from its {@link Subscriber}(s).
  * <p>
- * A {@link Publisher} can serve multiple {@link Subscriber}s subscribed {@link #subscribe(Subscriber)} dynamically
+ * A {@link Publisher} can serve multiple {@link Subscriber}s subscribed {@link Publisher#subscribe(Subscriber)} dynamically
  * at various points in time.
  *
- * @param <T> the type of element signaled.
+ * @param <T> the type of element signaled
  */
 public interface Publisher<T> {
 
@@ -32,7 +32,7 @@ public interface Publisher<T> {
      * A {@link Subscriber} should only subscribe once to a single {@link Publisher}.
      * <p>
      * If the {@link Publisher} rejects the subscription attempt or otherwise fails it will
-     * signal the error via {@link Subscriber#onError}.
+     * signal the error via {@link Subscriber#onError(Throwable)}.
      *
      * @param s the {@link Subscriber} that will consume signals from this {@link Publisher}
      */

Diff for: api/src/main/java/org/reactivestreams/Subscriber.java

@@ -24,9 +24,10 @@
  * <p>
  * Demand can be signaled via {@link Subscription#request(long)} whenever the {@link Subscriber} instance is capable of handling more.
  *
- * @param <T> the type of element signaled.
+ * @param <T> the type of element signaled
  */
 public interface Subscriber<T> {
+
     /**
      * Invoked after calling {@link Publisher#subscribe(Subscriber)}.
      * <p>
@@ -36,8 +37,7 @@ public interface Subscriber<T> {
      * <p>
      * The {@link Publisher} will send notifications only in response to {@link Subscription#request(long)}.
      * 
-     * @param s
-     *            {@link Subscription} that allows requesting data via {@link Subscription#request(long)}
+     * @param s the {@link Subscription} that allows requesting data via {@link Subscription#request(long)}
      */
     public void onSubscribe(Subscription s);
 

Diff for: api/src/main/java/org/reactivestreams/Subscription.java

@@ -17,9 +17,9 @@
  * It can only be used once by a single {@link Subscriber}.
  * <p>
  * It is used to both signal desire for data and cancel demand (and allow resource cleanup).
- *
  */
 public interface Subscription {
+
     /**
      * No events will be sent by a {@link Publisher} until demand is signaled via this method.
      * <p>