>> Personally I think it would be very nice if source files had just a few >> lines of comment telling what they are about, from a very high perspective. >> Every time I am searching for the implementation of some functionality in >> the OOo/LO codebase, I find myself looking at source files with vaguely >> correct sounding file names (and vaguely correctly sounding class names >> inside), but no clue if it actually is what I am looking for. >> >> (Yeah, now that we have forked off the codebase, I of course should take up >> the habit of adding such a few comment lines every time I find out what the >> code in some particular source file does, especially in cases where one can >> easily be mislead and spend hours looking at irrelevant code before >> realizing...) > > I think that would be very helpful.
Totally agree. Sometimes, after floundering around in the code for a while, I suddenly come across a comment, and things get *so much* clearer, and feel I find myself overcome with overwhelming gratitude towards the mysterious comment writing person. Even if it's short and cryptic. And in German. It helps that much. _______________________________________________ LibreOffice mailing list LibreOffice@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/libreoffice
