Merge branch 'master' of github.com:square/retrofit

jpotts18 · Aug 8, 2013 · c5124b4 · c5124b4
2 parents 989d69f + c2a85f8
commit c5124b4
Show file tree

Hide file tree

Showing 15 changed files with 48 additions and 9 deletions.
diff --git a/retrofit/src/main/java/retrofit/http/Body.java b/retrofit/src/main/java/retrofit/http/Body.java
@@ -15,6 +15,7 @@
  */
 package retrofit.http;
 
+import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
@@ -35,6 +36,8 @@
  *
  * @author Eric Denman ([email protected])
  */
-@Target(PARAMETER) @Retention(RUNTIME)
+@Documented
+@Target(PARAMETER)
+@Retention(RUNTIME)
 public @interface Body {
 }
diff --git a/retrofit/src/main/java/retrofit/http/DELETE.java b/retrofit/src/main/java/retrofit/http/DELETE.java
@@ -15,13 +15,15 @@
  */
 package retrofit.http;
 
+import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
 import static java.lang.annotation.ElementType.METHOD;
 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
 /** Make a DELETE request to a REST path relative to base URL. */
+@Documented
 @Target(METHOD)
 @Retention(RUNTIME)
 @RestMethod("DELETE")

diff --git a/retrofit/src/main/java/retrofit/http/Field.java b/retrofit/src/main/java/retrofit/http/Field.java
@@ -15,6 +15,7 @@
  */
 package retrofit.http;
 
+import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
@@ -33,7 +34,9 @@
  * <p>
  * Field parameters may be {@code null} which will omit them from the request body.
  */
-@Target(PARAMETER) @Retention(RUNTIME)
+@Documented
+@Target(PARAMETER)
+@Retention(RUNTIME)
 public @interface Field {
   String value();
 }
diff --git a/retrofit/src/main/java/retrofit/http/FormUrlEncoded.java b/retrofit/src/main/java/retrofit/http/FormUrlEncoded.java
@@ -15,6 +15,7 @@
  */
 package retrofit.http;
 
+import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
@@ -29,6 +30,8 @@
  * type. Field names and values will be UTF-8 encoded before being URI-encoded in accordance to
  * <a href="http://tools.ietf.org/html/rfc3986">RFC-3986</a>.
  */
-@Target(METHOD) @Retention(RUNTIME)
+@Documented
+@Target(METHOD)
+@Retention(RUNTIME)
 public @interface FormUrlEncoded {
 }
diff --git a/retrofit/src/main/java/retrofit/http/GET.java b/retrofit/src/main/java/retrofit/http/GET.java
@@ -15,13 +15,15 @@
  */
 package retrofit.http;
 
+import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
 import static java.lang.annotation.ElementType.METHOD;
 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
 /** Make a GET request to a REST path relative to base URL. */
+@Documented
 @Target(METHOD)
 @Retention(RUNTIME)
 @RestMethod("GET")

diff --git a/retrofit/src/main/java/retrofit/http/HEAD.java b/retrofit/src/main/java/retrofit/http/HEAD.java
@@ -15,13 +15,15 @@
  */
 package retrofit.http;
 
+import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
 import static java.lang.annotation.ElementType.METHOD;
 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
 /** Make a HEAD request to a REST path relative to base URL. */
+@Documented
 @Target(METHOD)
 @Retention(RUNTIME)
 @RestMethod("HEAD")

diff --git a/retrofit/src/main/java/retrofit/http/Header.java b/retrofit/src/main/java/retrofit/http/Header.java
@@ -15,6 +15,7 @@
  */
 package retrofit.http;
 
+import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
@@ -36,7 +37,9 @@
  *
  * @author Adrian Cole ([email protected])
  */
-@Retention(RUNTIME) @Target(PARAMETER)
+@Documented
+@Retention(RUNTIME)
+@Target(PARAMETER)
 public @interface Header {
   String value();
 }
