Polishing

- Correct copyright years
- Add `@since` to javadoc of new public classes
- Make new classes final where appropriate

spring-restdocs-core/src/main/java/org/springframework/restdocs/ManualRestDocumentation.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-restdocs-core/src/main/java/org/springframework/restdocs/RestDocumentationContextProvider.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-restdocs-core/src/main/java/org/springframework/restdocs/cli/CliDocumentation.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -27,6 +27,7 @@ import org.springframework.restdocs.snippet.Snippet;
  * @author Andy Wilkinson
  * @author Paul-Christian Volkmer
  * @author Raman Gupta
+ * @since 1.1.0
  */
 public abstract class CliDocumentation {
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/cli/CliOperationRequest.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-restdocs-core/src/main/java/org/springframework/restdocs/cli/CurlRequestSnippet.java

@@ -39,6 +39,7 @@ import org.springframework.util.StringUtils;
  * @author Paul-Christian Volkmer
  * @see CliDocumentation#curlRequest()
  * @see CliDocumentation#curlRequest(Map)
+ * @since 1.1.0
  */
 public class CurlRequestSnippet extends TemplatedSnippet {
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/cli/HttpieRequestSnippet.java

@@ -40,6 +40,7 @@ import org.springframework.util.StringUtils;
  * @author Andy Wilkinson
  * @see CliDocumentation#httpieRequest()
  * @see CliDocumentation#httpieRequest(Map)
+ * @since 1.1.0
  */
 public class HttpieRequestSnippet extends TemplatedSnippet {
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/config/AbstractConfigurer.java

@@ -25,6 +25,7 @@ import org.springframework.restdocs.RestDocumentationContext;
  * configuration implementation.
  *
  * @author Andy Wilkinson
+ * @since 1.1.0
  */
 public abstract class AbstractConfigurer {
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/config/AbstractNestedConfigurer.java

@@ -21,6 +21,7 @@ package org.springframework.restdocs.config;
  *
  * @param <PARENT> The type of the configurer's parent
  * @author Andy Wilkinson
+ * @since 1.1.0
  */
 public abstract class AbstractNestedConfigurer<PARENT> extends AbstractConfigurer
 		implements NestedConfigurer<PARENT> {

spring-restdocs-core/src/main/java/org/springframework/restdocs/config/NestedConfigurer.java

@@ -21,6 +21,7 @@ package org.springframework.restdocs.config;
  *
  * @param <PARENT> The parent's type
  * @author Andy Wilkinson
+ * @since 1.1.0
  */
 interface NestedConfigurer<PARENT> {
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/config/RestDocumentationConfigurer.java

@@ -39,6 +39,7 @@ import org.springframework.restdocs.templates.mustache.MustacheTemplateEngine;
  * @param <T> The concrete type of this configurer, to be returned from methods that
  * support chaining
  * @author Andy Wilkinson
+ * @since 1.1.0
  */
 public abstract class RestDocumentationConfigurer<S extends AbstractConfigurer, T> {
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/config/SnippetConfiguration.java

@@ -22,6 +22,7 @@ import org.springframework.restdocs.templates.TemplateFormat;
  * An encapsulation of the configuration for documentation snippets.
  *
  * @author Andy Wilkinson
+ * @since 1.1.0
  */
 class SnippetConfiguration {
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/config/SnippetConfigurer.java

@@ -35,6 +35,7 @@ import org.springframework.restdocs.templates.TemplateFormats;
  * @param <PARENT> The type of the configurer's parent
  * @param <TYPE> The concrete type of the configurer to be returned from chained methods
  * @author Andy Wilkinson
+ * @since 1.1.0
  */
 public abstract class SnippetConfigurer<PARENT, TYPE>
 		extends AbstractNestedConfigurer<PARENT> {

spring-restdocs-core/src/main/java/org/springframework/restdocs/generate/RestDocumentationGenerationException.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -21,6 +21,7 @@ package org.springframework.restdocs.generate;
  * generation.
  *
  * @author Andy Wilkinson
+ * @since 1.1.0
  */
 public class RestDocumentationGenerationException extends RuntimeException {
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/generate/RestDocumentationGenerator.java

@@ -41,7 +41,7 @@ import org.springframework.util.Assert;
  * @param <REQ> the request type that can be handled
  * @param <RESP> the response type that can be handled
  * @author Andy Wilkinson
- * @since 1.1
+ * @since 1.1.0
  */
 public final class RestDocumentationGenerator<REQ, RESP> {
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/generate/package-info.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2014-2015 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -15,6 +15,6 @@
  */
 
 /**
- * Classes that drive the generation of the documentaiton snippets.
+ * Classes that drive the generation of the documentation snippets.
  */
 package org.springframework.restdocs.generate;

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -24,6 +24,7 @@ package org.springframework.restdocs.operation;
  * @author Andy Wilkinson
  * @see RequestConverter#convert(Object)
  * @see ResponseConverter#convert(Object)
+ * @since 1.1.0
  */
 public class ConversionException extends RuntimeException {
 

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -22,6 +22,7 @@ package org.springframework.restdocs.operation;
  *
  * @param <R> The implementation-specific request type
  * @author Andy Wilkinson
+ * @since 1.1.0
  */
 public interface RequestConverter<R> {
 

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -22,6 +22,7 @@ package org.springframework.restdocs.operation;
  *
  * @param <R> The implementation-specific response type
  * @author Andy Wilkinson
+ * @since 1.1.0
  */
 public interface ResponseConverter<R> {
 

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

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

@@ -23,6 +23,7 @@ import org.springframework.restdocs.snippet.IgnorableDescriptor;
  *
  * @author Andy Wilkinson
  * @see RequestDocumentation#partWithName
+ * @since 1.1.0
  */
 public class RequestPartDescriptor extends IgnorableDescriptor<RequestPartDescriptor> {
 

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

@@ -42,6 +42,7 @@ import org.springframework.util.Assert;
  * @see RequestDocumentation#requestParts(Map, RequestPartDescriptor...)
  * @see RequestDocumentation#relaxedRequestParts(RequestPartDescriptor...)
  * @see RequestDocumentation#relaxedRequestParts(Map, RequestPartDescriptor...)
+ * @since 1.1.0
  */
 public class RequestPartsSnippet extends TemplatedSnippet {
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/snippet/PlaceholderResolverFactory.java

@@ -23,7 +23,7 @@ import org.springframework.util.PropertyPlaceholderHelper.PlaceholderResolver;
  * A factory for creating {@link PlaceholderResolver} instances.
  *
  * @author Andy Wilkinson
- * @since 1.1
+ * @since 1.1.0
  */
 public interface PlaceholderResolverFactory {
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/snippet/RestDocumentationContextPlaceholderResolverFactory.java

@@ -24,7 +24,7 @@ import org.springframework.util.PropertyPlaceholderHelper.PlaceholderResolver;
  * {@link RestDocumentationContextPlaceholderResolver} instances.
  *
  * @author Andy Wilkinson
- * @since 1.1
+ * @since 1.1.0
  */
 public final class RestDocumentationContextPlaceholderResolverFactory
 		implements PlaceholderResolverFactory {

spring-restdocs-core/src/main/java/org/springframework/restdocs/templates/TemplateFormat.java

@@ -21,6 +21,7 @@ package org.springframework.restdocs.templates;
  * as Asciidoctor or Markdown.
  *
  * @author Andy Wilkinson
+ * @since 1.1.0
  */
 public interface TemplateFormat {
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/templates/TemplateFormats.java

@@ -20,6 +20,7 @@ package org.springframework.restdocs.templates;
  * An enumeration of the built-in formats for which templates are provuded.
  *
  * @author Andy Wilkinson
+ * @since 1.1.0
  */
 public abstract class TemplateFormats {
 

spring-restdocs-core/src/main/java/org/springframework/restdocs/templates/mustache/AsciidoctorTableCellContentLambda.java

@@ -27,6 +27,7 @@ import org.springframework.restdocs.mustache.Template.Fragment;
  * formatting.
  *
  * @author Andy Wilkinson
+ * @since 1.1.0
  */
 public final class AsciidoctorTableCellContentLambda implements Lambda {
 

spring-restdocs-core/src/test/java/org/springframework/restdocs/AbstractSnippetTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-restdocs-core/src/test/java/org/springframework/restdocs/RestDocumentationGeneratorTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-restdocs-core/src/test/java/org/springframework/restdocs/cli/QueryStringParserTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2015 the original author or authors.
+ * Copyright 2014-2015 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-restdocs-core/src/test/java/org/springframework/restdocs/headers/RequestHeadersSnippetFailureTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-restdocs-core/src/test/java/org/springframework/restdocs/headers/ResponseHeadersSnippetFailureTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-restdocs-core/src/test/java/org/springframework/restdocs/hypermedia/LinksSnippetFailureTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-restdocs-core/src/test/java/org/springframework/restdocs/operation/preprocess/ParametersModifyingOperationPreprocessorTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-restdocs-core/src/test/java/org/springframework/restdocs/payload/AsciidoctorRequestFieldsSnippetTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-restdocs-core/src/test/java/org/springframework/restdocs/payload/RequestFieldsSnippetFailureTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-restdocs-core/src/test/java/org/springframework/restdocs/payload/ResponseFieldsSnippetFailureTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-restdocs-core/src/test/java/org/springframework/restdocs/request/PathParametersSnippetFailureTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-restdocs-core/src/test/java/org/springframework/restdocs/request/RequestParametersSnippetFailureTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-restdocs-core/src/test/java/org/springframework/restdocs/request/RequestPartsSnippetFailureTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-restdocs-core/src/test/java/org/springframework/restdocs/snippet/TemplatedSnippetTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2016 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.