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

Stephan Bergmann <sbergman -AT- redhat.com>

Fri, 20 Jan 2012 08:59:22 +0100

On 01/20/2012 03:19 AM, Norbert Thiebaud wrote:

commit 6ac30d8be976d60f56783327984b263fb1307e2a
Author: Norbert Thiebaud<nthiebaud@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

Context

Re: [Libreoffice] [Libreoffice-commits] clean-up Doxygen warnings · Stephan Bergmann

Privacy Policy | Impressum (Legal Info) | Copyright information: Unless otherwise specified, all text and images on this website are licensed under the Creative Commons Attribution-Share Alike 3.0 License. This does not include the source code of LibreOffice, which is licensed under the Mozilla Public License (MPLv2). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.