More doc fixes

Author: oschwald

src/main/java/com/maxmind/geoip2/DatabaseReader.java

@@ -89,6 +89,7 @@ public Builder(File database) {
          * @param val
          *            List of locale codes to use in name property from most
          *            preferred to least preferred.
+         * @return Builder object
          */
         public Builder locales(List<String> val) {
             this.locales = val;
@@ -102,6 +103,7 @@ public Builder locales(List<String> val) {
          *             if you initialized the Builder with a URL, which uses
          *             {@link FileMode#MEMORY}, but you provided a different
          *             FileMode to this method.
+         * @return Builder object
          * */
         public Builder fileMode(FileMode val) {
             if (this.stream != null && !FileMode.MEMORY.equals(val)) {
@@ -115,7 +117,7 @@ public Builder fileMode(FileMode val) {
         /**
          * @return an instance of <code>DatabaseReader</code> created from the
          *         fields set on this builder.
-         * @throws IOException
+         * @throws IOException if there is an error reading the database
          */
         public DatabaseReader build() throws IOException {
             return new DatabaseReader(this);

src/main/java/com/maxmind/geoip2/WebServiceClient.java

@@ -153,6 +153,7 @@ public Builder(int userId, String licenseKey) {
         /**
          * @param val
          *            The host to use.
+         * @return Builder object
          */
         public Builder host(String val) {
             this.host = val;
@@ -163,6 +164,7 @@ public Builder host(String val) {
          * @param val
          *            List of locale codes to use in name property from most
          *            preferred to least preferred.
+         * @return Builder object
          */
         public Builder locales(List<String> val) {
             this.locales = val;
@@ -173,6 +175,7 @@ public Builder locales(List<String> val) {
          * @param val
          *            Timeout in milliseconds for connection to web service. The
          *            default is 3000 (3 seconds).
+         * @return Builder object
          */
         public Builder timeout(int val) {
             this.timeout = val;
@@ -181,6 +184,7 @@ public Builder timeout(int val) {
 
         /**
          * @param val Transport for unit testing.
+         * @return Builder object
          */
         Builder testTransport(HttpTransport val) {
             this.testTransport = val;

src/main/java/com/maxmind/geoip2/record/Subdivision.java

@@ -29,9 +29,8 @@ public Integer getConfidence() {
     /**
      * @return This is a string up to three characters long contain the
      *         subdivision portion of the <a
-     *         href="http://en.wikipedia.org/wiki/ISO_3166-2 ISO 3166-2"
-     *         >code</a>. This attribute is returned by all end points except
-     *         Country.
+     *         href="http://en.wikipedia.org/wiki/ISO_3166-2">ISO 3166-2code</a>.
+     *         This attribute is returned by all end points except Country.
      */
     public String getIsoCode() {
         return this.isoCode;