#94968# IDL reviews merged

8 files changed, 197 insertions, 352 deletions

diff --git a/offapi/com/sun/star/plugin/PluginDescription.idl b/offapi/com/sun/star/plugin/PluginDescription.idl
index 748108eb69c9..f62f53e858b5 100644
--- a/offapi/com/sun/star/plugin/PluginDescription.idl
+++ b/offapi/com/sun/star/plugin/PluginDescription.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: PluginDescription.idl,v $
  *
- *  $Revision: 1.4 $
+ *  $Revision: 1.5 $
  *
- *  last change: $Author: mi $ $Date: 2001-11-15 16:24:08 $
+ *  last change: $Author: mi $ $Date: 2002-10-03 13:06:18 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -68,67 +68,23 @@
 
 //=============================================================================
 
-// DocMerge from xml: struct com::sun::star::plugin::PluginDescription
-/** is a handle for one specific plugin shared object.
-
-    <p>If there are multiple mimetypes and/or extensions, multiple
-    <type>PluginDescription</type> objects will be created.</p>
- */
+/** Describes a specific plugin.  If there are multiple mimetypes and/or
+    extensions, multiple <type>PluginDescription</type>s will be created.
+*/
 struct PluginDescription
 {
-    // DocMerge from xml: field com::sun::star::plugin::PluginDescription::PluginName
-    /** contains the plugin name (usually the shared object file name).
-     */
+    /** the plugin's name (usually the shared object file name) */
     string PluginName;
-
-    //-------------------------------------------------------------------------
-
-    // DocMerge from xml: field com::sun::star::plugin::PluginDescription::Mimetype
-    /** contains one mimetype for which this plugin should be registered.
-     */
+    /** a mimetype for which this plugin should be registered */
     string Mimetype;
-
-    //-------------------------------------------------------------------------
-
-    // DocMerge from xml: field com::sun::star::plugin::PluginDescription::Extension
-    /** contains the file extension for files of this type.
-     */
+    /** the file extension for files the plugin can handle */
     string Extension;
-
-    //-------------------------------------------------------------------------
-
-    // DocMerge from xml: field com::sun::star::plugin::PluginDescription::Description
-    /** contains a text description of the plugin.
-     */
+    /** text description of the plugin */
     string Description;
-
 };
 
 //=============================================================================
 
 }; }; }; };
 
-/*=============================================================================
-
-    $Log: not supported by cvs2svn $
-    Revision 1.3  2000/11/08 12:43:27  mi
-    moved from api
-
-    Revision 1.1.1.1  2000/09/18 23:35:28  hjs
-    initial import
-
-    Revision 1.5  2000/09/11 11:52:34  mi
-    documentation merged from XML
-
-    Revision 1.3  2000/02/21 16:18:02  mi
-    string documentation from stardiv...*.idl-files
-
-    Revision 1.2  2000/02/07 11:24:41  mi
-    zu #70728# missing documentation marked
-
-    Revision 1.1.1.1  1999/11/11 09:48:44  jsc
-    new
-
-
-=============================================================================*/
 #endif
diff --git a/offapi/com/sun/star/plugin/PluginException.idl b/offapi/com/sun/star/plugin/PluginException.idl
index 751d44256785..6ce26c3eb656 100644
--- a/offapi/com/sun/star/plugin/PluginException.idl
+++ b/offapi/com/sun/star/plugin/PluginException.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: PluginException.idl,v $
  *
- *  $Revision: 1.3 $
+ *  $Revision: 1.4 $
  *
- *  last change: $Author: mi $ $Date: 2000-11-08 12:43:27 $
+ *  last change: $Author: mi $ $Date: 2002-10-03 13:06:18 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -72,38 +72,20 @@
 
 //=============================================================================
 
-// DocMerge from xml: exception com::sun::star::plugin::PluginException
-/** indicates that an error occured in an NPN or NPP function call.@see XPlugin
-        @see XPluginContext
-        @see XPluginManager
- */
+/** Indicates that an error occured in an NPN or NPP function call.
+
+    @see XPlugin
+    @see XPluginContext
+    @see XPluginManager
+*/
 exception PluginException: com::sun::star::uno::Exception
 {
-    //-------------------------------------------------------------------------
-
-    // DocMerge from xml: field com::sun::star::plugin::PluginException::ErrorCode
-    /** contains the original Netscape error code.
-     */
+    /** original Netscape plugin error code */
     short ErrorCode;
-
 };
 
 //=============================================================================
 
 }; }; }; };
 
