/*
 * Copyright 2015, Google Inc. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are
 * met:
 *
 *    * Redistributions of source code must retain the above copyright
 * notice, this list of conditions and the following disclaimer.
 *    * Redistributions in binary form must reproduce the above
 * copyright notice, this list of conditions and the following disclaimer
 * in the documentation and/or other materials provided with the
 * distribution.
 *
 *    * Neither the name of Google Inc. nor the names of its
 * contributors may be used to endorse or promote products derived from
 * this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

/**
 * The gRPC core public API.
 */
package io.grpc;

@@ -1554,16 +1554,33 @@
 E.%0A */%0A%0A
+package io.grpc;%0A
 /**%0A * T
@@ -1610,23 +1610,2266 @@
 .%0A *
-/%0Apackage io.grpc;
+%0A * %3Cp%3EgRPC is based on a client-server model of remote procedural calls.  A client creates a%0A * channel which is connected to a server.  RPCs are initiated from the client and sent to the%0A * server which then responds back to the client.  When the client and server are done sending%0A * messages, they half close their respective connections.  The RPC is complete as soon as the%0A * server closes.%0A *%0A * %3Cp%3ETo send an RPC, first create a %7B@link Channel%7D using %7B@link ManagedChannelBuilder#forTarget%7D.%0A * When using auto generate Protobuf stubs, the stub class will have constructors for wrapping the%0A * channel.  These include %7B@code newBlockingStub%7D, %7B@code newStub%7D, and %7B@code newFutureStub%7D%0A * which you can use based on your design.  The stub is the primary way a client interacts with a%0A * server.%0A *%0A * %3Cp%3ETo receive RPCs, create a %7B@link Server%7D using %7B@link ServerBuilder#forPort%7D.  The Protobuf%0A * stub will contain an abstract class called AbstractFoo, where Foo is the name of your service.%0A * Extend this class, and pass an instance of it to %7B@link ServerBuilder#addService%7D.  Once your%0A * server is built, call %7B@link Server#start%7D to begin accepting RPCs.%0A *%0A * %3Cp%3EBoth Clients and Servers should use a custom %7B@link java.util.concurrent.Executor%7D.  The gRPC%0A * runtime includes a default executor that eases testing and examples, but is not ideal for use in%0A * a production environment.  See the associated documentation in the respective builders.%0A *%0A * %3Cp%3EClients and Servers can also be gracefully shutdown gracefully using the %7B@code shutdown%7D%0A * method.  The API to conduct an orderly shutdown is modeled from the%0A * %7B@link java.util.concurrent.ExecutorService%7D.%0A *%0A * %3Cp%3EgRPC also includes support for more advanced features, such as name resolution, load%0A * balancing, bidirectional streaming, health checking, and more.  See the relative methods in the%0A * client and server builders.%0A *%0A * %3Cp%3EDevelopment of gRPC is done primary on Github at%0A * %3Ca href=%22https://github.com/grpc/grpc-java%22%3Ehttps://github.com/grpc/grpc-java%3C/a%3E, where the gRPC%0A * team welcomes contributions and bug reports.  There is also a mailing list at%0A * %3Ca href=%22https://groups.google.com/forum/#!forum/grpc-io%22%3Egrpc-io%3C/a%3E if you have questions%0A * about gRPC.%0A */%0A
 %0A

add package level javadoc.