Geometry Boost List: [ggl] Re: Started quickbook doc

Subject: [ggl] Re: Started quickbook doc
From: Mateusz Loskot (mateusz)
Date: 2009-12-03 19:17:57

Barend Gehrels wrote:
> Mateusz Loskot wrote:
>> I checked proto and it confirms my concern I think:
>> - documentation is not complete, only partially documented public
>> interfaces, so one still needs to dig the source code to find missing
>> details
>> - in headers where it's farily complete, definitions are short it's, but
>>  docs make source bulky (proto/domain.hpp, 170 lines file with 80 lines
>> of comments).
> 
> So let's defer it and first look how the (start of the) QuickBook
> documentation will look like, including reference section with function
> documentation. So that will probably be the way to take. If
> satisfactory, we can remove the doxygen stuff from the code.

Yes, good plan.

Best regards,
-- 
Mateusz Loskot, http://mateusz.loskot.net
Charter Member of OSGeo, http://osgeo.org