-/*=============================================================================
-
-    $Log: not supported by cvs2svn $
-    Revision 1.1.1.1  2000/09/18 23:35:29  hjs
-    initial import
-
-    Revision 1.3  2000/09/11 11:52:34  mi
-    documentation merged from XML
-
-    Revision 1.1.1.1  1999/11/11 09:48:44  jsc
-    new
-
-
-=============================================================================*/
 #endif
diff --git a/offapi/com/sun/star/plugin/PluginManager.idl b/offapi/com/sun/star/plugin/PluginManager.idl
index 9a0539054acf..4d780cec06b3 100644
--- a/offapi/com/sun/star/plugin/PluginManager.idl
+++ b/offapi/com/sun/star/plugin/PluginManager.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: PluginManager.idl,v $
  *
- *  $Revision: 1.3 $
+ *  $Revision: 1.4 $
  *
- *  last change: $Author: mi $ $Date: 2000-11-08 12:43:27 $
+ *  last change: $Author: mi $ $Date: 2002-10-03 13:06:18 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -72,32 +72,15 @@
 
 //=============================================================================
 
-// DocMerge from xml: service com::sun::star::plugin::PluginManager
-/** makes it possible to create plugins.
- */
+/** This service manages all recognized Netscape plugins.
+*/
 service PluginManager
 {
-    // DocMerge: empty anyway
     interface com::sun::star::plugin::XPluginManager;
-
 };
 
 //=============================================================================
 
 }; }; }; };
 
-/*=============================================================================
-
-    $Log: not supported by cvs2svn $
-    Revision 1.1.1.1  2000/09/18 23:35:29  hjs
-    initial import
-
-    Revision 1.3  2000/09/11 11:52:34  mi
-    documentation merged from XML
-
-    Revision 1.1.1.1  1999/11/11 09:48:44  jsc
-    new
-
-
-=============================================================================*/
 #endif
diff --git a/offapi/com/sun/star/plugin/PluginMode.idl b/offapi/com/sun/star/plugin/PluginMode.idl
index f31084541708..faf3ceca7211 100644
--- a/offapi/com/sun/star/plugin/PluginMode.idl
+++ b/offapi/com/sun/star/plugin/PluginMode.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: PluginMode.idl,v $
  *
- *  $Revision: 1.3 $
+ *  $Revision: 1.4 $
  *
- *  last change: $Author: mi $ $Date: 2000-11-08 12:43:27 $
+ *  last change: $Author: mi $ $Date: 2002-10-03 13:06:18 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -68,42 +68,16 @@
 
 //=============================================================================
 
-// DocMerge: empty anyway
 constants PluginMode
 {
-    //-------------------------------------------------------------------------
-    // DOCUMENTATION MISSING FOR constants::1
-
-    // DocMerge: empty anyway
+    /** embedded into document */
     const short EMBED = 1;
-
-    //-------------------------------------------------------------------------
-    // DOCUMENTATION MISSING FOR constants::2
-
-    // DocMerge: empty anyway
+    /** full size */
     const short FULL = 2;
-
 };
 
 //=============================================================================
 
 }; }; }; };
 
-/*=============================================================================
-
-    $Log: not supported by cvs2svn $
-    Revision 1.1.1.1  2000/09/18 23:35:29  hjs
-    initial import
-
-    Revision 1.4  2000/09/11 11:52:34  mi
-    documentation merged from XML
-
-    Revision 1.2  2000/02/07 11:24:42  mi
-    zu #70728# missing documentation marked
-
-    Revision 1.1.1.1  1999/11/11 09:48:44  jsc
-    new
-
-
-=============================================================================*/
 #endif
diff --git a/offapi/com/sun/star/plugin/PluginVariable.idl b/offapi/com/sun/star/plugin/PluginVariable.idl
index 126ae17605a5..31f9f610292f 100644
--- a/offapi/com/sun/star/plugin/PluginVariable.idl
+++ b/offapi/com/sun/star/plugin/PluginVariable.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: PluginVariable.idl,v $
  *
- *  $Revision: 1.4 $
+ *  $Revision: 1.5 $
  *
- *  last change: $Author: mi $ $Date: 2001-11-15 16:24:08 $
+ *  last change: $Author: mi $ $Date: 2002-10-03 13:06:19 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -68,57 +68,24 @@
 
 //=============================================================================
 
