New loplugin:dynexcspec: Add @throws documentation, filter

Change-Id: Id465279b54f775ae688d02798c7a67fc50829fc6

16 files changed, 93 insertions, 26 deletions

diff --git a/filter/source/config/cache/basecontainer.hxx b/filter/source/config/cache/basecontainer.hxx
index f02146c43f58..fafe12fbed0e 100644
--- a/filter/source/config/cache/basecontainer.hxx
+++ b/filter/source/config/cache/basecontainer.hxx
@@ -171,6 +171,8 @@ class BaseContainer : public BaseLock
 
             @descr  If no exception occurs, its guaranteed, that the member m_rFlushCache
                     was initialized right and can be used further.
+
+            @throws css::uno::RuntimeException
          */
         void impl_initFlushMode()
             throw (css::uno::RuntimeException);
diff --git a/filter/source/config/cache/filtercache.hxx b/filter/source/config/cache/filtercache.hxx
index 74529e73250b..976d47ea8c24 100644
--- a/filter/source/config/cache/filtercache.hxx
+++ b/filter/source/config/cache/filtercache.hxx
@@ -331,6 +331,8 @@ class FilterCache : public BaseLock
 
             @return     sal_True if the required fill state exists for this cache; FALSE
                         otherwise.
+
+            @throws css::uno::Exception
          */
         bool isFillState(EFillState eRequired) const
             throw(css::uno::Exception);
@@ -476,6 +478,8 @@ class FilterCache : public BaseLock
 
 
         /** TODO document me ...
+
+            @throws css::uno::Exception
          */
         void removeItem(      EItemType        eType,
                                 const OUString& sItem)
