Enhance java doc

CopyrightWaivers.txt

@@ -24,3 +24,5 @@ viktorklang    | Viktor Klang, [email protected], Typesafe Inc.
 smaldini       | Stephane Maldini, [email protected], Pivotal Software Inc.
 savulchik      | Stanislav Savulchik, [email protected]
 ktoso          | Konrad Malawski, [email protected], Typesafe Inc.
+ouertani       | Slim Ouertani, [email protected] 
+

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

@@ -3,6 +3,9 @@
 /**
  * A 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}
+ * @param <R> the type of element signaled by the {@link Publisher}
  */
 public interface Processor<T, R> extends Subscriber<T>, Publisher<R> {
 }

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

@@ -1,5 +1,14 @@
 package org.reactivestreams;
 
+/**
+ * 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
+ * at various points in time.
+ *
+ * @param <T> the type of element signaled.
+ */
 public interface Publisher<T> {
 
     /**
@@ -11,9 +20,9 @@ public interface Publisher<T> {
      * <p>
      * 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 
+     * If the {@link Publisher} rejects the subscription attempt or otherwise fails it will
      * signal the error via {@link Subscriber#onError}.
-     * 
+     *
      * @param s the {@link Subscriber} that will consume signals from this {@link Publisher}
      */
     public void subscribe(Subscriber<? super T> s);

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

@@ -13,7 +13,7 @@
  * <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> {
     /**