#88408# Adapted to improved XCommandProcessor2.

2 files changed, 25 insertions, 5 deletions

diff --git a/offapi/com/sun/star/ucb/Content.idl b/offapi/com/sun/star/ucb/Content.idl
index 776f38ae86a4..e11057117b06 100644
--- a/offapi/com/sun/star/ucb/Content.idl
+++ b/offapi/com/sun/star/ucb/Content.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: Content.idl,v $
  *
- *  $Revision: 1.15 $
+ *  $Revision: 1.16 $
  *
- *  last change: $Author: kso $ $Date: 2001-07-06 09:49:55 $
+ *  last change: $Author: sb $ $Date: 2001-08-20 15:32:12 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -143,6 +143,10 @@ service Content
     //-------------------------------------------------------------------------
     /** enables the caller to let the content execute commands.
 
+        <p>It is strongly recommended that any implementation supports the
+        improved <type>com::sun::star::ucb::XCommandProcessor2</type>
+        interface.</p>
+
         <p>Typical commands are "open", "delete", "getPropertyValues" and
         "setPropertyValues". Each content must support a set of standard
         commands and properties. Also there is a set of predefined optionally
diff --git a/offapi/com/sun/star/ucb/XCommandProcessor.idl b/offapi/com/sun/star/ucb/XCommandProcessor.idl
index c673c2fb160d..be24f4b448cd 100644
--- a/offapi/com/sun/star/ucb/XCommandProcessor.idl
+++ b/offapi/com/sun/star/ucb/XCommandProcessor.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: XCommandProcessor.idl,v $
  *
- *  $Revision: 1.6 $
+ *  $Revision: 1.7 $
  *
- *  last change: $Author: jsc $ $Date: 2001-03-16 16:41:48 $
+ *  last change: $Author: sb $ $Date: 2001-08-20 15:32:40 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -88,6 +88,11 @@ module com { module sun { module star { module ucb {
 
     @version  1.0
     @author   Kai Sommerfeld
+
+    @deprecated
+    @see com::sun::star::ucb::XCommandProcessor2
+    for the improved version of this interface.
+
     @see      Command
     @see      XCommandEnvironment
     @see      XContent
@@ -103,7 +108,18 @@ interface XCommandProcessor : com::sun::star::uno::XInterface
         executed synchronously. So the id for a command is valid again after a
         command previously associated with this id has finished. In fact you
         only should get one identifier per thread and assign it to every
-        command executed by that thread.
+        command executed by that thread.</p>
+
+        <p>Also, after a call to <method>abort</method>, an identifier should
+        not be used any longer (and instead be released by a call to
+        <method scope="com::sun::star::ucb::XCommandProcessor2">releaseCommandIdentifier</method>),
+        because it may well abort <em>all</em> further calls to
+        <method>execute</method>.</p>
+
+        <p>To avoid ever-increasing resource consumption, the identifier
+        should be released via
+        <method scope="com::sun::star::ucb::XCommandProcessor2">releaseCommandIdentifier</method>
+        when it is no longer used.</p>
 
         @returns
         a command identifier.