@@ -483,6 +487,8 @@ class FilterCache : public BaseLock
 
 
         /** TODO document me ...
+
+            @throws css::uno::Exception
          */
         void setItem(      EItemType        eType ,
                              const OUString& sItem ,
@@ -491,6 +497,8 @@ class FilterCache : public BaseLock
 
 
         /** TODO document me ...
+
+            @throws css::uno::Exception
          */
         void refreshItem(      EItemType        eType,
                                  const OUString& sItem)
@@ -539,6 +547,8 @@ class FilterCache : public BaseLock
 
 
         /** TODO document me
+
+            @throws css::uno::Exception
          */
         static void removeStatePropsFromItem(CacheItem& aValue)
             throw(css::uno::Exception);
@@ -624,6 +634,8 @@ class FilterCache : public BaseLock
                         specify the needed configuration provider.
                         see EConfigProvider for further information ...
 
+            @throws css::uno::Exception
+
             @attention  If a configuration access was opened successfully
                         all necessary listener connections will be established
                         too. So this cache will be informed about outside updates.
@@ -686,6 +698,8 @@ class FilterCache : public BaseLock
 
             @param      eRequiredState
                         indicates, which fill state this cache should have afterwards.
+
+            @throws css::uno::Exception
          */
         void impl_load(EFillState eRequiredState)
             throw(css::uno::Exception);
@@ -804,20 +818,29 @@ class FilterCache : public BaseLock
             throw (css::uno::Exception, std::exception);
 
 
-        /** TODO */
+        /** TODO
+
+            @throws css::uno::Exception
+        */
         static void impl_saveItem(const css::uno::Reference< css::container::XNameReplace >& xSet  ,
                                  EItemType                                            eType ,
                            const CacheItem & aValue)
             throw(css::uno::Exception);
 
 
-        /** TODO */
+        /** TODO
+
+            @throws css::uno::Exception
+        */
         void impl_addItem2FlushList(      EItemType        eType,
                                     const OUString& sItem)
             throw(css::uno::Exception);
 
 
-        /** TODO */
+        /** TODO
+
+            @throws css::uno::Exception
+        */
         static void impl_flushByList(const css::uno::Reference< css::container::XNameAccess >& xSet  ,
                                     EItemType                                           eType ,
                               const CacheItemList&                                      rCache,
@@ -858,13 +881,19 @@ class FilterCache : public BaseLock
             throw(css::uno::Exception);
 
 
-        /** TODO */
+        /** TODO
+
+            @throws css::uno::Exception
+        */
         void impl_readPatchUINames(const css::uno::Reference< css::container::XNameAccess >& xNode,
                                          CacheItem&                                          rItem)
             throw(css::uno::Exception, std::exception);
 
 
-        /** TODO */
+        /** TODO
+
+            @throws css::uno::Exception
+        */
         static void impl_savePatchUINames(const css::uno::Reference< css::container::XNameReplace >& xNode,
                                    const CacheItem&                                           rItem)
             throw(css::uno::Exception);
@@ -872,7 +901,10 @@ class FilterCache : public BaseLock
         /** TODO */
         void impl_readOldFormat();
 
-        /** TODO */
+        /** TODO
+
+            @throws css::uno::Exception
+        */
         CacheItem impl_readOldItem(const css::uno::Reference< css::container::XNameAccess >& xSet ,
                                          EItemType                                           eType,
                                    const OUString&                                    sItem)
diff --git a/filter/source/flash/swfuno.hxx b/filter/source/flash/swfuno.hxx
index ef0cc16e7e99..d9323e29ac56 100644
--- a/filter/source/flash/swfuno.hxx
+++ b/filter/source/flash/swfuno.hxx
@@ -37,12 +37,15 @@ namespace com { namespace sun { namespace star {
 
 namespace swf {
 
+/// @throws css::uno::RuntimeException
 OUString FlashExportFilter_getImplementationName()
     throw (css::uno::RuntimeException);
 
+/// @throws css::uno::RuntimeException
 css::uno::Sequence<OUString> SAL_CALL
 FlashExportFilter_getSupportedServiceNames() throw (css::uno::RuntimeException);
 
+/// @throws css::uno::Exception
 css::uno::Reference<css::uno::XInterface> SAL_CALL
 FlashExportFilter_createInstance(
     css::uno::Reference<css::lang::XMultiServiceFactory> const & rSMgr)
@@ -50,11 +53,14 @@ FlashExportFilter_createInstance(
 
 }
 
+/// @throws css::uno::RuntimeException
 OUString SWFDialog_getImplementationName () throw (css::uno::RuntimeException);
 
+/// @throws css::uno::RuntimeException
 css::uno::Sequence<OUString> SAL_CALL SWFDialog_getSupportedServiceNames()
     throw (css::uno::RuntimeException);
 
+/// @throws css::uno::Exception
 css::uno::Reference<css::uno::XInterface> SAL_CALL SWFDialog_createInstance(
     css::uno::Reference<css::lang::XMultiServiceFactory> const & rSMgr)
     throw(css::uno::Exception);
diff --git a/filter/source/msfilter/msvbahelper.cxx b/filter/source/msfilter/msvbahelper.cxx
index 8577f35292a7..e638dcd46815 100644
--- a/filter/source/msfilter/msvbahelper.cxx
+++ b/filter/source/msfilter/msvbahelper.cxx
@@ -615,6 +615,7 @@ bool getModifier( char c, sal_uInt16& mod )
     return false;
 }
 
+/// @throws uno::RuntimeException
 sal_uInt16 parseChar( char c ) throw ( uno::RuntimeException )
 {
     sal_uInt16 nVclKey = 0;
diff --git a/filter/source/pdf/pdfdialog.hxx b/filter/source/pdf/pdfdialog.hxx
index f01d6f72a3d2..a8ba2f2e9642 100644
--- a/filter/source/pdf/pdfdialog.hxx
+++ b/filter/source/pdf/pdfdialog.hxx
@@ -65,9 +65,11 @@ public:
     virtual     ~PDFDialog() override;
 };
 
-
+/// @throws RuntimeException
 OUString PDFDialog_getImplementationName () throw (RuntimeException);
+/// @throws RuntimeException
 Sequence< OUString > SAL_CALL PDFDialog_getSupportedServiceNames() throw (RuntimeException);
+/// @throws Exception
 Reference< XInterface > SAL_CALL PDFDialog_createInstance( const Reference< XMultiServiceFactory > & rSMgr) throw( Exception );
 
 #endif // INCLUDED_FILTER_SOURCE_PDF_PDFDIALOG_HXX
diff --git a/filter/source/pdf/pdffilter.hxx b/filter/source/pdf/pdffilter.hxx
index 3c93d8a7a675..878e79f1f1eb 100644
--- a/filter/source/pdf/pdffilter.hxx
+++ b/filter/source/pdf/pdffilter.hxx
@@ -81,19 +81,19 @@ public:
     virtual     ~PDFFilter() override;
 };
 
-
+/// @throws RuntimeException
 OUString PDFFilter_getImplementationName ()
     throw ( RuntimeException );
 
-
+/// @throws RuntimeException
 bool SAL_CALL PDFFilter_supportsService( const OUString& ServiceName )
     throw ( RuntimeException );
 
-
+/// @throws RuntimeException
 Sequence< OUString > SAL_CALL PDFFilter_getSupportedServiceNames(  )
     throw ( RuntimeException );
 
-
+/// @throws Exception
 Reference< XInterface >
 SAL_CALL PDFFilter_createInstance( const Reference< XMultiServiceFactory > & rSMgr)
     throw ( Exception );
diff --git a/filter/source/pdf/pdfinteract.hxx b/filter/source/pdf/pdfinteract.hxx
index 8968c77e5db8..18ba5e67dc15 100644
--- a/filter/source/pdf/pdfinteract.hxx
+++ b/filter/source/pdf/pdfinteract.hxx
@@ -52,19 +52,19 @@ public:
     virtual     ~PDFInteractionHandler() override;
 };
 
-
+/// @throws RuntimeException
 OUString PDFInteractionHandler_getImplementationName ()
     throw ( RuntimeException );
 
-
+/// @throws RuntimeException
 bool SAL_CALL PDFInteractionHandler_supportsService( const OUString& ServiceName )
     throw ( RuntimeException );
 
-
+/// @throws RuntimeException
 Sequence< OUString > SAL_CALL PDFInteractionHandler_getSupportedServiceNames(  )
     throw ( RuntimeException );
 
-
+/// @throws Exception
 Reference< XInterface >
 SAL_CALL PDFInteractionHandler_createInstance( const Reference< XMultiServiceFactory > & rSMgr)
     throw ( Exception );
diff --git a/filter/source/placeware/exporter.cxx b/filter/source/placeware/exporter.cxx
index bf5d30d1f71c..b9cbabb568e3 100644
--- a/filter/source/placeware/exporter.cxx
+++ b/filter/source/placeware/exporter.cxx
@@ -102,7 +102,7 @@ PageEntry::~PageEntry()
 {
 }
 
-
+/// @throws css::uno::Exception
 static void encodeFile( osl::File& rSourceFile, Reference< XOutputStream > const & xOutputStream ) throw( css::uno::Exception )
 {
     if( xOutputStream.is() )
@@ -178,6 +178,7 @@ static OString convertString( const OUString& aInput )
     return aRet;
 }
 
+/// @throws css::uno::Exception
 static void createSlideFile( const Reference< XComponent >& xDoc, PlacewareZipFile& rZipFile, const OUString& rURL, std::vector< PageEntry* >& rPageEntries  ) throw( css::uno::Exception, std::exception )
 {
     OString aInfo;
diff --git a/filter/source/placeware/filter.hxx b/filter/source/placeware/filter.hxx
index d76c040d0226..8772142eb555 100644
--- a/filter/source/placeware/filter.hxx
+++ b/filter/source/placeware/filter.hxx
@@ -36,13 +36,16 @@ namespace com { namespace sun { namespace star {
 
 namespace pwp {
 
+/// @throws css::uno::RuntimeException
 OUString PlaceWareExportFilter_getImplementationName()
     throw (css::uno::RuntimeException);
 
+/// @throws css::uno::RuntimeException
 css::uno::Sequence<OUString> SAL_CALL
 PlaceWareExportFilter_getSupportedServiceNames()
     throw (css::uno::RuntimeException);
 
+/// @throws css::uno::Exception
 css::uno::Reference<css::uno::XInterface> SAL_CALL
 PlaceWareExportFilter_createInstance(
     css::uno::Reference<css::lang::XMultiServiceFactory> const & rSMgr)
diff --git a/filter/source/svg/svgdialog.hxx b/filter/source/svg/svgdialog.hxx
index 7bfc0ee29917..4a50ff4bed6b 100644
--- a/filter/source/svg/svgdialog.hxx
+++ b/filter/source/svg/svgdialog.hxx
@@ -72,19 +72,19 @@ public:
     virtual     ~SVGDialog() override;
 };
 
-
+/// @throws css::uno::RuntimeException
 OUString SVGDialog_getImplementationName ()
     throw ( css::uno::RuntimeException );
 
-
+/// @throws css::uno::RuntimeException
 bool SAL_CALL SVGDialog_supportsService( const OUString& ServiceName )
     throw ( css::uno::RuntimeException );
 
-
+/// @throws css::uno::RuntimeException
 css::uno::Sequence< OUString > SAL_CALL SVGDialog_getSupportedServiceNames(  )
     throw ( css::uno::RuntimeException );
 
-
+/// @throws css::uno::Exception
 css::uno::Reference< css::uno::XInterface >
     SAL_CALL SVGDialog_createInstance( const css::uno::Reference< css::lang::XMultiServiceFactory > & rSMgr)
         throw ( css::uno::Exception );
diff --git a/filter/source/svg/svgfilter.hxx b/filter/source/svg/svgfilter.hxx
index 9f27ef90744b..215b9037a245 100644
--- a/filter/source/svg/svgfilter.hxx
+++ b/filter/source/svg/svgfilter.hxx
@@ -234,8 +234,10 @@ private:
     Link<EditFieldInfo*,void>           maOldFieldHdl;
     Link<EditFieldInfo*,void>           maNewFieldHdl;
 
+    /// @throws css::uno::RuntimeException
     bool                            implImport( const Sequence< PropertyValue >& rDescriptor ) throw (RuntimeException, std::exception);
 
+    /// @throws css::uno::RuntimeException
     bool                            implExport( const Sequence< PropertyValue >& rDescriptor ) throw (RuntimeException, std::exception);
     static Reference< XWriter >     implCreateExportDocumentHandler( const Reference< XOutputStream >& rxOStm );
 
diff --git a/filter/source/t602/t602filter.hxx b/filter/source/t602/t602filter.hxx
index 59d07a21df70..852fb8f33557 100644
--- a/filter/source/t602/t602filter.hxx
+++ b/filter/source/t602/t602filter.hxx
@@ -53,13 +53,15 @@ typedef enum {
 
 enum class tnode {START,READCH,EOL,POCMD,EXPCMD,SETCMD,SETCH,WRITE,EEND,QUIT};
 
+/// @throws css::uno::RuntimeException
 OUString getImplementationName()
     throw ( css::uno::RuntimeException );
 
+/// @throws css::uno::RuntimeException
 css::uno::Sequence < OUString > getSupportedServiceNames()
     throw ( css::uno::RuntimeException );
 
-
+/// @throws css::uno::Exception
 css::uno::Reference < css::uno::XInterface > SAL_CALL
     CreateInstance( const css::uno::Reference< css::lang::XMultiServiceFactory > &r)
     throw ( css::uno::Exception );
@@ -247,6 +249,7 @@ private:
     void setfnt(fonts fnt,bool mustwrite);
     void wrtfnt();
 
+    /// @throws css::uno::RuntimeException
     bool SAL_CALL importImpl( const css::uno::Sequence< css::beans::PropertyValue >& aDescriptor )
         throw (css::uno::RuntimeException);
 
@@ -285,28 +288,36 @@ private:
         bool SAL_CALL test();
 };
 
+/// @throws css::uno::RuntimeException
 OUString T602ImportFilter_getImplementationName()
     throw ( css::uno::RuntimeException );
 
+/// @throws css::uno::RuntimeException
 bool SAL_CALL T602ImportFilter_supportsService( const OUString& ServiceName )
     throw ( css::uno::RuntimeException );
 
+/// @throws css::uno::RuntimeException
 css::uno::Sequence< OUString > SAL_CALL T602ImportFilter_getSupportedServiceNames(  )
     throw ( css::uno::RuntimeException );
 
+/// @throws css::uno::Exception
 css::uno::Reference< css::uno::XInterface >
 SAL_CALL T602ImportFilter_createInstance( const css::uno::Reference< css::lang::XMultiServiceFactory > & rSMgr)
     throw ( css::uno::Exception );
 
+/// @throws css::uno::RuntimeException
 OUString T602ImportFilterDialog_getImplementationName()
     throw ( css::uno::RuntimeException );
 
+/// @throws css::uno::RuntimeException
 bool SAL_CALL T602ImportFilterDialog_supportsService( const OUString& ServiceName )
     throw ( css::uno::RuntimeException );
 
+/// @throws css::uno::RuntimeException
 css::uno::Sequence< OUString > SAL_CALL T602ImportFilterDialog_getSupportedServiceNames(  )
     throw ( css::uno::RuntimeException );
 
+/// @throws css::uno::Exception
 css::uno::Reference< css::uno::XInterface >
 SAL_CALL T602ImportFilterDialog_createInstance( const css::uno::Reference< css::lang::XMultiServiceFactory > & rSMgr)
     throw ( css::uno::Exception );
diff --git a/filter/source/xmlfilteradaptor/XmlFilterAdaptor.hxx b/filter/source/xmlfilteradaptor/XmlFilterAdaptor.hxx
index 6bfde48082d2..bc4f3e52af39 100644
--- a/filter/source/xmlfilteradaptor/XmlFilterAdaptor.hxx
+++ b/filter/source/xmlfilteradaptor/XmlFilterAdaptor.hxx
@@ -60,9 +60,11 @@ protected:
     OUString msTemplateName;
     FilterType meType;
 
+    /// @throws css::uno::RuntimeException
     bool SAL_CALL exportImpl( const css::uno::Sequence< css::beans::PropertyValue >& aDescriptor )
         throw (css::uno::RuntimeException);
 
+    /// @throws css::uno::RuntimeException
     bool SAL_CALL importImpl( const css::uno::Sequence< css::beans::PropertyValue >& aDescriptor )
         throw (css::uno::RuntimeException, std::exception);
 
@@ -123,19 +125,19 @@ public:
 
 };
 
-
+/// @throws css::uno::RuntimeException
 OUString XmlFilterAdaptor_getImplementationName()
     throw ( css::uno::RuntimeException );
 
-
+/// @throws css::uno::RuntimeException
 bool SAL_CALL XmlFilterAdaptor_supportsService( const OUString& ServiceName )
     throw ( css::uno::RuntimeException );
 
-
+/// @throws css::uno::RuntimeException
 css::uno::Sequence< OUString > SAL_CALL XmlFilterAdaptor_getSupportedServiceNames(  )
     throw ( css::uno::RuntimeException );
 
-
+/// @throws css::uno::Exception
 css::uno::Reference< css::uno::XInterface >
 
 SAL_CALL XmlFilterAdaptor_createInstance( const css::uno::Reference< css::lang::XMultiServiceFactory > & rSMgr)
diff --git a/filter/source/xsltdialog/xmlfilterdialogcomponent.cxx b/filter/source/xsltdialog/xmlfilterdialogcomponent.cxx
index 785a7d0427af..829780180a30 100644
--- a/filter/source/xsltdialog/xmlfilterdialogcomponent.cxx
+++ b/filter/source/xsltdialog/xmlfilterdialogcomponent.cxx
@@ -162,18 +162,20 @@ void SAL_CALL XMLFilterDialogComponent::release() throw ()
     OComponentHelper::release();
 }
 
-
+/// @throws RuntimeException
 OUString XMLFilterDialogComponent_getImplementationName() throw ( RuntimeException )
 {
     return OUString( "com.sun.star.comp.ui.XSLTFilterDialog" );
 }
 
+/// @throws RuntimeException
 Sequence< OUString > SAL_CALL XMLFilterDialogComponent_getSupportedServiceNames()  throw ( RuntimeException )
 {
     Sequence< OUString > aSupported { "com.sun.star.ui.dialogs.XSLTFilterDialog" };
     return aSupported;
 }
 
+/// @throws Exception
 Reference< XInterface > SAL_CALL XMLFilterDialogComponent_createInstance( const Reference< XMultiServiceFactory > & rSMgr) throw ( Exception )
 {
     return static_cast<OWeakObject*>(new XMLFilterDialogComponent( comphelper::getComponentContext(rSMgr) ));
diff --git a/filter/source/xsltdialog/xmlfilterjar.cxx b/filter/source/xsltdialog/xmlfilterjar.cxx
index 11eba3123d46..d4dbcae8fe59 100644
--- a/filter/source/xsltdialog/xmlfilterjar.cxx
+++ b/filter/source/xsltdialog/xmlfilterjar.cxx
@@ -79,6 +79,7 @@ static OUString encodeZipUri( const OUString& rURI )
     return Uri::encode( rURI, rtl_UriCharClassUric, rtl_UriEncodeCheckEscapes, RTL_TEXTENCODING_UTF8 );
 }
 
+/// @throws Exception
 static Reference< XInterface > addFolder( Reference< XInterface >& xRootFolder, Reference< XSingleServiceFactory >& xFactory, const OUString& rName ) throw( Exception )
 {
     if ( rName == ".." || rName == "." )
@@ -101,6 +102,7 @@ static Reference< XInterface > addFolder( Reference< XInterface >& xRootFolder,
     return xFolder;
 }
 
+/// @throws Exception
 static void addFile_( Reference< XInterface > const & xRootFolder, Reference< XSingleServiceFactory > const & xFactory, Reference< XInputStream > const & xInput, const OUString& aName ) throw( Exception )
 {
     Reference< XActiveDataSink > xSink( xFactory->createInstance(), UNO_QUERY );
diff --git a/filter/source/xsltdialog/xmlfilterjar.hxx b/filter/source/xsltdialog/xmlfilterjar.hxx
index be76e3cdedc8..24ec5dccc051 100644
--- a/filter/source/xsltdialog/xmlfilterjar.hxx
+++ b/filter/source/xsltdialog/xmlfilterjar.hxx
@@ -38,6 +38,7 @@ public:
     void openPackage( const OUString& rPackageURL, XMLFilterVector& rFilters );
 
 private:
+    /// @throws css::uno::Exception
     void addFile( css::uno::Reference< css::uno::XInterface > const & xRootFolder, css::uno::Reference< css::lang::XSingleServiceFactory > const & xFactory, const OUString& rSourceFile ) throw( css::uno::Exception, std::exception );
 
     bool copyFile( const css::uno::Reference< css::container::XHierarchicalNameAccess >& xIfc, OUString& rURL, const OUString& rTargetURL );