diff --git a/retrofit/src/main/java/retrofit/http/Headers.java b/retrofit/src/main/java/retrofit/http/Headers.java
@@ -15,6 +15,7 @@
  */
 package retrofit.http;
 
+import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
@@ -42,7 +43,9 @@
  *
  * @author Adrian Cole ([email protected])
  */
-@Target(METHOD) @Retention(RUNTIME)
+@Documented
+@Target(METHOD)
+@Retention(RUNTIME)
 public @interface Headers {
   String[] value();
 }
diff --git a/retrofit/src/main/java/retrofit/http/Multipart.java b/retrofit/src/main/java/retrofit/http/Multipart.java
@@ -15,6 +15,7 @@
  */
 package retrofit.http;
 
+import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
@@ -25,6 +26,8 @@
  * Denotes that the request body is multi-part. Parts should be declared as parameters and
  * annotated with {@link Part @Part}.
  */
-@Target(METHOD) @Retention(RUNTIME)
+@Documented
+@Target(METHOD)
+@Retention(RUNTIME)
 public @interface Multipart {
 }
diff --git a/retrofit/src/main/java/retrofit/http/POST.java b/retrofit/src/main/java/retrofit/http/POST.java
@@ -15,13 +15,15 @@
  */
 package retrofit.http;
 
+import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
 import static java.lang.annotation.ElementType.METHOD;
 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
 /** Make a POST request to a REST path relative to base URL. */
+@Documented
 @Target(METHOD)
 @Retention(RUNTIME)
 @RestMethod(value = "POST", hasBody = true)

diff --git a/retrofit/src/main/java/retrofit/http/PUT.java b/retrofit/src/main/java/retrofit/http/PUT.java
@@ -15,13 +15,15 @@
  */
 package retrofit.http;
 
+import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
 import static java.lang.annotation.ElementType.METHOD;
 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
 /** Make a PUT request to a REST path relative to base URL. */
+@Documented
 @Target(METHOD)
 @Retention(RUNTIME)
 @RestMethod(value = "PUT", hasBody = true)

diff --git a/retrofit/src/main/java/retrofit/http/Part.java b/retrofit/src/main/java/retrofit/http/Part.java
@@ -15,6 +15,7 @@
  */
 package retrofit.http;
 
+import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
@@ -45,7 +46,9 @@
  * <p>
  * Part parameters may not be {@code null}.
  */
-@Target(PARAMETER) @Retention(RUNTIME)
+@Documented
+@Target(PARAMETER)
+@Retention(RUNTIME)
 public @interface Part {
   String value();
 }
diff --git a/retrofit/src/main/java/retrofit/http/Path.java b/retrofit/src/main/java/retrofit/http/Path.java
@@ -15,6 +15,7 @@
  */
 package retrofit.http;
 
+import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
@@ -32,7 +33,9 @@
  * <p>
  * Path parameters may not be {@code null}.
  */
-@Retention(RUNTIME) @Target(PARAMETER)
+@Documented
+@Retention(RUNTIME)
+@Target(PARAMETER)
 public @interface Path {
   String value();
 }
diff --git a/retrofit/src/main/java/retrofit/http/Query.java b/retrofit/src/main/java/retrofit/http/Query.java
@@ -15,6 +15,7 @@
  */
 package retrofit.http;
 
+import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
@@ -32,7 +33,9 @@
  * <p>
  * Query parameters may be {@code null} which will omit them from the URL.
  */
-@Target(PARAMETER) @Retention(RUNTIME)
+@Documented
+@Target(PARAMETER)
+@Retention(RUNTIME)
 public @interface Query {
   String value();
 }
diff --git a/retrofit/src/main/java/retrofit/http/RestMethod.java b/retrofit/src/main/java/retrofit/http/RestMethod.java
@@ -15,12 +15,14 @@
  */
 package retrofit.http;
 
+import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
 import static java.lang.annotation.ElementType.ANNOTATION_TYPE;
 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
+@Documented
 @Target(ANNOTATION_TYPE)
 @Retention(RUNTIME)
 public @interface RestMethod {