From 0b054f9fbd1e0fd818e62fcc8de05b2150814ee2 Mon Sep 17 00:00:00 2001
From: Sam Brannen <sam@sambrannen.com>
Date: Sat, 18 Apr 2015 23:45:34 +0200
Subject: [PATCH] Improve Javadoc for TestContextBootstrapper

---
 .../test/context/TestContextBootstrapper.java | 23 +++++++++++++------
 1 file changed, 16 insertions(+), 7 deletions(-)

diff --git a/spring-test/src/main/java/org/springframework/test/context/TestContextBootstrapper.java b/spring-test/src/main/java/org/springframework/test/context/TestContextBootstrapper.java
index ae81c9ec4a..d33c3db8da 100644
--- a/spring-test/src/main/java/org/springframework/test/context/TestContextBootstrapper.java
+++ b/spring-test/src/main/java/org/springframework/test/context/TestContextBootstrapper.java
@@ -19,19 +19,28 @@ package org.springframework.test.context;
 import java.util.List;
 
 /**
- * {@code TestContextBootstrapper} defines a strategy SPI for bootstrapping the
+ * {@code TestContextBootstrapper} defines the SPI for bootstrapping the
  * <em>Spring TestContext Framework</em>.
  *
- * <p>A custom bootstrapping strategy can be configured for a test class via
- * {@link BootstrapWith @BootstrapWith}, either directly or as a meta-annotation.
- * See {@link org.springframework.test.context.web.WebAppConfiguration @WebAppConfiguration}
- * for an example.
- *
- * <p>The {@link TestContextManager} uses a {@code TestContextBootstrapper} to
+ * <p>A {@code TestContextBootstrapper} is used by the {@link TestContextManager} to
  * {@linkplain #getTestExecutionListeners get the TestExecutionListeners} for the
  * current test and to {@linkplain #buildTestContext build the TestContext} that
  * it manages.
  *
+ * <h3>Configuration</h3>
+ *
+ * <p>A custom bootstrapping strategy can be configured for a test class (or
+ * test class hierarchy) via {@link BootstrapWith @BootstrapWith}, either
+ * directly or as a meta-annotation. See
+ * {@link org.springframework.test.context.web.WebAppConfiguration @WebAppConfiguration}
+ * for an example.
+ *
+ * <p>If a bootstrapper is not explicitly configured via {@code @BootstrapWith}, the
+ * {@link org.springframework.test.context.support.DefaultTestContextBootstrapper DefaultTestContextBootstrapper}
+ * will be used.
+ *
+ * <h3>Implementation Notes</h3>
+ *
  * <p>Concrete implementations must provide a {@code public} no-args constructor.
  *
  * <p><strong>WARNING</strong>: this SPI will likely change in the future in