Improve Javadoc

Author: dmdashenkov

web/src/main/java/io/spine/web/subscription/SubscriptionBridge.java

@@ -59,7 +59,7 @@ public interface SubscriptionBridge<S extends Message, K extends Message, C exte
     S subscribe(Topic topic);
 
     /**
-     * Keep up the subscription, preventing it from closing from the server.
+     * Keeps up the subscription, preventing it from closing from the server.
      *
      * <p>This operation is performed because a subscription lifetime is finite. Server cancels
      * all subscriptions at some point, because maintaining them requires resources and the client
@@ -77,7 +77,7 @@ public interface SubscriptionBridge<S extends Message, K extends Message, C exte
     K keepUp(Subscription subscription);
 
     /**
-     * Keep up given subscriptions, preventing them from closing from the server.
+     * Keeps up given subscriptions, preventing them from closing from the server.
      *
      * <p>This operation is performed because a subscription lifetime is finite. Server cancels
      * all subscriptions at some point, because maintaining them requires resources and the client
@@ -95,7 +95,7 @@ public interface SubscriptionBridge<S extends Message, K extends Message, C exte
     Responses keepUpAll(Subscriptions subscription);
 
     /**
-     * Cancel the existing subscription.
+     * Cancels the existing subscription.
      *
      * <p>After this call, the server will stop sending subscription updates to the client.
      *
@@ -106,7 +106,7 @@ public interface SubscriptionBridge<S extends Message, K extends Message, C exte
     C cancel(Subscription subscription);
 
     /**
-     * Cancel existing subscriptions.
+     * Cancels existing subscriptions.
      *
      * <p>After this call, the server will stop sending subscription updates to the clients.
      *

web/src/main/java/io/spine/web/subscription/servlet/SubscriptionBulkKeepUpServlet.java

@@ -35,7 +35,7 @@
 import static com.google.common.base.Preconditions.checkNotNull;
 
 /**
- * An abstract servlet for a client request to keep up an existing {@link Subscription}.
+ * An abstract servlet handling the bulk {@link Subscription} keep-up requests.
  *
  * <p>This servlet parses the client requests and passes it to the {@link SubscriptionBridge}
  * to process. After, a processing result is written to the servlet response.
@@ -47,11 +47,11 @@ public abstract class SubscriptionBulkKeepUpServlet
     private final SubscriptionBridge<?, ?, ?> bridge;
 
     /**
-     * Creates a new instance of {@code SubscriptionBulkKeepUpServlet} with the given
-     * {@link SubscriptionBridge}.
+     * Creates a new instance of {@code SubscriptionBulkKeepUpServlet} with
+     * the given {@link SubscriptionBridge}.
      *
      * @param bridge
-     *         the subscription bridge to be used to keep-up subscriptions
+     *         the subscription bridge to be used to keep up subscriptions
      */
     protected SubscriptionBulkKeepUpServlet(SubscriptionBridge<?, ?, ?> bridge) {
         super();

web/src/main/java/io/spine/web/subscription/servlet/SubscriptionCancelAllServlet.java

@@ -49,7 +49,7 @@ public abstract class SubscriptionCancelAllServlet
      * {@link SubscriptionBridge}.
      *
      * @param bridge
-     *         the subscription bridge to be used in to cancel subscriptions
+     *         the subscription bridge to be used to cancel subscriptions
      */
     protected SubscriptionCancelAllServlet(SubscriptionBridge<?, ?, ?> bridge) {
         super();

web/src/main/java/io/spine/web/subscription/servlet/SubscriptionKeepUpServlet.java

@@ -51,7 +51,7 @@ public abstract class SubscriptionKeepUpServlet<T extends Message>
      * {@link SubscriptionBridge}.
      *
      * @param bridge
-     *         the subscription bridge to be used to keep-up subscriptions
+     *         the subscription bridge to be used to keep up subscriptions
      */
     protected SubscriptionKeepUpServlet(SubscriptionBridge<?, T, ?> bridge) {
         super();