WaE: silence some documentation errors

This commit is contained in:
Thomas Arnhold 2012-02-21 23:16:31 +01:00
parent 41e8fe179f
commit b1073d9fa2
15 changed files with 25 additions and 26 deletions

View file

@ -126,7 +126,7 @@ public:
{ return * reinterpret_cast< const Type * >( &pType ); } { return * reinterpret_cast< const Type * >( &pType ); }
/** Gets the type of the set value. /** Gets the type of the set value.
@return the UNacquired type description reference of the set value @return the unacquired type description reference of the set value
*/ */
inline typelib_TypeDescriptionReference * SAL_CALL getValueTypeRef() const SAL_THROW(()) inline typelib_TypeDescriptionReference * SAL_CALL getValueTypeRef() const SAL_THROW(())
{ return pType; } { return pType; }
@ -134,7 +134,7 @@ public:
/** Gets the type description of the set value. Provides ownership of the type description! /** Gets the type description of the set value. Provides ownership of the type description!
Call an explicit typelib_typedescription_release() to release afterwards. Call an explicit typelib_typedescription_release() to release afterwards.
@param a pointer to type description pointer @param ppTypeDescr a pointer to type description pointer
*/ */
inline void SAL_CALL getValueTypeDescription( typelib_TypeDescription ** ppTypeDescr ) const SAL_THROW(()) inline void SAL_CALL getValueTypeDescription( typelib_TypeDescription ** ppTypeDescr ) const SAL_THROW(())
{ ::typelib_typedescriptionreference_getDescription( ppTypeDescr, pType ); } { ::typelib_typedescriptionreference_getDescription( ppTypeDescr, pType ); }

View file

@ -105,14 +105,14 @@ public:
/** Equality operator: compares two interfaces /** Equality operator: compares two interfaces
Checks if both references are null or refer to the same object. Checks if both references are null or refer to the same object.
@param rRef another interface @param pInterface another interface
@return true if both references are null or refer to the same object, false otherwise @return true if both references are null or refer to the same object, false otherwise
*/ */
inline sal_Bool SAL_CALL operator == ( XInterface * pInterface ) const SAL_THROW(()); inline sal_Bool SAL_CALL operator == ( XInterface * pInterface ) const SAL_THROW(());
/** Unequality operator: compares two interfaces /** Unequality operator: compares two interfaces
Checks if both references are null or refer to the same object. Checks if both references are null or refer to the same object.
@param rRef another interface @param pInterface another interface
@return false if both references are null or refer to the same object, true otherwise @return false if both references are null or refer to the same object, true otherwise
*/ */
inline sal_Bool SAL_CALL operator != ( XInterface * pInterface ) const SAL_THROW(()); inline sal_Bool SAL_CALL operator != ( XInterface * pInterface ) const SAL_THROW(());

View file

@ -115,7 +115,7 @@ public:
/** Constructor: Creates a copy of given elements. /** Constructor: Creates a copy of given elements.
@param pElement an array of elements @param pElements an array of elements
@param len length of array @param len length of array
*/ */
inline Sequence( const E * pElements, sal_Int32 len ); inline Sequence( const E * pElements, sal_Int32 len );

View file

@ -67,7 +67,7 @@ namespace cppu
/** Maps an any from the current to the thread-safe Environment, fills the passed any. /** Maps an any from the current to the thread-safe Environment, fills the passed any.
@param any the any to be mapped @param any the any to be mapped
@param the target any @param res the target any
@since UDK 3.2.7 @since UDK 3.2.7
*/ */
inline void shieldAny(cssu::Any const & any, cssu::Any * res) inline void shieldAny(cssu::Any const & any, cssu::Any * res)
@ -79,7 +79,7 @@ namespace cppu
/** Maps an any from the thread-safe Environment to the current one, fills the passed any. /** Maps an any from the thread-safe Environment to the current one, fills the passed any.
@param any the any to be mapped @param any the any to be mapped
@param the target any @param res the target any
@since UDK 3.2.7 @since UDK 3.2.7
*/ */
inline void unshieldAny(cssu::Any const & any, cssu::Any * res) inline void unshieldAny(cssu::Any const & any, cssu::Any * res)

View file

