Re: [boost] GGL documentation issue

Subject: Re: [boost] GGL documentation issue
From: Barend Gehrels (barend_at_[hidden])
Date: 2009-11-18 15:55:56

Hi Thomas,

> a) Do you agree that the documentation of the "geometry concepts" is currently insufficient, because both the intended semantic meaning and the exact constraints on valid "values" for objects modeling the "geometric concepts" are not documented?
>
> You agree.
>   

Agree that it could be enhanced, but please add that we refer to OGC 
which documents the meaning of geometric semantics and concepts in detail.

>
> b) Why are there two examples that more or less contradict each other?
>
> Because you planned to introduce the concept of closeness at one time, but renounced on it for the review. 
>
>
> c) Is there a bug in the area function, or are both "Modules" -> "A Generic Geometry Library (web-copy of article for BoostCon'09)" and "Example" -> "c04_b_custom_triangle_example.cpp" wrong?
>
> There is no bug in the area function. If the concept of closeness would have been introduced, both "..." and "..." would have been correct. The example just demonstrates that this would be possible.
>   

Thanks for summarizing, yes, I agree on these formulations, with addition

Regards, Barend