On Wednesday 01 of December 2010, Thorsten Behrens wrote: > see? That's what I meant, documentation for most of the higher-level > methods is either > > a) superficial > b) so much prose that you're better off debugging the code in the > first place > > (bFull has *a lot* of side effects, and no, I did not bother to > research all of them for the while)
See? So nobody actually knows what the code really does, and everytime somebody changes something there, they possibly have a slightly different understanding of the purpose, resulting in even bigger mess. That's yet another advantage of documentation - even you yourself are reminded of what the code is supposed to do, and everybody touching such code is less likely to run into a different direction. -- Lubos Lunak l.lu...@suse.cz _______________________________________________ LibreOffice mailing list LibreOffice@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/libreoffice
