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


Hi Albert,

        First - thanks for helping out with this ! as you can see we have big
German comment problems, and it is simply great to have help improving
the situation: much appreciated :-)

On Wed, 2011-01-19 at 16:54 -0700, Tor Lillqvist wrote:
I don't think you need to be that careful here.  I think I can say with
confidence that boilerplate comments like the these:

        :-)

/*************************************************************************
|*
|*      RscTop::Size()
|*
|*      Beschreibung
|*      Ersterstellung        MM 29.10.91
|*      Letzte Aenderung      MM 29.10.91
|*
*************************************************************************/

are universally loathed by all developers.

        Right - a total waste of that non-renewable resource: vertical
lines :-)

        So - please do remove bogus comments that add no useful information
that is not immediately obvious from the context. eg. the RscTop::Size()
above might look useful - but is really just a copy of the name of the
method it doesn't really describe :-)

        Thanks !

                Michael.

-- 
 michael.meeks@novell.com  <><, Pseudo Engineer, itinerant idiot


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.