Refine comments;

maven repo now have 3.0.1 ready

Author: Javen

README.md

@@ -13,14 +13,14 @@
 
 ## 安装
 
-### maven 方式（3.0.0 版本 maven 库里还没有，请直接用 jar 的方式）
+### maven 方式
 将下边的依赖条件放到你项目的 maven pom.xml 文件里。
 
 ```
 <dependency>
     <groupId>cn.jpush.api</groupId>
     <artifactId>jpush-client</artifactId>
-    <version>2.3.1</version>
+    <version>3.0.1</version>
 </dependency>
 ```
 ### jar 包方式
@@ -209,5 +209,3 @@ if (receivedsResult.isResultOK()) {
     }
 }
 ```
-
-

src/cn/jpush/api/JPushClient.java

@@ -25,12 +25,14 @@ public JPushClient(String masterSecret, String appKey) {
 	}
 
 	/**
-	 * Create a JPush Client with overall settings.
+	 * Create a JPush Client with global settings.
+	 * 
+	 * If you want different settings from default globally, this constructor is what you needed.
 	 * 
 	 * @param masterSecret API access secret of the appKey.
 	 * @param appKey The KEY of one application on JPush.
-	 * @param apnsProduction Overall APNs environment setting. It will override PushPayload Optional.
-	 * @param timeToLive Overall time_to_live setting. It will override PushPayload Optional.
+	 * @param apnsProduction Global APNs environment setting. It will override PushPayload Options.
+	 * @param timeToLive Global time_to_live setting. It will override PushPayload Options.
 	 */
     public JPushClient(String masterSecret, String appKey, boolean apnsProduction, long timeToLive) {
         _pushClient = new PushClient(masterSecret, appKey, apnsProduction, timeToLive);

src/cn/jpush/api/push/PushClient.java

@@ -40,6 +40,12 @@ public class PushClient {
     private final String _authCode;
     private String _baseUrl;
 
+    /**
+     * Create a Push Client.
+     * 
+     * @param masterSecret API access secret of the appKey.
+     * @param appKey The KEY of one application on JPush.
+     */
 	public PushClient(String masterSecret, String appKey) {
         this._masterSecret = masterSecret;
         this._appKey = appKey;
@@ -49,6 +55,16 @@ public PushClient(String masterSecret, String appKey) {
         ServiceHelper.checkBasic(appKey, masterSecret);
 	}
 
+	/**
+     * Create a Push Client with global settings.
+     * 
+     * If you want different settings from default globally, this constructor is what you needed.
+     * 
+     * @param masterSecret API access secret of the appKey.
+     * @param appKey The KEY of one application on JPush.
+     * @param apnsProduction Global APNs environment setting. It will override PushPayload Options.
+     * @param timeToLive Global time_to_live setting. It will override PushPayload Options.
+     */
     public PushClient(String masterSecret, String appKey, boolean apnsProduction, long timeToLive) {
         this(masterSecret, appKey);
         this._apnsProduction = apnsProduction;

src/cn/jpush/api/push/model/PushPayload.java

@@ -9,9 +9,10 @@
 import com.google.gson.JsonObject;
 
 /**
- * The object you should to build for sending a push.
+ * The object you should build for sending a push.
  * 
  * Basically start with newBuilder() method to build a PushPayload object.
+ * 
  * alertAll() is a shortcut for quickly build payload of alert to all platform and all audience;
  * mesageAll() is a shortcut for quickly build payload of message to all platform and all audience.
  * 
@@ -154,8 +155,10 @@ public Builder setOptions(Options options) {
         }
 
         public PushPayload build() {
-            Preconditions.checkArgument(! (null == audience || null == platform), "Audience/Platform should be set.");
+            Preconditions.checkArgument(! (null == audience || null == platform), "audience and platform both should be set.");
             Preconditions.checkArgument(! (null == notification && null == message), "notification or message should be set at least one.");
+            
+            // if options is not set, a sendno will be generated for tracing easily
             if (null == options) {
                 options = Options.sendno();
             }