Bin empty @seealso, @param, @return and @onerror metacomments

Change-Id: I6517028670a953954b31599fa3e23f4c8ee8cfc9

6 files changed, 0 insertions, 577 deletions

diff --git a/UnoControls/source/inc/OConnectionPointContainerHelper.hxx b/UnoControls/source/inc/OConnectionPointContainerHelper.hxx
index 9e555f7e3e72..891da3fb8a73 100644
--- a/UnoControls/source/inc/OConnectionPointContainerHelper.hxx
+++ b/UnoControls/source/inc/OConnectionPointContainerHelper.hxx
@@ -91,15 +91,8 @@ public:
 
     /**_______________________________________________________________________________________________________
         @short      increment refcount
-        @descr      -
-
         @seealso    XInterface
         @seealso    release()
-
-        @param      -
-
-        @return     -
-
         @onerror    A RuntimeException is thrown.
     */
 
@@ -107,15 +100,8 @@ public:
 
     /**_______________________________________________________________________________________________________
         @short      decrement refcount
-        @descr      -
-
         @seealso    XInterface
         @seealso    acquire()
-
-        @param      -
-
-        @return     -
-
         @onerror    A RuntimeException is thrown.
     */
 
diff --git a/UnoControls/source/inc/OConnectionPointHelper.hxx b/UnoControls/source/inc/OConnectionPointHelper.hxx
index aedcd8f93b1b..2a424b78878f 100644
--- a/UnoControls/source/inc/OConnectionPointHelper.hxx
+++ b/UnoControls/source/inc/OConnectionPointHelper.hxx
@@ -95,15 +95,8 @@ public:
 
     /**_______________________________________________________________________________________________________
         @short      increment refcount
-        @descr      -
-
         @seealso    XInterface
         @seealso    release()
-
-        @param      -
-
-        @return     -
-
         @onerror    A RuntimeException is thrown.
     */
 
@@ -111,15 +104,8 @@ public:
 
     /**_______________________________________________________________________________________________________
         @short      decrement refcount
-        @descr      -
-
         @seealso    XInterface
         @seealso    acquire()
-
-        @param      -
-
-        @return     -
-
         @onerror    A RuntimeException is thrown.
     */
 
diff --git a/UnoControls/source/inc/framecontrol.hxx b/UnoControls/source/inc/framecontrol.hxx
index 6c75edee38be..f5dc4cfc92ec 100644
--- a/UnoControls/source/inc/framecontrol.hxx
+++ b/UnoControls/source/inc/framecontrol.hxx
@@ -75,15 +75,8 @@ public:
 
     /**_______________________________________________________________________________________________________
         @short      increment refcount
-        @descr      -
-
         @seealso    XInterface
         @seealso    release()
-
-        @param      -
-
-        @return     -
-
         @onerror    A RuntimeException is thrown.
     */
 
@@ -91,15 +84,8 @@ public:
 
     /**_______________________________________________________________________________________________________
         @short      decrement refcount
-        @descr      -
-
         @seealso    XInterface
         @seealso    acquire()
-
-        @param      -
-
-        @return     -
-
         @onerror    A RuntimeException is thrown.
     */
 
diff --git a/UnoControls/source/inc/progressbar.hxx b/UnoControls/source/inc/progressbar.hxx
index 34a5ddb52b4a..5be2e5813ba9 100644
--- a/UnoControls/source/inc/progressbar.hxx
+++ b/UnoControls/source/inc/progressbar.hxx
@@ -102,15 +102,8 @@ public:
 
     /**_______________________________________________________________________________________________________
         @short      increment refcount
-        @descr      -
-
         @seealso    XInterface
         @seealso    release()
-
-        @param      -
-
-        @return     -
-
         @onerror    A RuntimeException is thrown.
     */
 
@@ -118,15 +111,8 @@ public:
 
     /**_______________________________________________________________________________________________________
         @short      decrement refcount
-        @descr      -
-
         @seealso    XInterface
         @seealso    acquire()
-
-        @param      -
-
-        @return     -
-
         @onerror    A RuntimeException is thrown.
     */
 
diff --git a/UnoControls/source/inc/progressmonitor.hxx b/UnoControls/source/inc/progressmonitor.hxx
index 77195396eaaf..2da6f8c3944e 100644
--- a/UnoControls/source/inc/progressmonitor.hxx
+++ b/UnoControls/source/inc/progressmonitor.hxx
@@ -157,15 +157,8 @@ public:
 
     /**_______________________________________________________________________________________________________
         @short      increment refcount
-        @descr      -
-
         @seealso    XInterface
         @seealso    release()
-
-        @param      -
-
-        @return     -
-
         @onerror    A RuntimeException is thrown.
     */
 
@@ -173,15 +166,8 @@ public:
 
     /**_______________________________________________________________________________________________________
         @short      decrement refcount
-        @descr      -
-
         @seealso    XInterface
         @seealso    acquire()
-
-        @param      -
-
-        @return     -
-
         @onerror    A RuntimeException is thrown.
     */
 
