Fixup over-ambitious previous revert.

There were actually some useful bits hidden in that mass-publishing
of uno api.

offapi/com/sun/star/awt/XDialogProvider2.idl

@@ -120,12 +120,10 @@ interface XDialogProvider2 : ::com::sun::star::awt::XDialogProvider {
         </p>
     */
 
-    XDialog createDialogWithArguments(
-        [in] string URL,
-        [in] sequence< ::com::sun::star::beans::NamedValue > Arguments
-    )
-    raises  (   com::sun::star::lang::IllegalArgumentException
-            );
+    XDialog createDialogWithArguments
+        ( [in] string URL,
+          [in] sequence< ::com::sun::star::beans::NamedValue > Arguments )
+        raises  (   com::sun::star::lang::IllegalArgumentException );
 };
 
 //=============================================================================

offapi/com/sun/star/frame/XTitle.idl

@@ -36,17 +36,23 @@
  module com {  module sun {  module star {  module frame {
 
 //=============================================================================
-/** todo document me
+/** an interface representing an entity with a modifyable title.
  */
 interface XTitle : com::sun::star::uno::XInterface
 {
     //-------------------------------------------------------------------------
-    /** todo document me
+    /** Returns the title of the object.
+     *
+     * @returns
+     * The title.
      */
     string getTitle ();
 
     //-------------------------------------------------------------------------
-    /** todo document me
+    /** Sets the title of the object.
+     *
+     * @param sTitle
+     * The title.
      */
     void setTitle ( [in] string sTitle );
 };

offapi/com/sun/star/presentation/XSlideShowView.idl

@@ -68,9 +68,9 @@ interface XSlideShowView : ::com::sun::star::uno::XInterface
 
     /** Query the current transformation matrix for this view.<p>
 
-           This method returns the transformation matrix of the
-           view. When notified via the transformation change listener,
-           the show will be displayed using the new transformation.<p>
+        This method returns the transformation matrix of the
+        view. When notified via the transformation change listener,
+        the show will be displayed using the new transformation.<p>
 
         @return the view transformation matrix. Note that the slide
         show itself will paint all slides as one-by-one boxes, one

offapi/com/sun/star/rendering/XCanvas.idl

@@ -132,7 +132,7 @@ interface XCanvas : ::com::sun::star::uno::XInterface
 
      /** Draw a point in device resolution on the device.
 
-         @param aPoint
+        @param aPoint
         The point to draw.
 
         @param aViewState
@@ -153,10 +153,10 @@ interface XCanvas : ::com::sun::star::uno::XInterface
     /** Draw a line in device resolution width (i.e. one device pixel
         wide).
 
-         @param aStartPoint
+        @param aStartPoint
         The start point of the line to draw.
 
-         @param aEndPoint
+        @param aEndPoint
         The end point of the line to draw.
 
         @param aViewState

offapi/com/sun/star/rendering/XTextLayout.idl

@@ -86,7 +86,7 @@ interface XTextLayout : ::com::sun::star::uno::XInterface
     //-------------------------------------------------------------------------
 
     /** Query the ink bounding boxes for every glyph in the layouted
-         text.<p>
+        text.<p>
 
         Ink, or tight bounding boxes in this case means that for
         e.g. an "a", the bounding box for the

offapi/com/sun/star/text/GlobalDocument.idl

@@ -37,6 +37,8 @@
 //=============================================================================
 
 /** Specify the document service of the global text module.
+
+    @deprecated
  */
 service GlobalDocument
 {

offapi/com/sun/star/text/WebDocument.idl

@@ -37,6 +37,8 @@
 //=============================================================================
 
 /** Specify the document service of the web module.
+
+    @deprecated
  */
 service WebDocument
 {

offapi/com/sun/star/ucb/CertificateValidationRequest.idl

@@ -50,6 +50,9 @@ exception CertificateValidationRequest: com::sun::star::task::ClassifiedInteract
      */
     com::sun::star::security::XCertificate Certificate;
 
+    //-------------------------------------------------------------------------
+    /** The host name.
+     */
     string HostName;
 
 };

offapi/com/sun/star/xml/crypto/SEInitializer.idl

@@ -26,10 +26,6 @@
  *
  ************************************************************************/
 
-//i20156 - new file for xmlsecurity module
-
-/** -- idl definition -- **/
-
 #ifndef __com_sun_star_xml_crypto_seinitializer_idl_
 #define __com_sun_star_xml_crypto_seinitializer_idl_
 

offapi/com/sun/star/xml/crypto/XSEInitializer.idl

@@ -26,10 +26,6 @@
  *
  ************************************************************************/
 
-//i20156 - new file for xmlsecurity module
-
-/** -- idl definition -- **/
-
 #ifndef __com_sun_star_xml_crypto_xseinitializer_idl_
 #define __com_sun_star_xml_crypto_xseinitializer_idl_
 

offapi/com/sun/star/xml/crypto/XSecurityEnvironment.idl

@@ -26,10 +26,6 @@
  *
  ************************************************************************/
 
-//i20156 - new file for xmlsecurity module
-
-/** -- idl definition -- **/
-
 #ifndef __com_sun_star_xml_crypto_xsecurityenvironment_idl_
 #define __com_sun_star_xml_crypto_xsecurityenvironment_idl_
 

offapi/com/sun/star/xml/crypto/XXMLSecurityContext.idl

@@ -26,10 +26,6 @@
  *
  ************************************************************************/
 
-//i20156 - new file for xmlsecurity module
-
-/** -- idl definition -- **/
-
 #ifndef __com_sun_star_xml_crypto_xxmlsecuritycontext_idl_
 #define __com_sun_star_xml_crypto_xxmlsecuritycontext_idl_
 

udkapi/com/sun/star/task/XInteractionHandler2.idl

@@ -42,6 +42,8 @@
    <p>This interface extends the interface <type>XInteractionHandler</type>
       the way that a caller can determine whether an interaction request was
       actually handled by the interaction handler.</p>
+
+   @since OOo 3.2
  */
 /* published */ interface XInteractionHandler2 : com::sun::star::task::XInteractionHandler
 {