New loplugin:dynexcspec: Add @throws documentation, filter

Change-Id: Id465279b54f775ae688d02798c7a67fc50829fc6

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);

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)

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);

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;

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

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 );

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 );

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;

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)

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 );

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 );
 

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 );

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)

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) ));

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 );

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 );

include/filter/msfilter/msvbahelper.hxx

@@ -63,7 +63,9 @@ MSFILTER_DLLPUBLIC OUString getDefaultProjectName( SfxObjectShell* pShell );
 MSFILTER_DLLPUBLIC OUString resolveVBAMacro( SfxObjectShell* pShell, const OUString& rLibName, const OUString& rModuleName, const OUString& rMacroName );
 MSFILTER_DLLPUBLIC MacroResolvedInfo resolveVBAMacro( SfxObjectShell* pShell, const OUString& rMacroName, bool bSearchGlobalTemplates = false );
 MSFILTER_DLLPUBLIC bool executeMacro( SfxObjectShell* pShell, const OUString& sMacroName, css::uno::Sequence< css::uno::Any >& aArgs, css::uno::Any& aRet, const css::uno::Any& aCaller );
+/// @throws css::uno::RuntimeException
 MSFILTER_DLLPUBLIC css::awt::KeyEvent parseKeyEvent( const OUString& sKey ) throw (css::uno::RuntimeException);
+/// @throws css::uno::RuntimeException
 MSFILTER_DLLPUBLIC void applyShortCutKeyBinding ( const css::uno::Reference< css::frame::XModel >& rxDoc, const css::awt::KeyEvent& rKeyEvent, const OUString& sMacro ) throw (css::uno::RuntimeException, std::exception);
 
 
@@ -117,6 +119,7 @@ OUString SAL_CALL VBAMacroResolver_getImplementationName();
 css::uno::Sequence<OUString> SAL_CALL
 VBAMacroResolver_getSupportedServiceNames();
 
+/// @throws css::uno::Exception
 css::uno::Reference<css::uno::XInterface> SAL_CALL
 VBAMacroResolver_createInstance(
     css::uno::Reference<css::uno::XComponentContext > const & rxContext)