Date: prev next · Thread: first prev next last
2013 Archives by date, by thread · List index


Hi Matthias,

Thank you for your patch!  Only a small nitpick:

Matthias Freund (via Code Review) píše v Ne 17. 03. 2013 v 22:17 +0000:
 
-                        /* #108049# Only move instead of deleting if we
+                        /** #108049# Only move instead of deleting if we
                             have moved to a different cell */
                         if (pSNdOld != pSNdNew)
                         {

This is not really wanted here [though it does not harm, of course :-)].
The '/**' (or similarly '///') means a comment that a tool 'doxygen'
uses to generate documentation (at http://docs.libreoffice.org).  That
means, such marks have their use in front of a class or method
declaration or definition (where they are picked up by doxygen), but not
inside a method itself.

OTOH, if you see a comment that would make a sense to turn into the
doxygen comment, please go for that! - mostly in cases like:

-// Some description of a class
+/// Some description of a class
 class SomeClass : public AnotherClass {

where it helps tremendously :-)  More info about the generated
documentation is here:

https://wiki.documentfoundation.org/Development/Doxygen

Looking forward to more translations from you! :-)

All the best,
Kendy


Context


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.