--- a/javauis/mmapi_qt/baseline/javasrc/com/nokia/microedition/media/animation/StopTimeControl.java	Fri May 14 15:47:24 2010 +0300
+++ b/javauis/mmapi_qt/baseline/javasrc/com/nokia/microedition/media/animation/StopTimeControl.java	Thu May 27 12:49:31 2010 +0300
@@ -1,5 +1,5 @@
 /*
-* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).
 * All rights reserved.
 * This component and the accompanying materials are made available
 * under the terms of "Eclipse Public License v1.0"
@@ -11,26 +11,26 @@
 *
 * Contributors:
 *
-* Description: 
+* Description: StopTimeControl
 *
 */
-/**
- * 
- */
+
 package com.nokia.microedition.media.animation;
 
 import javax.microedition.media.Player;
 
 import com.nokia.microedition.media.control.ControlImpl;
 
+
 /**
- * @author d35kumar
- *
+ * <code>StopTimeControl</code> allows one to specify a preset stop time for
+ * a <code>Player</code>.
+ * <p>
  */
 public class StopTimeControl extends ControlImpl implements
 		javax.microedition.media.control.StopTimeControl {
 
-	long iStopTime=RESET;
+	private long iStopTime=RESET;
 	/**
 	 * 
 	 */
@@ -38,17 +38,57 @@
 		this.iPlayer=aPlayer;
 	}
 
-	/* (non-Javadoc)
-	 * @see javax.microedition.media.control.StopTimeControl#getStopTime()
-	 */
+	/**
+     * Gets the last value successfully set by <CODE>setStopTime</CODE>.
+     *
+     * Returns the constant <CODE>RESET</CODE> if no stop time is set.
+     * This is the default.
+     *
+     * @return The current stop time in microseconds.
+     * @see #setStopTime
+     */
 	public long getStopTime() {
 		 checkState();
 		return iStopTime;
 	}
 
-	/* (non-Javadoc)
-	 * @see javax.microedition.media.control.StopTimeControl#setStopTime(long)
-	 */
+	 /**
+    *
+    * Sets the <i>media time</i> at which you want the <code>Player</code>
+    * to stop.
+    * The <code>Player</code> will stop when its <i>media time</i>
+    * reaches the stop-time.
+    * A <code>STOPPED_AT_TIME</code> event
+    * will be delivered through the <code>PlayerListener</code>.
+    * <p>
+    * The <code>Player</code> is guaranteed
+    * to stop within one second past the preset stop-time
+    * (i.e. <code>stop-time <= current-media-time <= stop-time + 1 sec.</code>);
+    * unless the current media time is already passed the preset stop time
+    * when the stop time is set.
+    * If the current media time is already past the stop time set,
+    * the <code>Player</code> will stop immediately.  A
+    * <code>STOPPED_AT_TIME</code> event will be delivered.
+    * After the <code>Player</code> stops due to the stop-time set,
+    * the previously set stop-time will be cleared automatically.
+    * Alternatively, the stop time can be explicitly removed by
+    * setting it to: <code>RESET</code>.
+    * <p>
+    *
+    * You can always call <code>setStopTime</code> on a stopped
+    * <code>Player</code>.
+    * To avoid a potential race condition, it is illegal to
+    * call <code>setStopTime</code> on a started <code>Player</code> if a
+    * <i>media stop-time</i> has already been set.
+    *
+    * @param aStopTime The time in microseconds at which you want the
+    * <code>Player</code> to stop, in <i>media time</i>.
+    * @exception IllegalStateException Thrown if
+    * <code>aStopTime</code> is called on a started
+    * <code>Player</code> and the
+    * <i>media stop-time</i> has already been set.
+    * @see #getStopTime
+    */
 	public void setStopTime(long aStopTime) {
 		checkState();
 		if (iPlayer.getState() == Player.STARTED && getStopTime() != RESET) {
@@ -56,5 +96,6 @@
 					"Player is STARTED or setStopTime() is already called successfully");
 		}
 		iStopTime = aStopTime;
+		((AnimationPlayer)iPlayer).setiStopTime(iStopTime);
 	}
 }