Add @SInCE and @author where required.

Revert changes to RequestDocumentation.java since they were outside the scope of this change.

Author: clydebarrow

build.gradle

@@ -105,9 +105,8 @@ subprojects {
 
 	compileJava {
 		options.compilerArgs = [ '-Xlint:deprecation', '-Xlint:-options', '-Werror' ]
-		options.encoding = "UTF-8"
+		options.encoding = 'UTF-8'
 	}
-
 }
 
 configure(subprojects - project(":docs")) { subproject ->
@@ -154,7 +153,7 @@ configure(subprojects - project(":docs")) { subproject ->
 		options.docTitle = "${options.header} API"
 		options.links = javadocLinks
 		options.addStringOption '-quiet'
-        options.encoding = 'UTF-8'
+		options.encoding = 'UTF-8'
 	}
 
 	task sourcesJar(type: Jar) {

spring-restdocs-core/src/main/java/org/springframework/restdocs/cookies/AbstractCookiesSnippet.java

@@ -33,6 +33,7 @@
  *
  * @author Andreas Evers
  * @author Clyde Stubbs
+ * @since 2.1
  */
 public abstract class AbstractCookiesSnippet extends TemplatedSnippet {
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/cookies/CookieDescriptor.java

@@ -23,6 +23,7 @@
  *
  * @author Andreas Evers
  * @author Clyde Stubbs
+ * @since 2.1
  * @see CookieDocumentation#cookieWithName(String)
  */
 public class CookieDescriptor extends IgnorableDescriptor<CookieDescriptor> {

spring-restdocs-core/src/main/java/org/springframework/restdocs/cookies/CookieDocumentation.java

@@ -29,6 +29,7 @@
  * @author Andy Wilkinson
  * @author Marcel Overdijk
  * @author Clyde Stubbs
+ * @since 2.1
  */
 public abstract class CookieDocumentation {
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/cookies/RequestCookiesSnippet.java

@@ -33,6 +33,7 @@
  * @author Andreas Evers
  * @author Andy Wilkinson
  * @author Clyde Stubbs
+ * @since 2.1
  * @see CookieDocumentation#requestCookies(CookieDescriptor...)
  * @see CookieDocumentation#requestCookies(Map, CookieDescriptor...)
  */

spring-restdocs-core/src/main/java/org/springframework/restdocs/cookies/ResponseCookiesSnippet.java

@@ -33,6 +33,7 @@
  * @author Andreas Evers
  * @author Andy Wilkinson
  * @author Clyde Stubbs
+ * @since 2.1
  * @see CookieDocumentation#responseCookies(CookieDescriptor...)
  * @see CookieDocumentation#responseCookies(Map, CookieDescriptor...)
  */

spring-restdocs-core/src/main/java/org/springframework/restdocs/operation/OperationResponse.java

@@ -63,7 +63,7 @@ public interface OperationResponse {
 	 * Returns the {@link ResponseCookie cookies} returned with the response. If no
 	 * cookies were returned an empty collection is returned.
 	 * @return the cookies, never {@code null}
-	 * @since 2.0.4
+	 * @since 2.1
 	 */
 	Collection<ResponseCookie> getCookies();
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/operation/OperationResponseFactory.java

@@ -39,6 +39,7 @@ public class OperationResponseFactory {
 	 * @param content the content of the request
 	 * @param cookies the cookies
 	 * @return the {@code OperationResponse}
+	 * @since 2.1
 	 */
 	public OperationResponse create(HttpStatus status, HttpHeaders headers,
 			byte[] content, Collection<ResponseCookie> cookies) {

spring-restdocs-core/src/main/java/org/springframework/restdocs/operation/ResponseCookie.java

@@ -20,7 +20,7 @@
  * A representation of a Cookie returned in a response.
  *
  * @author Clyde Stubbs
- * @since 2.0.4
+ * @since 2.1
  */
 public final class ResponseCookie {
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/request/RequestDocumentation.java

@@ -65,8 +65,8 @@ public static RequestPartDescriptor partWithName(String name) {
 	 * request path, a failure will also occur.
 	 * <p>
 	 * If you do not want to document a path parameter, a parameter descriptor can be
-	 * marked as {@link ParameterDescriptor#ignored()}. This will prevent it from
-	 * appearing in the generated snippet while avoiding the failure described above.
+	 * marked as {@link ParameterDescriptor#ignored}. This will prevent it from appearing
+	 * in the generated snippet while avoiding the failure described above.
 	 * @param descriptors the descriptions of the parameters in the request's path
 	 * @return the snippet that will document the parameters
 	 */
@@ -86,8 +86,8 @@ public static PathParametersSnippet pathParameters(
 	 * request path, a failure will also occur.
 	 * <p>
 	 * If you do not want to document a path parameter, a parameter descriptor can be
-	 * marked as {@link ParameterDescriptor#ignored()}. This will prevent it from
-	 * appearing in the generated snippet while avoiding the failure described above.
+	 * marked as {@link ParameterDescriptor#ignored}. This will prevent it from appearing
+	 * in the generated snippet while avoiding the failure described above.
 	 * @param descriptors the descriptions of the parameters in the request's path
 	 * @return the snippet that will document the parameters
 	 */
@@ -138,8 +138,8 @@ public static PathParametersSnippet relaxedPathParameters(
 	 * request path, a failure will also occur.
 	 * <p>
 	 * If you do not want to document a path parameter, a parameter descriptor can be
-	 * marked as {@link ParameterDescriptor#ignored()}. This will prevent it from
-	 * appearing in the generated snippet while avoiding the failure described above.
+	 * marked as {@link ParameterDescriptor#ignored}. This will prevent it from appearing
+	 * in the generated snippet while avoiding the failure described above.
 	 * @param attributes the attributes
 	 * @param descriptors the descriptions of the parameters in the request's path
 	 * @return the snippet that will document the parameters
@@ -161,8 +161,8 @@ public static PathParametersSnippet pathParameters(Map<String, Object> attribute
 	 * request path, a failure will also occur.
 	 * <p>
 	 * If you do not want to document a path parameter, a parameter descriptor can be
-	 * marked as {@link ParameterDescriptor#ignored()}. This will prevent it from
-	 * appearing in the generated snippet while avoiding the failure described above.
+	 * marked as {@link ParameterDescriptor#ignored}. This will prevent it from appearing
+	 * in the generated snippet while avoiding the failure described above.
 	 * @param attributes the attributes
 	 * @param descriptors the descriptions of the parameters in the request's path
 	 * @return the snippet that will document the parameters
@@ -217,8 +217,8 @@ public static PathParametersSnippet relaxedPathParameters(
 	 * request, a failure will also occur.
 	 * <p>
 	 * If you do not want to document a request parameter, a parameter descriptor can be
-	 * marked as {@link ParameterDescriptor#ignored()}. This will prevent it from
-	 * appearing in the generated snippet while avoiding the failure described above.
+	 * marked as {@link ParameterDescriptor#ignored}. This will prevent it from appearing
+	 * in the generated snippet while avoiding the failure described above.
 	 * @param descriptors the descriptions of the request's parameters
 	 * @return the snippet
 	 * @see OperationRequest#getParameters()
@@ -239,8 +239,8 @@ public static RequestParametersSnippet requestParameters(
 	 * request, a failure will also occur.
 	 * <p>
 	 * If you do not want to document a request parameter, a parameter descriptor can be
-	 * marked as {@link ParameterDescriptor#ignored()}. This will prevent it from
-	 * appearing in the generated snippet while avoiding the failure described above.
+	 * marked as {@link ParameterDescriptor#ignored}. This will prevent it from appearing
+	 * in the generated snippet while avoiding the failure described above.
 	 * @param descriptors the descriptions of the request's parameters
 	 * @return the snippet
 	 * @see OperationRequest#getParameters()
@@ -294,8 +294,8 @@ public static RequestParametersSnippet relaxedRequestParameters(
 	 * request, a failure will also occur.
 	 * <p>
 	 * If you do not want to document a request parameter, a parameter descriptor can be
-	 * marked as {@link ParameterDescriptor#ignored()}. This will prevent it from
-	 * appearing in the generated snippet while avoiding the failure described above.
+	 * marked as {@link ParameterDescriptor#ignored}. This will prevent it from appearing
+	 * in the generated snippet while avoiding the failure described above.
 	 * @param attributes the attributes
 	 * @param descriptors the descriptions of the request's parameters
 	 * @return the snippet that will document the parameters
@@ -318,8 +318,8 @@ public static RequestParametersSnippet requestParameters(
 	 * request, a failure will also occur.
 	 * <p>
 	 * If you do not want to document a request parameter, a parameter descriptor can be
-	 * marked as {@link ParameterDescriptor#ignored()}. This will prevent it from
-	 * appearing in the generated snippet while avoiding the failure described above.
+	 * marked as {@link ParameterDescriptor#ignored}. This will prevent it from appearing
+	 * in the generated snippet while avoiding the failure described above.
 	 * @param attributes the attributes
 	 * @param descriptors the descriptions of the request's parameters
 	 * @return the snippet that will document the parameters
@@ -376,7 +376,7 @@ public static RequestParametersSnippet relaxedRequestParameters(
 	 * failure will also occur.
 	 * <p>
 	 * If you do not want to document a part, a part descriptor can be marked as
-	 * {@link RequestPartDescriptor#ignored()}. This will prevent it from appearing in the
+	 * {@link RequestPartDescriptor#ignored}. This will prevent it from appearing in the
 	 * generated snippet while avoiding the failure described above.
 	 * @param descriptors the descriptions of the request's parts
 	 * @return the snippet
@@ -396,7 +396,7 @@ public static RequestPartsSnippet requestParts(RequestPartDescriptor... descript
 	 * failure will also occur.
 	 * <p>
 	 * If you do not want to document a part, a part descriptor can be marked as
-	 * {@link RequestPartDescriptor#ignored()}. This will prevent it from appearing in the
+	 * {@link RequestPartDescriptor#ignored}. This will prevent it from appearing in the
 	 * generated snippet while avoiding the failure described above.
 	 * @param descriptors the descriptions of the request's parts
 	 * @return the snippet
@@ -448,7 +448,7 @@ public static RequestPartsSnippet relaxedRequestParts(
 	 * failure will also occur.
 	 * <p>
 	 * If you do not want to document a part, a part descriptor can be marked as
-	 * {@link RequestPartDescriptor#ignored()}. This will prevent it from appearing in the
+	 * {@link RequestPartDescriptor#ignored}. This will prevent it from appearing in the
 	 * generated snippet while avoiding the failure described above.
 	 * @param attributes the attributes
 	 * @param descriptors the descriptions of the request's parts
@@ -471,7 +471,7 @@ public static RequestPartsSnippet requestParts(Map<String, Object> attributes,
 	 * failure will also occur.
 	 * <p>
 	 * If you do not want to document a part, a part descriptor can be marked as
-	 * {@link RequestPartDescriptor#ignored()}. This will prevent it from appearing in the
+	 * {@link RequestPartDescriptor#ignored}. This will prevent it from appearing in the
 	 * generated snippet while avoiding the failure described above.
 	 * @param attributes the attributes
 	 * @param descriptors the descriptions of the request's parts

spring-restdocs-core/src/test/java/org/springframework/restdocs/cookies/RequestCookiesSnippetFailureTests.java

@@ -35,6 +35,7 @@
  * undocumented cookies.
  *
  * @author Andy Wilkinson
+ * @author Clyde Stubbs
  */
 public class RequestCookiesSnippetFailureTests {
 

spring-restdocs-core/src/test/java/org/springframework/restdocs/cookies/ResponseCookiesSnippetFailureTests.java

@@ -35,6 +35,7 @@
  * undocumented cookies.
  *
  * @author Andy Wilkinson
+ * @author Clyde Stubbs
  */
 public class ResponseCookiesSnippetFailureTests {
 

spring-restdocs-core/src/test/java/org/springframework/restdocs/cookies/ResponseCookiesSnippetTests.java

@@ -40,6 +40,7 @@
  *
  * @author Andreas Evers
  * @author Andy Wilkinson
+ * @author Clyde Stubbs
  */
 public class ResponseCookiesSnippetTests extends AbstractSnippetTests {