offapi: fix even more doxygen warnings

Change-Id: Ic46ffa9423032a61ef79471c7cb4f2771c7f4270

4 files changed, 52 insertions, 12 deletions

diff --git a/offapi/com/sun/star/linguistic2/XProofreader.idl b/offapi/com/sun/star/linguistic2/XProofreader.idl
index cf80eeb7e72a..ed918a327a27 100644
--- a/offapi/com/sun/star/linguistic2/XProofreader.idl
+++ b/offapi/com/sun/star/linguistic2/XProofreader.idl
@@ -45,24 +45,38 @@ interface XProofreader: com::sun::star::linguistic2::XSupportedLocales
 
     /** start checking
 
-        @param  nDocId
+        @param  aDocumentIdentifier
                 the Document ID.
 
-        @param  rFlatParaText
+        @param  aText
                 the flat text to be checked.
 
-        @param  xFlatPara
-                the flat paragraph to be checked.
-
         @param  aLocale
                 Language used in the text.
 
-        @param  nStartOfSentencePos
+        @param  nStartOfSentencePosition
                 Start Index of the text.
 
-        @param  nSuggestedSentenceEndPos
+        @param  nSuggestedBehindEndOfSentencePosition
                 Probable end position of the text.
 
+        @param  aProperties
+                additional properties of the text.
+
+                Currently the following properties may be supported:
+                <table>
+                    <tr>
+                        <td>FieldPositions</td>
+                        <td>sequence&lt;long&gt;</td>
+                        <td>indexes of fields in aText</td>
+                    </tr>
+                    <tr>
+                        <td>FootnotePositions</td>
+                        <td>sequence&lt;long&gt;</td>
+                        <td>indexes of footnotes in aText</td>
+                    </tr>
+                </table>
+
         @throws IllegalArgumentException
                 when any argument is wrong.
     */
diff --git a/offapi/com/sun/star/linguistic2/XProofreadingIterator.idl b/offapi/com/sun/star/linguistic2/XProofreadingIterator.idl
index eec48ee068a8..063c1d0b30a7 100644
--- a/offapi/com/sun/star/linguistic2/XProofreadingIterator.idl
+++ b/offapi/com/sun/star/linguistic2/XProofreadingIterator.idl
@@ -37,7 +37,7 @@ interface XProofreadingIterator: com::sun::star::uno::XInterface
 {
     /** start proofreading and automatically process the whole text
 
-        @param  xDoc
+        @param  xDocument
                 the text document.
 
         @param  xIteratorProvider
@@ -52,13 +52,25 @@ interface XProofreadingIterator: com::sun::star::uno::XInterface
 
     /** start proofreading from a given position
 
-        @param  xDoc
+        @param  xDocument
                 the document.
 
-        @param  xStartPara
+        @param  xFlatParagraph
                 the single flat paragraph to be checked.
 
-        @param  nErrorPosInPara
+        @param  aText
+                the text of the paragraph to be checked.
+
+        @param  aLocale
+                currently unused parameter.
+
+        @param  nStartOfSentencePosition
+                the start position of the current sentence.
+
+        @param  nSuggestedBehindEndOfSentencePosition
+                currently unused parameter.
+
+        @param  nErrorPositionInParagraph
                 the given index.
 
         @throws IllegalArgumentException
@@ -80,7 +92,7 @@ interface XProofreadingIterator: com::sun::star::uno::XInterface
 
     /** checks if the given document is currently being checked
 
-        @param  xDoc
+        @param  xDocument
                 the document.
 
         @returns
diff --git a/offapi/com/sun/star/resource/XLocale.idl b/offapi/com/sun/star/resource/XLocale.idl
index ed4c9870d808..fe37fccfdb8d 100644
--- a/offapi/com/sun/star/resource/XLocale.idl
+++ b/offapi/com/sun/star/resource/XLocale.idl
@@ -121,6 +121,8 @@ published interface XLocale: com::sun::star::uno::XInterface
                     language code for display of field to user. If the localized
                     name is not found, returns the ISO codes.
 
+                @param locale the locale.
+
                 @param inLocale
                     specifies the desired user language.
      */
@@ -138,6 +140,8 @@ published interface XLocale: com::sun::star::uno::XInterface
                     country code for display of field to user. If the localized
                     name is not found, returns the ISO codes.
 
+                @param locale the locale.
+
                 @param inLocale
                     specifies the desired user country.
      */
@@ -154,6 +158,8 @@ published interface XLocale: com::sun::star::uno::XInterface
                     variant code for display of field to user. If the localized
                     name is not found, returns the ISO codes.
 
+                @param locale the locale.
+
                 @param inLocale
                     specifies the desired user variant.
      */
@@ -164,6 +170,8 @@ published interface XLocale: com::sun::star::uno::XInterface
                     a string to display the entire locale to user. If the localized
                     name is not found, uses the ISO codes. The default locale is used
                     for the presentation language.
+
+            @param locale the locale.
      */
     string getDisplayName_Default( [in] com::sun::star::lang::Locale locale );
 
@@ -171,6 +179,8 @@ published interface XLocale: com::sun::star::uno::XInterface
                     a string to display the entire locale to user. If the localized
                     name is not found, uses the ISO codes.
 
+                @param locale the locale.
+
                 @param inLocale
                     specifies the desired user locale.
      */
diff --git a/offapi/com/sun/star/ui/dialogs/Wizard.idl b/offapi/com/sun/star/ui/dialogs/Wizard.idl
index dba330a380f2..f7156496a805 100644
--- a/offapi/com/sun/star/ui/dialogs/Wizard.idl
+++ b/offapi/com/sun/star/ui/dialogs/Wizard.idl
@@ -38,6 +38,8 @@ service Wizard : XWizard
     /** creates a wizard with a single execution path
         @param PageIds
             the IDs of the pages which constitute the execution path. IDs must be in ascending order.
+        @param Controller
+            the wizard controller.
     */
     createSinglePathWizard(
         [in] sequence< short > PageIds,
@@ -50,6 +52,8 @@ service Wizard : XWizard
 
         @param PageIds
             the IDs of the pages which constitute the execution paths. IDs in each path must be in ascending order.
+        @param Controller
+            the wizard controller.
     */
     createMultiplePathsWizard(
         [in] sequence< sequence< short > > PageIds,