Document Lifecycle#stop concurrency semantics

Issue: SPR-8570

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

org.springframework.context/src/main/java/org/springframework/context/Lifecycle.java

@@ -55,10 +55,14 @@ public interface Lifecycle {
 	void start();
 
 	/**
-	 * Stop this component.
-	 * Should not throw an exception if the component isn't started yet.
+	 * Stop this component, typically in a synchronous fashion, such that
+	 * the component is fully stopped upon return of this method. Consider
+	 * implementing {@link SmartLifecycle} and its {@code stop(Runnable)}
+	 * variant in cases where asynchronous stop behavior is necessary.
+	 * <p>Should not throw an exception if the component isn't started yet.
 	 * <p>In the case of a container, this will propagate the stop signal
 	 * to all components that apply.
+	 * @see SmartLifecycle#stop(Runnable)
 	 */
 	void stop();