Index: apichanges.xml
===================================================================
RCS file: /cvs/openide/api/doc/changes/apichanges.xml,v
retrieving revision 1.228
diff -u -r1.228 apichanges.xml
--- apichanges.xml	9 Nov 2004 21:00:51 -0000	1.228
+++ apichanges.xml	16 Nov 2004 14:56:16 -0000
@@ -114,6 +114,31 @@
 
 <!-- ACTUAL CHANGES BEGIN HERE: -->
 <changes>
+    <change id="TC-requestAttention">
+      <api name="winsys"/>
+      <summary>TopComponent can request attention</summary>
+      <version major="5" minor="1"/>
+      <date day="17" month="11" year="2004"/>
+      <author login="mkleint"/>
+      <compatibility addition="yes" binary="compatible" semantic="compatible" />
+      <description>
+        <p><code>TopComponent.requestAttention(boolean)</code> and <code>TopComponent.cancelRequestAttention</code>
+        added to allow components to signal that they require user's attention or the attention is no longer required.
+        It's up to the current TopComponent container to decide how to attract user's attention.
+        If the user activates the attention-requiring component, the container assumes the goal was achieved and the action is cancelled.
+        The methods are thread-safe.
+        </p>
+        <p>
+        For those implementing WindowManager class, there is an incompatible change where 
+        abstract methods <code>topComponentCancelRequestAttention(TopComponent)</code> and 
+        <code>topComponentRequestAttention(TopComponent)</code> were added.
+        </p>
+      </description>
+      <class package="org.openide.windows" name="WindowManager"/>
+      <class package="org.openide.windows" name="TopComponent"/>
+      <issue number="48811" />
+    </change>
+
     <change id="Task-waitFinished-timeout">
       <api name="util"/>
       <summary>New method <code>task.waitFinished(timeout)</code> added</summary>