pr comment

pongad · pongad · commit 2578db3d19f6 · 2017-02-15T09:05:40.000+11:00
diff --git a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/spi/v1/Publisher.java b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/spi/v1/Publisher.java
@@ -550,7 +550,23 @@ interface LongRandom {
     long nextLong(long least, long bound);
   }
 
-  /** Constructs a new {@link Builder} using the given topic. */
+  /**
+   * Constructs a new {@link Builder} using the given topic.
+   *
+   * <p>Example of creating a {@code Publisher}.
+   *
+   * <pre>{@code
+   * String projectName = "my_project";
+   * String topicName = "my_topic";
+   * TopicName topic = TopicName.create(projectName, topicName);
+   * Publisher publisher = Publisher.newBuilder(topic).build();
+   * try {
+   *   // ...
+   * } finally {
+   *   // When finished with the publisher, make sure to shutdown to free up resources.
+   *   publisher.shutdown();
+   * }
+   */
   public static Builder newBuilder(TopicName topicName) {
     return new Builder(topicName);
   }
@@ -622,30 +638,6 @@ private Builder(TopicName topic) {
      * <p>For performance, this client benefits from having multiple channels open at once. Users
      * are encouraged to provide instances of {@code ChannelProvider} that creates new channels
      * instead of returning pre-initialized ones.
-     *
-     * <p>Example of creating a {@code Publisher}.
-     *
-     * <pre>{@code
-     * String projectName = "my_project";
-     * String topicName = "my_topic";
-     * TopicName topic = TopicName.create(projectName, topicName);
-     * Publisher publisher = Publisher.newBuilder(topic).build();
-     * }</pre>
-     *
-     * <p>Example of creating a {@code Publisher}.
-     *
-     * <pre>{@code
-     * String projectName = "my_project";
-     * String topicName = "my_topic";
-     * TopicName topic = TopicName.create(projectName, topicName);
-     * Publisher publisher = Publisher.newBuilder(topic).build();
-     * try {
-     *   // ...
-     * } finally {
-     *   // When finished with the publisher, make sure to shutdown to free up resources.
-     *   publisher.shutdown();
-     * }
-     * }</pre>
      */
     public Builder setChannelProvider(ChannelProvider channelProvider) {
       this.channelProvider = Preconditions.checkNotNull(channelProvider);
