*api: fix all unknown commands

Change-Id: Ied26925485b2be649cabafff338e6d78c7bd17b3

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

@@ -29,18 +29,20 @@ module com {  module sun {  module star {  module awt {
 constants LineEndFormat
 {
 
-    /** specifies that line ends are to be represented by a carriage return character (\r)
+    /** specifies that line ends are to be represented by a carriage
+        return character (`\r`)
     */
     const short CARRIAGE_RETURN = 0;
 
 
-    /** specifies that line ends are to be represented by a line feed character (\n)
+    /** specifies that line ends are to be represented by a line feed
+        character (`\n`)
     */
     const short LINE_FEED = 1;
 
 
-    /** specifies that line ends are to be represented by a line feed character (\n), followed
-        by a carriage return character (\r).
+    /** specifies that line ends are to be represented by a line feed
+        character (`\n`), followed by a carriage return character (`\r`).
     */
     const short CARRIAGE_RETURN_LINE_FEED = 2;
 

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

@@ -29,7 +29,7 @@
 
 /**
     @since OOo 2.2
-    @deprecatd
+    @deprecated
         You should use AnimatedImagesControl.
  */
 published service UnoControlThrobber

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

@@ -28,7 +28,7 @@
 
 /**
     @since OOo 2.2
-    @deprecatd
+    @deprecated
         You should use SpinningAnimationControlModel.
  */
 

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

@@ -55,7 +55,7 @@ interface XSimpleTabController : com::sun::star::uno::XInterface
 
     /** change some properties of the specified tab.
 
-        @descr  Such properties can be:
+        Such properties can be:
                 <table>
                     <tr>
                         <td><b>Property</b></td>
@@ -101,7 +101,7 @@ interface XSimpleTabController : com::sun::star::uno::XInterface
 
     /** activate the specified tab.
 
-        @descr  The new tab will be activated and all listener will get an event describing this.
+        The new tab will be activated and all listener will get an event describing this.
                 Of course there will be an event too, which notifies listener about the deactivation
                 of the last active tab.
 

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

@@ -27,7 +27,7 @@
 
 
 /**
-    @deprecatd
+    @deprecated
         You should use XAnimation, AnimatedImagesControl, and AnimatedImagesControlModel.
  */
 published interface XThrobber: com::sun::star::uno::XInterface

offapi/com/sun/star/awt/grid/XGridDataModel.idl

@@ -94,7 +94,7 @@ published interface XGridDataModel
 
         @param Row
             the index of the row whose data should is to be retrieved.
-        @raises ::com::sun::star::lang::IndexOutOfBoundsException
+        @throws ::com::sun::star::lang::IndexOutOfBoundsException
             of the given row index does not denote a valid row.
     */
     sequence< any >

offapi/com/sun/star/awt/grid/XGridRowSelection.idl

@@ -41,7 +41,7 @@ published interface XGridRowSelection
         @param RowIndex
             denotes the index of the row to select
 
-        @raises ::com::sun::star::lang::IndexOutOfBoundsException
+        @throws ::com::sun::star::lang::IndexOutOfBoundsException
             if <code>RowIndex</code> does not denote a valid row index
     */
     void selectRow( [in] long RowIndex )

offapi/com/sun/star/awt/tree/XTreeControl.idl

@@ -187,7 +187,7 @@ interface XTreeControl
 
         @param x
             an integer giving the number of pixels horizontally from the left edge of the controls display area
-        @para y
+        @param y
             an integer giving the number of pixels vertically from the top edge of the controls display area
         @returns
             the XTreeNode for the node closest to that location, null if nothing is viewable or there is no model

offapi/com/sun/star/deployment/LicenseException.idl

@@ -42,7 +42,7 @@ exception LicenseException : com::sun::star::uno::Exception
     string Text;
 
     /** contains the value of the attribute
-    /description/registration/simple-license/@accept-by
+    `/description/registration/simple-license/@accept-by`
     from the description.xml
     */
     string AcceptBy;

offapi/com/sun/star/deployment/XPackage.idl

@@ -71,7 +71,7 @@ interface XPackage
 
         @param xCmdEnv
                command environment for error handling and other interaction.
-        @alreadyInstalled
+        @param alreadyInstalled
             indicates that an extension with the same identifier is already installed.
 
         @return

offapi/com/sun/star/drawing/framework/XPane2.idl

@@ -33,7 +33,7 @@ interface XPane2
 {
     /** Return whether all windows that are used to implement the pane are
         visible.
-        @Returns `TRUE` when all windows of the pane are visible.
+        @return `TRUE` when all windows of the pane are visible.
     */
     boolean isVisible ();
 

offapi/com/sun/star/embed/XCommonEmbedPersist.idl

@@ -84,7 +84,7 @@ published interface XCommonEmbedPersist: com::sun::star::uno::XInterface
             the object is in wrong state
 
         @throws com::sun::star::io::IOException
-            in case of io problems during opening\creation
+            in case of io problems during opening or creation
 
         @throws com::sun::star::uno::Exception
             in case of other problems

offapi/com/sun/star/embed/XEmbedObjectClipboardCreator.idl

@@ -69,7 +69,7 @@ published interface XEmbedObjectClipboardCreator: com::sun::star::uno::XInterfac
             one of arguments is illegal
 
         @throws com::sun::star::io::IOException
-            in case of io problems during opening\creation
+            in case of io problems during opening or creation
 
         @throws com::sun::star::uno::Exception
             in case of other problems

offapi/com/sun/star/embed/XEmbedObjectCreator.idl

@@ -65,7 +65,7 @@ published interface XEmbedObjectCreator: com::sun::star::uno::XInterface
             one of arguments is illegal
 
         @throws com::sun::star::io::IOException
-            in case of io problems during opening\creation
+            in case of io problems during opening or creation
 
         @throws com::sun::star::uno::Exception
             in case of other problems
@@ -153,7 +153,7 @@ published interface XEmbedObjectCreator: com::sun::star::uno::XInterface
             one of arguments is illegal
 
         @throws com::sun::star::io::IOException
-            in case of io problems during opening\creation
+            in case of io problems during opening or creation
 
         @throws com::sun::star::uno::Exception
             in case of other problems

offapi/com/sun/star/embed/XEmbedObjectFactory.idl

@@ -80,7 +80,7 @@ published interface XEmbedObjectFactory: com::sun::star::uno::XInterface
             one of arguments is illegal
 
         @throws com::sun::star::io::IOException
-            in case of io problems during opening\creation
+            in case of io problems during opening or creation
 
         @throws com::sun::star::uno::Exception
             in case of other problems

offapi/com/sun/star/embed/XEmbedPersist.idl

@@ -87,7 +87,7 @@ published interface XEmbedPersist: XCommonEmbedPersist
             the object is in wrong state
 
         @throws com::sun::star::io::IOException
-            in case of io problems during opening\creation
+            in case of io problems during opening or creation
 
         @throws com::sun::star::uno::Exception
             in case of other problems

offapi/com/sun/star/embed/XInsertObjectDialog.idl

@@ -59,7 +59,7 @@ published interface XInsertObjectDialog: com::sun::star::uno::XInterface
             one of arguments is illegal
 
         @throws com::sun::star::io::IOException
-            in case of io problems during opening\creation
+            in case of io problems during opening or creation
 
         @throws com::sun::star::uno::Exception
             in case of other problems

offapi/com/sun/star/embed/XLinkCreator.idl

@@ -47,7 +47,7 @@ published interface XLinkCreator: com::sun::star::uno::XInterface
         </p>
 
         @param xStorage
-            a parent storage the entry should be created/opened in
+            a parent storage the entry should be created or opened in
 
         @param sEntryName
             a name for the entry
@@ -65,7 +65,7 @@ published interface XLinkCreator: com::sun::star::uno::XInterface
             the argument is illegal
 
         @throws com::sun::star::io::IOException
-            in case of io problems during opening\creation
+            in case of io problems during opening or creation
 
         @throws com::sun::star::uno::Exception
             in case of other problems

offapi/com/sun/star/embed/XLinkFactory.idl

@@ -66,7 +66,7 @@ published interface XLinkFactory: com::sun::star::uno::XInterface
             one of arguments is illegal
 
         @throws com::sun::star::io::IOException
-            in case of io problems during opening\creation
+            in case of io problems during opening or creation
 
         @throws com::sun::star::uno::Exception
             in case of other problems

offapi/com/sun/star/embed/XLinkageSupport.idl

@@ -50,13 +50,13 @@ published interface XLinkageSupport: XCommonEmbedPersist
         </p>
 
         <p>
-        An entry with the specified name should be created\opened inside
+        An entry with the specified name should be created or opened inside
         provided storage. This entry will be used for the object persistence.
         If the entry exists already all it's contents will be ignored.
         </p>
 
         @param xStorage
-            a parent storage the entry should be created\opened in
+            a parent storage the entry should be created or opened in
 
         @param sEntryName
             a name for the entry

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

@@ -36,7 +36,7 @@ interface XModuleManager : com::sun::star::uno::XInterface
     /**
        @short  identifies the given module.
 
-       @descr  This identifier can then be used at the service ModuleManager
+       @details This identifier can then be used at the service ModuleManager
                to get more information about this module.
 
                For identification the interface com::sun::star::lang::XServiceInfo

offapi/com/sun/star/i18n/CalendarFieldIndex.idl

@@ -90,7 +90,7 @@ published constants CalendarFieldIndex
         interpret historical timezone data that consists of fractions of
         minutes, e.g. seconds. 1 minute == 60000 milliseconds.
 
-        @ATTENTION! Though the field's type is signed 16-bit, the field
+        @attention  Though the field's type is signed 16-bit, the field
         value is treated as unsigned 16-bit to allow for values up to
         60000 and expresses an absolute value that inherits its sign
         from the parent ZONE_OFFSET field.
@@ -104,7 +104,7 @@ published constants CalendarFieldIndex
         interpret historical timezone data that consists of fractions of
         minutes, e.g. seconds. 1 minute == 60000 milliseconds.
 
-        @ATTENTION! Though the field's type is signed 16-bit, the field
+        @attention  Though the field's type is signed 16-bit, the field
         value is treated as unsigned 16-bit to allow for values up to
         60000 and expresses an absolute value that inherits its sign
         from the parent DST_OFFSET field.

offapi/com/sun/star/i18n/NumberFormatIndex.idl

@@ -39,7 +39,7 @@ module com { module sun { module star { module i18n {
     <b>MUST</b> support some predefined format codes. These predefined
     format codes are accessed through indices as the following, and
     the locale data format code definitions in
-    i18npool\source\localedata\data\*.xml <b>MUST</b> have matching
+    i18npool/source/localedata/data/\*.xml <b>MUST</b> have matching
     entries in the form <br/>
 
     <code>&lt;FormatElement formatindex="0"&gt;</code> <br/>
@@ -71,7 +71,7 @@ module com { module sun { module star { module i18n {
         order to provide the same functionality and document layout on
         every platform. Like all other formats these formats are now
         defined in the i18n framework locale data files under
-        i18npool\source\localedata\data\*.xml </dd>
+        i18npool/source/localedata/data/\*.xml </dd>
 
     <dt> <a name="SYS"> DATE_SYS_... </a> </dt>
         <dd> On Windows platforms these formats used separators and
@@ -243,7 +243,7 @@ published constants NumberFormatIndex
     /**
         BOOLEAN format
 
-        @ATTENTION
+        @attention
             <b>Not</b> defined in locale data, but generated by the number
              formatter. If you want to access this format you <b>MUST</b>
             do it via com::sun::star::util::XNumberFormatTypes::getFormatIndex()
@@ -255,7 +255,7 @@ published constants NumberFormatIndex
     /**
         Text format
 
-        @ATTENTION
+        @attention
             <b>Not</b> defined in locale data, but generated by the number
              formatter. If you want to access this format you <b>MUST</b>
             do it via com::sun::star::util::XNumberFormatTypes::getFormatIndex()

offapi/com/sun/star/mail/XMailService.idl

@@ -82,7 +82,7 @@ interface XMailService: ::com::sun::star::uno::XInterface {
         contains information like the server name, port, connection type
         etc.
 
-        @precond
+        @pre
         <code>isConnected</code> returns true.
 
         @returns

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

@@ -26,8 +26,6 @@ module com { module sun { module star { module rendering {
     Path stroking is the process of drawing a polygon with a thick
     pen. The various attributes contained in this structure can be
     used to customize that process.<p>
-
-    @single #110496#
  */
 struct StrokeAttributes
 {

offapi/com/sun/star/task/XPasswordContainer2.idl

@@ -35,7 +35,7 @@ published interface XPasswordContainer2
     /** handles passwords
 
         <p>
-        Use this interface to store\retrieve passwords.
+        Use this interface to store or retrieve passwords.
         </p>
      */
     interface com::sun::star::task::XPasswordContainer;
@@ -43,7 +43,7 @@ published interface XPasswordContainer2
     /** handles passwords
 
         <p>
-        Use this interface to store\retrieve passwords.
+        Use this interface to store or retrieve passwords.
         </p>
      */
     interface com::sun::star::task::XMasterPasswordHandling2;

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

@@ -35,7 +35,6 @@ published service ContentIndex
 
     /** determines the depth of outline levels that are included into the content index.*/
 
-    /// @missing
     [optional, property] short Level;
 
     /** determines if the document index is created from outlines.

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

@@ -38,8 +38,8 @@ published constants FileSystemNotation
     const long UNIX_NOTATION = 1;
 
     /** The conventions of DOS like file systems (e.g.,
-        <code>a:\dir1\dir2\file</code> or UNC notation like
-        <code>\\host\dir1\dir2\file</code>).
+        <code>a:\\dir1\\dir2\\file</code> or UNC notation like
+        <code>\\\\host\\dir1\\dir2\\file</code>).
     */
     const long DOS_NOTATION = 2;
 

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

@@ -63,7 +63,7 @@ published service ODMAContentProvider
         URL of the OCP Root Folder )</span></p>
         <p STYLE="font-weight: medium"><b>vnd.sun.star.odma:/</b> a document
         id given by the DMS</p>
-        <p><b>vnd.sun.star.odma:/</b>::ODMA\DMS_ID\DM_SPECIFIC_INFO</p>
+        <p><b>vnd.sun.star.odma:/</b>`::ODMA\DMS_ID\DM_SPECIFIC_INFO`</p>
 
         </p>
      */

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

@@ -43,7 +43,6 @@ published service RemoteAccessContentProvider
         XParameterizedContentProvider::registerInstance()
         call must contain the UNO URL of the remote UCB.
 
-        @descr
         The XContentProviders obtained through this interface
         implement the service ContentProvider and, if
         appropriate, also the interface XFileIdentifierConverter.

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

@@ -100,7 +100,7 @@ published interface XDynamicResultSet: com::sun::star::lang::XComponent
         implemented as ContentResultSet. Its content will never
         change.
 
-        @trows ListenerAlreadySetException
+        @throws ListenerAlreadySetException
         if someone already has registered as listener via
         XDynamicResultSet::setListener() or if someone has
         established a connection to a CachedDynamicResultSet

offapi/com/sun/star/ui/XUIElementFactoryManager.idl

@@ -40,7 +40,7 @@ interface XUIElementFactoryManager
         retrieves the responsible user interface element factory from the provided arguments and passes
         the arguments to it.
 
-        see @XUIElementFactory
+        @see XUIElementFactory
         </p>
      */
     interface XUIElementFactory;

udkapi/com/sun/star/bridge/ProtocolProperty.idl

@@ -25,12 +25,8 @@ module com { module sun { module star { module bridge {
  */
 published struct ProtocolProperty
 {
-    /** @missing
-    */
     string Name;
 
-    /** @missing
-    */
     any    Value;
 };
 

udkapi/com/sun/star/io/ObjectInputStream.idl

@@ -51,7 +51,7 @@
     ...                      // skipping additional data
     </pre>
 
-    @guarantees
+    @note
     <ul>
         <li>-thread safe</li>
         <li>-allow buffer size is 2 ^ 31 -1</li>

udkapi/com/sun/star/io/ObjectOutputStream.idl

@@ -46,7 +46,7 @@ module com {  module sun {  module star {  module io {
     Object  ObjectData      // the data of the object
     </pre>
 
-    @garantees
+    @note
     <ul>
         <li>-thread safe </li>
         <li>-allow buffer size is 2 ^ 31 -1 </li>

udkapi/com/sun/star/java/XJavaThreadRegister_11.idl

@@ -27,7 +27,7 @@ module com {  module sun {  module star {  module java {
 
 /** must be implemented by the user of the XJavaThreadRegister_11.
 
-    @incomplete
+    @note incomplete
     @deprecated
  */
 published interface XJavaThreadRegister_11: com::sun::star::uno::XInterface

udkapi/com/sun/star/reflection/XIdlArray.idl

@@ -44,7 +44,7 @@ published interface XIdlArray: com::sun::star::uno::XInterface
 
         @param array
                sequence instance
-        @length
+        @param length
                 new length of sequence
      */
     void realloc(

udkapi/com/sun/star/script/XEventAttacherManager.idl

@@ -127,7 +127,7 @@ published interface XEventAttacherManager: com::sun::star::uno::XInterface
     void removeEntry( [in] long nIndex )
             raises( com::sun::star::lang::IllegalArgumentException );
 
-    /** @eturns
+    /** @return
             all events registered for the given object index.
 
         @param Index