[Libreoffice] Script to find undocumented classes

[Mattias Johnsson]

>> 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.