Re: [webkit-dev] API documentation in cpp files

2011-06-23 Thread Łukasz Ślachciak
W dniu 22.06.2011 18:27, Darin Adler pisze: For WebKit API header files, files intended to be used by the clients of WebKit outside the project, I think your proposal makes sense. For an example of a header file in WebKit that is done in this way, you could look at JavaScriptCore/API/JSObjectR

Re: [webkit-dev] API documentation in cpp files

2011-06-22 Thread Darin Adler
On Jun 22, 2011, at 7:29 AM, Grzesiek Czajkowski wrote: > 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? > > If we will have all documentation in header files client progra

Re: [webkit-dev] API documentation in cpp files

2011-06-22 Thread Alexis Menard
On Jun 22, 2011, at 11:29 AM, Grzesiek Czajkowski wrote: > Hi, Hi, > > 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? > > If we will have all documentation in header fi

[webkit-dev] API documentation in cpp files

2011-06-22 Thread Grzesiek Czajkowski
Hi, 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? If we will have all documentation in header files client programmer will take devel package of webkit and he may generate a doc