Some javadocs information

Author: aaomidi

src/main/java/io/ipinfo/api/IPInfo.java

@@ -31,7 +31,7 @@ public static void main(String... args) {
     /**
      * Gets the builder for IPInfo
      *
-     * @return
+     * @return IPInfoBuilder object
      */
     public static IPInfoBuilder builder() {
         return new IPInfoBuilder();
@@ -40,9 +40,9 @@ public static IPInfoBuilder builder() {
     /**
      * Lookup IP information using the IP.
      *
-     * @param ip
-     * @return IPResponse
-     * @throws RateLimitedException
+     * @param ip the ip string to lookup - accepts both ipv4 and ipv6.
+     * @return IPResponse response from the api.
+     * @throws RateLimitedException an exception when your api key has been rate limited.
      */
     public IPResponse lookupIP(String ip) throws RateLimitedException {
         IPResponse response = cache.getIp(ip);
@@ -58,9 +58,9 @@ public IPResponse lookupIP(String ip) throws RateLimitedException {
     /**
      * Lookup ASN information using the AS number.
      *
-     * @param asn
-     * @return ASNResponse
-     * @throws RateLimitedException
+     * @param asn the asn string to lookup.
+     * @return ASNResponse response from the api.
+     * @throws RateLimitedException an exception when your api key has been rate limited.
      */
     public ASNResponse lookupASN(String asn) throws RateLimitedException {
         ASNResponse response = cache.getAsn(asn);

src/main/java/io/ipinfo/api/model/ASNResponse.java

@@ -34,7 +34,7 @@ public ASNResponse(String asn, String name, String country, String allocated, St
     /**
      * Set by the library for extra utility functions
      *
-     * @param context
+     * @param context for country information
      */
     public void setContext(Context context) {
         this.context = context;

src/main/java/io/ipinfo/api/model/IPResponse.java

@@ -35,7 +35,7 @@ public IPResponse(String ip, String hostname, String city, String region, String
     /**
      * Set by the library for extra utility functions
      *
-     * @param context
+     * @param context for country information
      */
     public void setContext(Context context) {
         this.context = context;