From fba32991e7c4672231115de4a5f53469806050a2 Mon Sep 17 00:00:00 2001
From: markt <markt@13f79535-47bb-0310-9956-ffa450edef68>
Date: Wed, 9 Feb 2011 18:25:48 +0000
Subject: [PATCH] Better comments

git-svn-id: https://svn.apache.org/repos/asf/tomcat/trunk@1069016 13f79535-47bb-0310-9956-ffa450edef68
---
 java/org/apache/catalina/util/LifecycleBase.java | 20 ++++++--------------
 1 file changed, 6 insertions(+), 14 deletions(-)

diff --git a/java/org/apache/catalina/util/LifecycleBase.java b/java/org/apache/catalina/util/LifecycleBase.java
index bfe725dd0..bc5f4aa7b 100644
--- a/java/org/apache/catalina/util/LifecycleBase.java
+++ b/java/org/apache/catalina/util/LifecycleBase.java
@@ -164,13 +164,9 @@ public abstract class LifecycleBase implements Lifecycle {
 
 
     /**
-     * Sub-classes must ensure that:
-     * <ul>
-     * <li>the {@link Lifecycle#START_EVENT} is fired during the execution of
-     *     this method</li>
-     * <li>the state is changed to {@link LifecycleState#STARTING} when the
-     *     {@link Lifecycle#START_EVENT} is fired
-     * </ul>
+     * Sub-classes must ensure that the state is changed to
+     * {@link LifecycleState#STARTING} during the execution of this method.
+     * Changing state will trigger the {@link Lifecycle#START_EVENT} event.
      * 
      * If a component fails to start it may either throw a
      * {@link LifecycleException} which will cause it's parent to fail to start
@@ -243,13 +239,9 @@ public abstract class LifecycleBase implements Lifecycle {
 
 
     /**
-     * Sub-classes must ensure that:
-     * <ul>
-     * <li>the {@link Lifecycle#STOP_EVENT} is fired during the execution of
-     *     this method</li>
-     * <li>the state is changed to {@link LifecycleState#STOPPING} when the
-     *     {@link Lifecycle#STOP_EVENT} is fired
-     * </ul>
+     * Sub-classes must ensure that the state is changed to
+     * {@link LifecycleState#STOPPING} during the execution of this method.
+     * Changing state will trigger the {@link Lifecycle#STOP_EVENT} event.
      * 
      * @throws LifecycleException
      */
-- 
2.11.0