-// DocMerge from xml: enum com::sun::star::plugin::PluginVariable
-/** describes the possible parameters to XPluginContext::getValue.
-    It describes what kind of object is requested
- */
+/** Describes the possible parameters to XPluginContext::getValue.
+    It describes what kind of object is requested.
+*/
 enum PluginVariable
 {
-    //-------------------------------------------------------------------------
-    // DOCUMENTATION CHANGED FOR PluginVariable::   VxDisplay,
-
-    // DocMerge from xml: value com::sun::star::plugin::PluginVariable::VxDisplay
-    /** XPluginContext::getValue will return the Xwindow Display pointer of
+    /** XPluginContext::getValue will return the XWindow display pointer of
         a display connection (UNIX only)
-     */
+    */
     VxDisplay,
 
-    //-------------------------------------------------------------------------
-    // DOCUMENTATION CHANGED FOR PluginVariable::   VxtAppContext
-
-    // DocMerge from xml: value com::sun::star::plugin::PluginVariable::VxtAppContext
     /** XPluginContext::getValue will return the global Xt application context
         (UNIX only)
-     */
+    */
     VxtAppContext
-
 };
 
 //=============================================================================
 
 }; }; }; };
 
-/*=============================================================================
-
-    $Log: not supported by cvs2svn $
-    Revision 1.3  2000/11/08 12:43:27  mi
-    moved from api
-
-    Revision 1.1.1.1  2000/09/18 23:35:29  hjs
-    initial import
-
-    Revision 1.5  2000/09/11 11:52:35  mi
-    documentation merged from XML
-
-    Revision 1.3  2000/03/17 13:15:29  pl
-    #74035# documentation
-
-    Revision 1.2  2000/02/07 11:24:42  mi
-    zu #70728# missing documentation marked
-
-    Revision 1.1.1.1  1999/11/11 09:48:44  jsc
-    new
-
-
-=============================================================================*/
 #endif
diff --git a/offapi/com/sun/star/plugin/XPlugin.idl b/offapi/com/sun/star/plugin/XPlugin.idl
index e28338e8af45..a9785a5481d6 100644
--- a/offapi/com/sun/star/plugin/XPlugin.idl
+++ b/offapi/com/sun/star/plugin/XPlugin.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: XPlugin.idl,v $
  *
- *  $Revision: 1.5 $
+ *  $Revision: 1.6 $
  *
- *  last change: $Author: mi $ $Date: 2001-11-15 16:24:08 $
+ *  last change: $Author: mi $ $Date: 2002-10-03 13:06:19 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -80,16 +80,26 @@
 
 //=============================================================================
 
-// DocMerge from xml: interface com::sun::star::plugin::XPlugin
-/** allows the container to control the plugin.
- */
+/** This interface allows the container, e.g. document to control the plugin.
+*/
 interface XPlugin: com::sun::star::uno::XInterface
 {
-    //-------------------------------------------------------------------------
-
-    // DocMerge from xml: method com::sun::star::plugin::XPlugin::provideNewStream
-    /** tells the plugin instance that a new stream is requested.
-     */
+    /** Tells the plugin instance that a new stream is requested.
+
+        @param mimetype
+               mime type of provided data
+        @param aSource
+               data source
+        @param url
+               url
+        @param length
+               number of bytes (if file)
+        @param lastmodified
+               time stamp of last modification (if file)
+        @param isfile
+               whether data comes from a file
+        @return true upon success
+    */
     boolean provideNewStream( [in] string mimetype,
              [in] com::sun::star::io::XActiveDataSource aSource,
              [in] string url,
@@ -97,31 +107,10 @@ interface XPlugin: com::sun::star::uno::XInterface
              [in] long lastmodified,
              [in] boolean isfile )
             raises( com::sun::star::plugin::PluginException );
-
 };
 
 //=============================================================================
 
 }; }; }; };
 
-/*=============================================================================
-
-    $Log: not supported by cvs2svn $
-    Revision 1.4  2001/03/16 16:41:31  jsc
-    remove interfaceheader with uik and remove [const] in method definitions
-
-    Revision 1.3  2000/11/08 12:43:27  mi
-    moved from api
-
-    Revision 1.1.1.1  2000/09/18 23:35:29  hjs
-    initial import
-
-    Revision 1.3  2000/09/11 11:52:35  mi
-    documentation merged from XML
-
-    Revision 1.1.1.1  1999/11/11 09:48:44  jsc
-    new
-
-
-=============================================================================*/
 #endif
