Polishing test annotation declarations and JavaDoc.

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@1747 50f2f4bb-b051-0410-bef5-90022cba6387

org.springframework.test/src/main/java/org/springframework/test/annotation/DirtiesContext.java

@@ -53,9 +53,9 @@ import java.lang.annotation.Target;
  * @author Rod Johnson
  * @since 2.0
  */
-@Target( { ElementType.TYPE, ElementType.METHOD })
-@Retention(RetentionPolicy.RUNTIME)
 @Documented
+@Retention(RetentionPolicy.RUNTIME)
+@Target( { ElementType.TYPE, ElementType.METHOD })
 public @interface DirtiesContext {
 
 	/**

org.springframework.test/src/main/java/org/springframework/test/annotation/ExpectedException.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2007 the original author or authors.
+ * Copyright 2002-2009 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.
@@ -30,9 +30,9 @@ import java.lang.annotation.Target;
  * @author Sam Brannen
  * @since 2.0
  */
-@Target( { ElementType.METHOD })
-@Retention(RetentionPolicy.RUNTIME)
 @Documented
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
 public @interface ExpectedException {
 
 	Class<? extends Throwable> value();

org.springframework.test/src/main/java/org/springframework/test/annotation/IfProfileValue.java

@@ -72,10 +72,10 @@ import java.lang.annotation.Target;
  * @see org.springframework.test.context.junit4.AbstractJUnit4SpringContextTests
  * @see org.springframework.test.context.junit4.SpringJUnit4ClassRunner
  */
-@Target( { ElementType.TYPE, ElementType.METHOD })
-@Retention(RetentionPolicy.RUNTIME)
-@Inherited
 @Documented
+@Inherited
+@Retention(RetentionPolicy.RUNTIME)
+@Target( { ElementType.TYPE, ElementType.METHOD })
 public @interface IfProfileValue {
 
 	/**

org.springframework.test/src/main/java/org/springframework/test/annotation/NotTransactional.java

@@ -29,9 +29,8 @@ import java.lang.annotation.Target;
  * @author Sam Brannen
  * @since 2.0
  */
-@Target( { ElementType.METHOD })
-@Retention(RetentionPolicy.RUNTIME)
 @Documented
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
 public @interface NotTransactional {
-
 }

org.springframework.test/src/main/java/org/springframework/test/annotation/ProfileValueSourceConfiguration.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2007 the original author or authors.
+ * Copyright 2002-2009 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,8 +27,8 @@ import java.lang.annotation.Target;
  * <p>
  * ProfileValueSourceConfiguration is a class-level annotation which is used to
  * specify what type of {@link ProfileValueSource} to use when retrieving
- * <em>profile values</em> configured via the
- * {@link IfProfileValue @IfProfileValue} annotation.
+ * <em>profile values</em> configured via the {@link IfProfileValue
+ * &#064;IfProfileValue} annotation.
  * </p>
  * 
  * @author Sam Brannen
@@ -37,10 +37,10 @@ import java.lang.annotation.Target;
  * @see IfProfileValue
  * @see ProfileValueUtils
  */
+@Documented
+@Inherited
 @Retention(RetentionPolicy.RUNTIME)
 @Target(ElementType.TYPE)
-@Inherited
-@Documented
 public @interface ProfileValueSourceConfiguration {
 
 	/**

org.springframework.test/src/main/java/org/springframework/test/annotation/Repeat.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2008 the original author or authors.
+ * Copyright 2002-2009 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.
@@ -26,16 +26,16 @@ import java.lang.annotation.Target;
  * Test annotation to indicate that a test method should be invoked repeatedly.
  * <p />
  * Note that the scope of execution to be repeated includes execution of the
- * test method itself as well as any <em>set up</em> or <em>tear down</em>
- * of the test fixture.
+ * test method itself as well as any <em>set up</em> or <em>tear down</em> of
+ * the test fixture.
  * 
  * @author Rod Johnson
  * @author Sam Brannen
  * @since 2.0
  */
-@Target( { ElementType.METHOD })
-@Retention(RetentionPolicy.RUNTIME)
 @Documented
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
 public @interface Repeat {
 
 	int value() default 1;

org.springframework.test/src/main/java/org/springframework/test/annotation/Rollback.java

@@ -31,9 +31,9 @@ import java.lang.annotation.Target;
  * @author Sam Brannen
  * @since 2.5
  */
-@Target({ElementType.METHOD})
-@Retention(RetentionPolicy.RUNTIME)
 @Documented
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
 public @interface Rollback {
 
 	/**

org.springframework.test/src/main/java/org/springframework/test/annotation/Timed.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2008 the original author or authors.
+ * Copyright 2002-2009 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.
@@ -43,9 +43,9 @@ import java.lang.annotation.Target;
  * @see Repeat
  * @see AbstractAnnotationAwareTransactionalTests
  */
-@Target({ElementType.METHOD})
-@Retention(RetentionPolicy.RUNTIME)
 @Documented
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
 public @interface Timed {
 
 	/**

org.springframework.test/src/main/java/org/springframework/test/context/ContextConfiguration.java

@@ -33,10 +33,10 @@ import java.lang.annotation.Target;
  * @see ContextLoader
  * @see org.springframework.context.ApplicationContext
  */
+@Documented
+@Inherited
 @Retention(RetentionPolicy.RUNTIME)
 @Target(ElementType.TYPE)
-@Inherited
-@Documented
 public @interface ContextConfiguration {
 
 	/**

org.springframework.test/src/main/java/org/springframework/test/context/TestExecutionListeners.java

@@ -36,10 +36,10 @@ import java.lang.annotation.Target;
  * @see TestContextManager
  * @see ContextConfiguration
  */
+@Documented
+@Inherited
 @Retention(RetentionPolicy.RUNTIME)
 @Target(ElementType.TYPE)
-@Inherited
-@Documented
 public @interface TestExecutionListeners {
 
 	/**

org.springframework.test/src/main/java/org/springframework/test/context/transaction/AfterTransaction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2007 the original author or authors.
+ * Copyright 2002-2009 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.
@@ -38,9 +38,8 @@ import java.lang.annotation.Target;
  * @since 2.5
  * @see org.springframework.transaction.annotation.Transactional
  */
-@Target( { ElementType.METHOD })
-@Retention(RetentionPolicy.RUNTIME)
 @Documented
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
 public @interface AfterTransaction {
-
 }

org.springframework.test/src/main/java/org/springframework/test/context/transaction/BeforeTransaction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2007 the original author or authors.
+ * Copyright 2002-2009 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.
@@ -38,9 +38,8 @@ import java.lang.annotation.Target;
  * @since 2.5
  * @see org.springframework.transaction.annotation.Transactional
  */
-@Target( { ElementType.METHOD })
-@Retention(RetentionPolicy.RUNTIME)
 @Documented
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
 public @interface BeforeTransaction {
-
 }

org.springframework.test/src/main/java/org/springframework/test/context/transaction/TransactionConfiguration.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2008 the original author or authors.
+ * Copyright 2002-2009 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.
@@ -35,10 +35,10 @@ import org.springframework.transaction.PlatformTransactionManager;
  * @see ContextConfiguration
  * @see TransactionalTestExecutionListener
  */
+@Documented
+@Inherited
 @Retention(RetentionPolicy.RUNTIME)
 @Target(ElementType.TYPE)
-@Inherited
-@Documented
 public @interface TransactionConfiguration {
 
 	/**