<html><head></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><br><div><div>On Jun 22, 2011, at 11:29 AM, Grzesiek Czajkowski wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite">Hi,<br></blockquote><div><br></div><div>Hi,</div><br><blockquote type="cite"><br>I am wondering why webkit has the most documentation in cpp files. In header files only classes, structures are documented. Is there any reason to do it in that way?<br><br>If we will have all documentation in header files client programmer will take devel package of webkit and he may generate a documentation by doxygen command. He doesn't need the sources of WebKit.<br></blockquote><div><br></div><div>In Qt we do the same because when a developer hack on the cpp files, the doc is right in front of his eyes, which means that there is more chance he will fix the doc and not forget about it. I also remember that it was done back in time so that when you just update the doc of an important file (included everywhere) you will not end up rebuilding *everything* because you changed the h file, i.e. you will only recompile the cpp file.</div><br><blockquote type="cite">
<br>Regards<br>Grzegorz<br><br><a href="mailto:grzes.czajkowski@gmail.com">grzes.czajkowski@gmail.com</a><br>
_______________________________________________<br>webkit-dev mailing list<br><a href="mailto:webkit-dev@lists.webkit.org">webkit-dev@lists.webkit.org</a><br>http://lists.webkit.org/mailman/listinfo.cgi/webkit-dev<br></blockquote></div><br></body></html>