@@ -191,12 +177,7 @@ public:
 
     /**_______________________________________________________________________________________________________
         @short      get information about supported interfaces
-        @descr      -
-
         @seealso    XTypeProvider
-
-        @param      -
-
         @return     Sequence of types of all supported interfaces
 
         @onerror    A RuntimeException is thrown.
@@ -207,16 +188,6 @@ public:
     //  XAggregation
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual ::com::sun::star::uno::Any SAL_CALL queryAggregation( const ::com::sun::star::uno::Type& aType )
@@ -237,9 +208,6 @@ public:
                                          [sText != "" && sText != NULL]
         @param      bbeforeProgress     Position of topic<BR>
                                          [True => before progressbar / False => below progressbar]
-
-        @return     -
-
         @onerror    DEBUG   = Assertion<BR>
                     RELEASE = nothing
     */
@@ -251,16 +219,6 @@ public:
     ) throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual void SAL_CALL removeText(
@@ -269,16 +227,6 @@ public:
     ) throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual void SAL_CALL updateText(
@@ -290,77 +238,27 @@ public:
     //  XProgressBar
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual void SAL_CALL setForegroundColor( sal_Int32 nColor ) throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual void SAL_CALL setBackgroundColor( sal_Int32 nColor ) throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual void SAL_CALL setValue( sal_Int32 nValue ) throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual void SAL_CALL setRange( sal_Int32   nMin    ,
                                     sal_Int32   nMax    ) throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual sal_Int32 SAL_CALL getValue() throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
@@ -368,16 +266,6 @@ public:
     //  XButton
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual void SAL_CALL addActionListener(
@@ -385,16 +273,6 @@ public:
     ) throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual void SAL_CALL removeActionListener(
@@ -402,31 +280,11 @@ public:
     ) throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual void SAL_CALL setLabel( const OUString& sLabel ) throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual void SAL_CALL setActionCommand( const OUString& sCommand )
@@ -435,46 +293,16 @@ public:
     //  XLayoutConstrains
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual ::com::sun::star::awt::Size SAL_CALL getMinimumSize() throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual ::com::sun::star::awt::Size SAL_CALL getPreferredSize() throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual ::com::sun::star::awt::Size SAL_CALL calcAdjustedSize( const ::com::sun::star::awt::Size& aNewSize )
@@ -483,16 +311,6 @@ public:
     //  XControl
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual void SAL_CALL createPeer(
@@ -501,32 +319,12 @@ public:
     ) throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual sal_Bool SAL_CALL setModel( const ::com::sun::star::uno::Reference< ::com::sun::star::awt::XControlModel >& xModel )
         throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual ::com::sun::star::uno::Reference< ::com::sun::star::awt::XControlModel > SAL_CALL getModel()
@@ -535,16 +333,6 @@ public:
     //  XComponent
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual void SAL_CALL dispose() throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
@@ -552,16 +340,6 @@ public:
     //  XWindow
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual void SAL_CALL setPosSize(   sal_Int32   nX      ,
@@ -573,31 +351,11 @@ public:
     //  BaseControl
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     static const ::com::sun::star::uno::Sequence< OUString > impl_getStaticSupportedServiceNames();
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     static const OUString impl_getStaticImplementationName();
@@ -607,16 +365,6 @@ public:
 protected:
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     virtual void impl_paint( sal_Int32 nX ,
@@ -628,61 +376,21 @@ protected:
 private:
     using BaseControl::impl_recalcLayout;
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     void impl_recalcLayout();
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     void impl_rebuildFixedText();
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     void impl_cleanMemory();
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     IMPL_TextlistItem* impl_searchTopic( const OUString& sTopic , bool bbeforeProgress );
@@ -692,16 +400,6 @@ private:
 private:
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
     #ifdef DBG_UTIL
diff --git a/UnoControls/source/inc/statusindicator.hxx b/UnoControls/source/inc/statusindicator.hxx
index c560741e78e7..a81d581183a2 100644
--- a/UnoControls/source/inc/statusindicator.hxx
+++ b/UnoControls/source/inc/statusindicator.hxx
@@ -114,15 +114,8 @@ class StatusIndicator   : public ::com::sun::star::awt::XLayoutConstrains
 
         /**_______________________________________________________________________________________________________
             @short      increment refcount
-            @descr      -
-
             @seealso    XInterface
             @seealso    release()
-
-            @param      -
-
-            @return     -
-
             @onerror    A RuntimeException is thrown.
         */
 
@@ -130,15 +123,8 @@ class StatusIndicator   : public ::com::sun::star::awt::XLayoutConstrains
 
         /**_______________________________________________________________________________________________________
             @short      decrement refcount
-            @descr      -
-
             @seealso    XInterface
             @seealso    acquire()
-
-            @param      -
-
-            @return     -
-
             @onerror    A RuntimeException is thrown.
         */
 
@@ -148,12 +134,7 @@ class StatusIndicator   : public ::com::sun::star::awt::XLayoutConstrains
 
         /**_______________________________________________________________________________________________________
             @short      get information about supported interfaces
-            @descr      -
-
             @seealso    XTypeProvider
-
-            @param      -
-
             @return     Sequence of types of all supported interfaces
 
             @onerror    A RuntimeException is thrown.
@@ -165,16 +146,6 @@ class StatusIndicator   : public ::com::sun::star::awt::XLayoutConstrains
         //  XAggregation
 
         /**_______________________________________________________________________________________________________
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         */
 
         virtual ::com::sun::star::uno::Any SAL_CALL queryAggregation( const ::com::sun::star::uno::Type& aType )
@@ -183,16 +154,6 @@ class StatusIndicator   : public ::com::sun::star::awt::XLayoutConstrains
         //  XStatusIndicator
 
         /*-****************************************************************************************************
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         *//*-*****************************************************************************************************/
 
         virtual void SAL_CALL start(
@@ -201,61 +162,21 @@ class StatusIndicator   : public ::com::sun::star::awt::XLayoutConstrains
         ) throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
         /*-****************************************************************************************************
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         *//*-*****************************************************************************************************/
 
         virtual void SAL_CALL end() throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
         /*-****************************************************************************************************
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         *//*-*****************************************************************************************************/
 
         virtual void SAL_CALL reset() throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
         /*-****************************************************************************************************
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         *//*-*****************************************************************************************************/
 
         virtual void SAL_CALL setText( const OUString& sText ) throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
         /*-****************************************************************************************************
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         *//*-*****************************************************************************************************/
 
         virtual void SAL_CALL setValue( sal_Int32 nValue ) throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
@@ -263,46 +184,16 @@ class StatusIndicator   : public ::com::sun::star::awt::XLayoutConstrains
         //  XLayoutConstrains
 
         /**_______________________________________________________________________________________________________
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         */
 
         virtual ::com::sun::star::awt::Size SAL_CALL getMinimumSize() throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
         /**_______________________________________________________________________________________________________
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         */
 
         virtual ::com::sun::star::awt::Size SAL_CALL getPreferredSize() throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
         /**_______________________________________________________________________________________________________
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         */
 
         virtual ::com::sun::star::awt::Size SAL_CALL calcAdjustedSize( const ::com::sun::star::awt::Size& aNewSize )
@@ -311,16 +202,6 @@ class StatusIndicator   : public ::com::sun::star::awt::XLayoutConstrains
         //  XControl
 
         /**_______________________________________________________________________________________________________
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         */
 
         virtual void SAL_CALL createPeer(
@@ -329,32 +210,12 @@ class StatusIndicator   : public ::com::sun::star::awt::XLayoutConstrains
         ) throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
         /**_______________________________________________________________________________________________________
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         */
 
         virtual sal_Bool SAL_CALL setModel( const ::com::sun::star::uno::Reference< ::com::sun::star::awt::XControlModel >& xModel )
             throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
 
         /**_______________________________________________________________________________________________________
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         */
 
         virtual ::com::sun::star::uno::Reference< ::com::sun::star::awt::XControlModel > SAL_CALL getModel()
@@ -363,16 +224,6 @@ class StatusIndicator   : public ::com::sun::star::awt::XLayoutConstrains
         //  XComponent
 
         /**_______________________________________________________________________________________________________
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         */
 
         virtual void SAL_CALL dispose() throw( ::com::sun::star::uno::RuntimeException, std::exception ) SAL_OVERRIDE;
@@ -380,16 +231,6 @@ class StatusIndicator   : public ::com::sun::star::awt::XLayoutConstrains
         //  XWindow
 
         /**_______________________________________________________________________________________________________
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         */
 
         virtual void SAL_CALL setPosSize(   sal_Int32   nX      ,
@@ -401,31 +242,11 @@ class StatusIndicator   : public ::com::sun::star::awt::XLayoutConstrains
         //  BaseControl
 
         /**_______________________________________________________________________________________________________
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         */
 
         static const ::com::sun::star::uno::Sequence< OUString > impl_getStaticSupportedServiceNames();
 
         /**_______________________________________________________________________________________________________
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         */
 
         static const OUString impl_getStaticImplementationName();
@@ -435,16 +256,6 @@ class StatusIndicator   : public ::com::sun::star::awt::XLayoutConstrains
 protected:
 
         /**_______________________________________________________________________________________________________
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         */
 
         virtual ::com::sun::star::awt::WindowDescriptor* impl_getWindowDescriptor(
@@ -452,16 +263,6 @@ protected:
         ) SAL_OVERRIDE;
 
         /**_______________________________________________________________________________________________________
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         */
 
         virtual void impl_paint (
@@ -471,16 +272,6 @@ protected:
         ) SAL_OVERRIDE;
 
         /**_______________________________________________________________________________________________________
-            @short      -
-            @descr      -
-
-            @seealso    -
-
-            @param      -
-
-            @return     -
-
-            @onerror    -
         */
 
         virtual void impl_recalcLayout( const ::com::sun::star::awt::WindowEvent& aEvent ) SAL_OVERRIDE;
@@ -490,16 +281,6 @@ protected:
 private:
 
     /**_______________________________________________________________________________________________________
-        @short      -
-        @descr      -
-
-        @seealso    -
-
-        @param      -
-
-        @return     -
-
-        @onerror    -
     */
 
 // private variables