diff --git a/offapi/com/sun/star/plugin/XPluginContext.idl b/offapi/com/sun/star/plugin/XPluginContext.idl
index 40df6fe64f78..bdd87a4991bb 100644
--- a/offapi/com/sun/star/plugin/XPluginContext.idl
+++ b/offapi/com/sun/star/plugin/XPluginContext.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: XPluginContext.idl,v $
  *
- *  $Revision: 1.5 $
+ *  $Revision: 1.6 $
  *
- *  last change: $Author: mi $ $Date: 2001-11-15 16:24:08 $
+ *  last change: $Author: mi $ $Date: 2002-10-03 13:06:19 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -92,52 +92,71 @@
 
 //=============================================================================
 
-// DocMerge from xml: interface com::sun::star::plugin::XPluginContext
-/** implements the calls a plugin library can make on its browser.
-
-    <p>A default context can be created by a <type>XPluginManager</type>.
-
-    </p>@see XPluginManager
- */
+/** Interface receiving calls from a plugin library.
+    A default context can be created using the <type>PluginManager</type>.
+*/
 interface XPluginContext: com::sun::star::uno::XInterface
 {
-    //-------------------------------------------------------------------------
-    // DOCUMENTATION CHANGED FOR XPluginContext::getValue
-
-    // DocMerge from xml: method com::sun::star::plugin::XPluginContext::getValue
-    /** requests global application parameters like display connection on UNIX systems
-     */
+    /** Requests global application parameters like display connection
+        on UNIX systems.
+
+        @param xPlugin
+               plugin
+        @param aVariable
+               variable
+        @return value
+    */
     string getValue( [in] com::sun::star::plugin::XPlugin xPlugin,
              [in] com::sun::star::plugin::PluginVariable aVariable )
             raises( com::sun::star::plugin::PluginException );
 
-    //-------------------------------------------------------------------------
-
-    // DocMerge from xml: method com::sun::star::plugin::XPluginContext::getURLNotify
-    /** requests a notification of completion of the operation on an URL.
-     */
+    /** Requests a notification of completion of the operation on an URL.
+
+        @param plugin
+               plugin
+        @param url
+               url
+        @param target
+               target frame
+        @param listener
+               event listener
+    */
     void getURLNotify( [in] com::sun::star::plugin::XPlugin plugin,
              [in] string url,
              [in] string target,
              [in] com::sun::star::lang::XEventListener listener )
             raises( com::sun::star::plugin::PluginException );
 
-    //-------------------------------------------------------------------------
+    /** Requests an URL to be loaded into the frame target.
 
-    // DocMerge from xml: method com::sun::star::plugin::XPluginContext::getURL
-    /** requests an URL to be loaded into the frame target.
-     */
+        @param plugin
+               plugin
+        @param url
+               url
+        @param target
+               target frame
+    */
     void getURL( [in] com::sun::star::plugin::XPlugin plugin,
              [in] string url,
              [in] string target )
             raises( com::sun::star::plugin::PluginException );
 
-    //-------------------------------------------------------------------------
-
-    // DocMerge from xml: method com::sun::star::plugin::XPluginContext::postURLNotify
-    /** posts data from a buffer or file to an URL and receives a
+    /** Posts data from a buffer or file to an URL and receives a
         notification upon completion.
-     */
+
+        @param plugin
+               plugin
+        @param url
+               url
+        @param target
+               target frame
+        @param buf
+               data
+        @param file
+               whether data is from file
+        @param listener
+               event listener
+    */
     void postURLNotify( [in] com::sun::star::plugin::XPlugin plugin,
              [in] string url,
              [in] string target,
@@ -146,11 +165,19 @@ interface XPluginContext: com::sun::star::uno::XInterface
              [in] com::sun::star::lang::XEventListener listener )
             raises( com::sun::star::plugin::PluginException );
 
-    //-------------------------------------------------------------------------
-
-    // DocMerge from xml: method com::sun::star::plugin::XPluginContext::postURL
-    /** posts data from a buffer or file to an URL.
-     */
+    /** Posts data from a buffer or file to an URL.
+
+        @param plugin
+               plugin
+        @param url
+               url
+        @param target
+               target frame
+        @param buf
+               data
+        @param file
+               whether data is from file
+    */
     void postURL( [in] com::sun::star::plugin::XPlugin plugin,
              [in] string url,
              [in] string target,
@@ -158,67 +185,48 @@ interface XPluginContext: com::sun::star::uno::XInterface
              [in] boolean file )
             raises( com::sun::star::plugin::PluginException );
 
-    //-------------------------------------------------------------------------
-
-    // DocMerge from xml: method com::sun::star::plugin::XPluginContext::newStream
-    /** requests a new stream that is created by the plugin and consumed
+    /** Requests a new stream that is created by the plugin and consumed
         by the browser.
-     */
+
+        @param plugin
+               plugin
+        @param mimetype
+               mime type
+        @param target
+               target frame
+        @param aSource
+               data source
+    */
     void newStream( [in] com::sun::star::plugin::XPlugin plugin,
              [in] string mimetype,
              [in] string target,
              [in] com::sun::star::io::XActiveDataSource aSource )
             raises( com::sun::star::plugin::PluginException );
 
-    //-------------------------------------------------------------------------
+    /** Displays a message in the browser status line.
 
-    // DocMerge from xml: method com::sun::star::plugin::XPluginContext::displayStatusText
-    /** displays a message in the browser status line.
-     */
+        @param plugin
+               plugin
+        @param message
+               message
+    */
     void displayStatusText( [in] com::sun::star::plugin::XPlugin plugin,
              [in] string message )
             raises( com::sun::star::plugin::PluginException );
 
-    //-------------------------------------------------------------------------
-    // DOCUMENTATION CHANGED FOR XPluginContext::getUserAgent
+    /** Returns an application dependent identification string.
+        This is the same string that is transmitted by a browser to an http server.
 
-    // DocMerge from xml: method com::sun::star::plugin::XPluginContext::getUserAgent
-    /** returns an application dependent identification string. This is
-        the same string that is transmitted by a browser to an http server.
-     */
+        @param plugin
+               plugin
+        @return id
+    */
     string getUserAgent( [in] com::sun::star::plugin::XPlugin plugin )
             raises( com::sun::star::plugin::PluginException );
-
 };
 
 //=============================================================================
 
 }; }; }; };
 
