On 06/06/12 16:46, Philipp Weissenbacher wrote:
Hi all,
Is it ok to remove visual navigator comments (starting and ending with
****** and only containing the function's name)?
E.g. what I did in fe436d.
In my experience this greatly reduces visual noise to the cost of visual
separation. Or am I missing something?
yes if they only contain the name of the method, or empty lines that
start with "Description: " :) then they're just useless clutter.
it is more useful if it separates a chunk of related stuff from another
chunk of related stuff, e.g. if there are multiple classes implemented
in one file it can be nice to have a separator between the methods of
different classes, but this should usually result in a number of
separators in a file that can be counted on one hand.
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.