@ -587,7 +587,7 @@ CPPU_DLLPUBLIC void SAL_CALL typelib_typedescription_newUnion(
@param ppRet inout enum type description @param ppRet inout enum type description
@param pTypeName name of enum @param pTypeName name of enum
@param nDefaultEnumValue default enum value @param nDefaultValue default enum value
@param nEnumValues number of enum values @param nEnumValues number of enum values
@param ppEnumNames names of enum values @param ppEnumNames names of enum values
@param pEnumValues enum values @param pEnumValues enum values
@ -628,7 +628,7 @@ CPPU_DLLPUBLIC void SAL_CALL typelib_typedescription_newArray(
@param pType sequence, array: element type; @param pType sequence, array: element type;
struct, Exception: base type; struct, Exception: base type;
@param nMembers number of members if struct, exception @param nMembers number of members if struct, exception
@param pMember array of members if struct, exception @param pMembers array of members if struct, exception
*/ */
CPPU_DLLPUBLIC void SAL_CALL typelib_typedescription_new( CPPU_DLLPUBLIC void SAL_CALL typelib_typedescription_new(
typelib_TypeDescription ** ppRet, typelib_TypeDescription ** ppRet,
@ -645,7 +645,7 @@ CPPU_DLLPUBLIC void SAL_CALL typelib_typedescription_new(
@param pTypeName name of type @param pTypeName name of type
@param pType base type; @param pType base type;
@param nMembers number of members @param nMembers number of members
@param pMember array of members @param pMembers array of members
@since UDK 3.2.0 @since UDK 3.2.0
*/ */
@ -692,7 +692,7 @@ CPPU_DLLPUBLIC void SAL_CALL typelib_typedescription_newInterface(
@param nUik4 uik part @param nUik4 uik part
@param nUik5 uik part @param nUik5 uik part
@param nBaseInterfaces number of base interface types @param nBaseInterfaces number of base interface types
@param ppBaseInterface base interface types @param ppBaseInterfaces base interface types
@param nMembers number of members @param nMembers number of members
@param ppMembers members; attributes or methods @param ppMembers members; attributes or methods
@ -713,7 +713,7 @@ CPPU_DLLPUBLIC void SAL_CALL typelib_typedescription_newMIInterface(
@param ppRet inout method type description @param ppRet inout method type description
@param nAbsolutePosition position of member including all members of base interfaces @param nAbsolutePosition position of member including all members of base interfaces
@param bOneWay determines whether method is declared oneway @param bOneWay determines whether method is declared oneway
@param pTypeName fully qualified name of method including interface name @param pMethodName fully qualified name of method including interface name
@param eReturnTypeClass type class of return type @param eReturnTypeClass type class of return type
@param pReturnTypeName type name of the return type @param pReturnTypeName type name of the return type
@param nParams number of parameters @param nParams number of parameters
@ -1132,7 +1132,7 @@ CPPU_DLLPUBLIC void SAL_CALL typelib_static_mi_interface_type_init(
@param ppRef pointer to type reference pointer @param ppRef pointer to type reference pointer
@param pTypeName name of enum @param pTypeName name of enum
@param nDefaultEnumValue default enum value @param nDefaultValue default enum value
*/ */
CPPU_DLLPUBLIC void SAL_CALL typelib_static_enum_type_init( CPPU_DLLPUBLIC void SAL_CALL typelib_static_enum_type_init(
typelib_TypeDescriptionReference ** ppRef, typelib_TypeDescriptionReference ** ppRef,

View file

@ -86,7 +86,7 @@ CPPU_DLLPUBLIC void SAL_CALL uno_any_assign(
@param pDest pointer memory of destination any @param pDest pointer memory of destination any
@param pSource pointer to source value; defaults (0) to default constructed value @param pSource pointer to source value; defaults (0) to default constructed value
@param pTypeDescr type description of value; defaults (0) to void @param pType type description of value; defaults (0) to void
@param acquire function called each time an interface needs to be acquired; @param acquire function called each time an interface needs to be acquired;
defaults (0) to uno defaults (0) to uno
@param release function called each time an interface needs to be released; @param release function called each time an interface needs to be released;

View file

@ -368,7 +368,7 @@ CPPU_DLLPUBLIC void SAL_CALL uno_Environment_enter(uno_Environment * pEnv)
that objects of that environment might be called. that objects of that environment might be called.
@param pEnv the environment @param pEnv the environment
@param rtl_uString ** pReason the reason, if it is not valid @param pReason the reason, if it is not valid
@return 1 == valid, 0 == invalid @return 1 == valid, 0 == invalid
@since UDK 3.2.7 @since UDK 3.2.7
*/ */

View file

@ -60,7 +60,7 @@ class Environment
public: public:
/** Returns the current Environment. /** Returns the current Environment.
@param env_type the optional type of the Environment, falls back to "uno" in case being empty, @param typeName the optional type of the Environment, falls back to "uno" in case being empty,
respectively to current C++ Environment. respectively to current C++ Environment.
@since UDK 3.2.7 @since UDK 3.2.7
*/ */

View file

@ -97,8 +97,8 @@ public:
/** Holds a mapping from the specified source to the specified destination /** Holds a mapping from the specified source to the specified destination
environment. environment.
@param from source environment @param rFrom source environment
@param to destination environment @param rTo destination environment
@param rAddPurpose additional purpose @param rAddPurpose additional purpose
*/ */
inline Mapping(const Environment & rFrom, const Environment & rTo, inline Mapping(const Environment & rFrom, const Environment & rTo,

View file

@ -61,7 +61,7 @@ public:
SAL_THROW( (::com::sun::star::uno::RuntimeException) ); SAL_THROW( (::com::sun::star::uno::RuntimeException) );
/** Copy ctor. /** Copy ctor.
@param another object @param ac another object
*/ */
AccessControl( ::cppu::AccessControl const & ac ) AccessControl( ::cppu::AccessControl const & ac )
SAL_THROW( (::com::sun::star::uno::RuntimeException) ); SAL_THROW( (::com::sun::star::uno::RuntimeException) );

View file

@ -113,7 +113,7 @@ public:
/** Constructor. /** Constructor.
@param buffer points to the binary data block. @param buffer points to the binary data block.
@param bufferlen specifies the size of the binary data block. @param bufferLen specifies the size of the binary data block.
@param copyData specifies if the data block should be copied. @param copyData specifies if the data block should be copied.
The block can be copied to ensure that the data The block can be copied to ensure that the data
is valid for the lifetime of this instance. is valid for the lifetime of this instance.
@ -261,7 +261,7 @@ public:
/** returns the full qualified exception type of the specified exception. /** returns the full qualified exception type of the specified exception.
@param index indicates the method @param index indicates the method
@param paramIndex indeciates the exception which typename will be returned. @param excIndex indeciates the exception which typename will be returned.
*/ */
inline ::rtl::OUString getMethodExcType( sal_uInt16 index, sal_uInt16 excIndex ) const; inline ::rtl::OUString getMethodExcType( sal_uInt16 index, sal_uInt16 excIndex ) const;
@ -272,7 +272,6 @@ public:
/** returns the full qualified exception type of the specified exception. /** returns the full qualified exception type of the specified exception.
@param index indicates the method @param index indicates the method
@param paramIndex indeciates the exception which typename will be returned.
*/ */
inline RTMethodMode getMethodMode( sal_uInt16 index ) const; inline RTMethodMode getMethodMode( sal_uInt16 index ) const;

View file

@ -163,7 +163,7 @@ public:
@param index indicates the index of the method. @param index indicates the index of the method.
@param name specifies the name. @param name specifies the name.
@param typeName specifies the full qualified return typename. @param returnTypeName specifies the full qualified return typename.
@param mode specifies the method mode. @param mode specifies the method mode.
@param paramCount specifies the number of parameters. @param paramCount specifies the number of parameters.
@param excCount specifies the number of exceptions. @param excCount specifies the number of exceptions.

View file

@ -376,7 +376,7 @@ RegError REGISTRY_CALLTYPE reg_createRegistry(rtl_uString* registryName,
/** This function opens the root key of a registry. /** This function opens the root key of a registry.
@param hReg identifies a currently open registry whose rootKey will be returned. @param hRegistry identifies a currently open registry whose rootKey will be returned.
@param phRootKey points to a handle of the open root key if the function succeeds otherwise NULL. @param phRootKey points to a handle of the open root key if the function succeeds otherwise NULL.
@return REG_NO_ERROR if succeeds else an error code. @return REG_NO_ERROR if succeeds else an error code.
*/ */

View file

@ -493,7 +493,7 @@ public:
If keyName is an empty string, the value will be set for the key If keyName is an empty string, the value will be set for the key
specified by hKey. specified by hKey.
@param valueType specifies the type of the value. @param valueType specifies the type of the value.
@param pData points to a memory block containing the data for the value. @param pValue points to a memory block containing the data for the value.
@param valueSize specifies the size of pData in bytes @param valueSize specifies the size of pData in bytes
@return REG_NO_ERROR if succeeds else an error code. @return REG_NO_ERROR if succeeds else an error code.
*/ */

View file

@ -222,7 +222,7 @@ typedef void* storeStreamHandle;
@param hFile [in] the File Handle. @param hFile [in] the File Handle.
@param pPath [in] the stream path. @param pPath [in] the stream path.
@param pName [in] the stream name. @param pName [in] the stream name.
@param eAccessMode [in] the access mode. @param eMode [in] the access mode.
@param phStrm [out] the Stream Handle. @param phStrm [out] the Stream Handle.
@return store_E_None upon success @return store_E_None upon success
*/ */