-/*=============================================================================
-
-    $Log: not supported by cvs2svn $
-    Revision 1.4  2001/03/16 16:41:31  jsc
-    remove interfaceheader with uik and remove [const] in method definitions
-
-    Revision 1.3  2000/11/08 12:43:27  mi
-    moved from api
-
-    Revision 1.1.1.1  2000/09/18 23:35:29  hjs
-    initial import
-
-    Revision 1.5  2000/09/11 11:52:35  mi
-    documentation merged from XML
-
-    Revision 1.3  2000/03/17 13:15:29  pl
-    #74035# documentation
-
-    Revision 1.2  2000/02/07 11:24:42  mi
-    zu #70728# missing documentation marked
-
-    Revision 1.1.1.1  1999/11/11 09:48:44  jsc
-    new
-
-
-=============================================================================*/
 #endif
diff --git a/offapi/com/sun/star/plugin/XPluginManager.idl b/offapi/com/sun/star/plugin/XPluginManager.idl
index 7c26b2df3195..04fe0ee977dc 100644
--- a/offapi/com/sun/star/plugin/XPluginManager.idl
+++ b/offapi/com/sun/star/plugin/XPluginManager.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: XPluginManager.idl,v $
  *
- *  $Revision: 1.5 $
+ *  $Revision: 1.6 $
  *
- *  last change: $Author: mi $ $Date: 2001-11-15 16:24:08 $
+ *  last change: $Author: mi $ $Date: 2002-10-03 13:06:20 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -96,59 +96,71 @@
 
 //=============================================================================
 
