Hi martin I almost agree, but qgis is not only a lib but kind of framework. It's use is different tespect the use i van do with qt or gdal.
Not always I've the code available to investigate... but I generally have connection. In my point of view, api doc wasn't clutter Regards, luigi pirelli On 3 November 2014 12:40, Martin Dobias <wonder...@gmail.com> wrote: > Hi Luigi > > On Mon, Nov 3, 2014 at 5:06 PM, Luigi Pirelli <lui...@gmail.com> wrote: >> added a comment to the commit: >> >> I prefer old style documentation that help me to enter directly in the >> code to understand how it works. >> >> ok, I can create my own documentation, but I generally I find it more >> useful having it online > > The rationale was that users of the documentation should not need to > read the code of individual functions. If they do, then the > documentation is simply not good enough. Many other projects we use > (like Qt, GDAL, GEOS) do not include that either. Those links simply > make the documentation more bloated. Another reason is that if someone > needs to browse the code, any IDE with c++ support is 10x more > efficient for that. > > Cheers > Martin _______________________________________________ Qgis-developer mailing list Qgis-developer@lists.osgeo.org http://lists.osgeo.org/mailman/listinfo/qgis-developer