[Libreoffice] [Libreoffice-commits] clean-up Doxygen warnings

Stephan Bergmann sbergman at redhat.com
Thu Jan 19 23:59:22 PST 2012


On 01/20/2012 03:19 AM, Norbert Thiebaud wrote:
> commit 6ac30d8be976d60f56783327984b263fb1307e2a
> Author: Norbert Thiebaud<nthiebaud at gmail.com>
> Date:   Thu Jan 19 20:18:48 2012 -0600
>
>      clean-up Doxygen warnings
>
> diff --git a/cppuhelper/inc/cppuhelper/weak.hxx b/cppuhelper/inc/cppuhelper/weak.hxx
> index b8b9ddd..ceddbda 100644
> --- a/cppuhelper/inc/cppuhelper/weak.hxx
> +++ b/cppuhelper/inc/cppuhelper/weak.hxx
> @@ -130,8 +130,8 @@ public:
>           SAL_THROW( () )
>           { return *this; }
>
> -    /** Basic queryInterface() implementation supporting ::com::sun::star::uno::XWeak and
> -        ::com::sun::star::uno::XInterface.
> +    /** Basic queryInterface() implementation supporting \::com::sun::star::uno::XWeak and
> +        \::com::sun::star::uno::XInterface.

Another (simpler) solution is to just drop the leading :: from the name. 
  Doxygen apparently attaches specific meaning to that prefix (produce a 
link to the named entity, IIUC), and to preserve the meaning of the 
comment the prefix it is not really necessary.

Stephan


More information about the LibreOffice mailing list