-// DocMerge from xml: interface com::sun::star::plugin::XPluginManager
-/** manages all plugin instances.
-
-    <p>Plugins can be created only from an <type>XPluginManager</type>.
-    It also creates <type>XPluginContext</type> objects,
-    which can be overloaded by aggregation.</p>
- */
+/** Interface accessing all recognized Netscape plugins.
+*/
 interface XPluginManager: com::sun::star::uno::XInterface
 {
-    //-------------------------------------------------------------------------
-
-    // DocMerge from xml: method com::sun::star::plugin::XPluginManager::createPluginContext
-    /** creates a default context.
-
-        <p>This context depends on the service
+    /** Creates a default context.  This context depends on the service
         <type scope="com::sun::star::frame">Desktop</type>.</p>
-     */
-    com::sun::star::plugin::XPluginContext createPluginContext();
 
-    //-------------------------------------------------------------------------
-
-    // DOCUMENTATION CHANGED FOR XPluginManager::getPluginDescriptions
+        @return plugin context
+    */
+    com::sun::star::plugin::XPluginContext createPluginContext();
 
+    /** Returns the descriptions for all recognized plugins.
 
-    // DocMerge from idl: method com::sun::star::plugin::XPluginManager::getPluginDescriptions
-    /** returns the descriptions for all available plugins.
-     */
+        @return plugin descriptions
+    */
     sequence<com::sun::star::plugin::PluginDescription> getPluginDescriptions();
 
-    //-------------------------------------------------------------------------
-
-    // DocMerge from xml: method com::sun::star::plugin::XPluginManager::createPlugin
-    /** creates a new plugin instance.
-     */
-    com::sun::star::plugin::XPlugin createPlugin( [in] com::sun::star::plugin::XPluginContext acontext,
-             [in] short mode,
-             [in] sequence<string> argn,
-             [in] sequence<string> argv,
-             [in] com::sun::star::plugin::PluginDescription plugintype )
-            raises( com::sun::star::plugin::PluginException );
-
-    //-------------------------------------------------------------------------
-
-    // DocMerge from xml: method com::sun::star::plugin::XPluginManager::createPluginFromURL
-    /** creates a new plugin instance.
-     */
-    com::sun::star::plugin::XPlugin createPluginFromURL( [in] com::sun::star::plugin::XPluginContext acontext,
-             [in] short mode,
-             [in] sequence<string> argn,
-             [in] sequence<string> argv,
-             [in] com::sun::star::awt::XToolkit toolkit,
-             [in] com::sun::star::awt::XWindowPeer parent,
-             [in] string url );
+    /** Creates a new plugin instance.
+
+        @param acontext
+               plugin context
+        @param mode
+               plugin mode
+        @param argn
+               argument name list provided to plugin
+        @param argv
+               argument value list provided to plugin
+        @param plugintype
+               plugin description
+        @return plugin instance
+    */
+    com::sun::star::plugin::XPlugin createPlugin(
+        [in] com::sun::star::plugin::XPluginContext acontext,
+        [in] short mode,
+        [in] sequence<string> argn,
+        [in] sequence<string> argv,
+        [in] com::sun::star::plugin::PluginDescription plugintype )
+        raises( com::sun::star::plugin::PluginException );
+
+    /** Creates a new plugin instance.
+
+        @param acontext
+               plugin context
+        @param mode
+               plugin mode
+        @param argn
+               argument name list provided to plugin
+        @param argv
+               argument value list provided to plugin
+        @param toolkit
+               toolkit to be used to get system window handle for plugin
+        @param parent
+               parent window
+        @param url
+               url
+        @return plugin instance
+    */
+    com::sun::star::plugin::XPlugin createPluginFromURL(
+        [in] com::sun::star::plugin::XPluginContext acontext,
+        [in] short mode,
+        [in] sequence<string> argn,
+        [in] sequence<string> argv,
+        [in] com::sun::star::awt::XToolkit toolkit,
+        [in] com::sun::star::awt::XWindowPeer parent,
+        [in] string url );
 
 };
 
@@ -156,30 +168,4 @@ interface XPluginManager: com::sun::star::uno::XInterface
 
 }; }; }; };
 
-/*=============================================================================
-
-    $Log: not supported by cvs2svn $
-    Revision 1.4  2001/03/16 16:41:31  jsc
-    remove interfaceheader with uik and remove [const] in method definitions
-
-    Revision 1.3  2000/11/08 12:43:27  mi
-    moved from api
-
-    Revision 1.1.1.1  2000/09/18 23:35:29  hjs
-    initial import
-
-    Revision 1.5  2000/09/11 11:52:35  mi
-    documentation merged from XML
-
-    Revision 1.3  2000/03/17 13:15:29  pl
-    #74035# documentation
-
-    Revision 1.2  2000/02/07 11:24:42  mi
-    zu #70728# missing documentation marked
-
-    Revision 1.1.1.1  1999/11/11 09:48:44  jsc
-    new
-
-
-=============================================================================*/
 #endif