Documentation?

[Thomas Dickey]

On Wed, 8 Apr 2009, Behdad Esfahbod wrote:

> On 04/08/2009 05:00 PM, Thomas Dickey wrote:
>> Well, I'd go to the source, rather than rely on comments.
>>
>> Quoting from
>>
>> 	http://cairographics.org/documentation/
>>
>> 	Documentation for cairo is an area that could always be greatly
>> 	improved.  Contributions are very welcome!
>
> So, because cairo maintainers recognize that good documentation is very
> important to the project's success and ask for everyone's help, it means it
> doesn't have good documentation?
>
>
>> doesn't sound promising.  Nor does
>>
>> 	Please download one of the latest releases in order to get an
>> 	API-stable version of cairo.
>
> Not sure where you are quoting this from.

 	http://cairographics.org/download/

(I was curious if there was some documentation there).

>> If only the latest release is "API-stable", by definition it's not stable.
>
> Have fun quoting out of context.

Not at all.  In each case, it's the first sentence on the page.
That should be the most informative.  Reading further on each page,
the quality does go down noticeably, so let's refrain from discussing
_that_.

(my expectation is that the webpage will say something nicer things than 
the sources themselves would on close inspection, so it was a good 
starting point).

-- 
Thomas E. Dickey
http://invisible-island.net
ftp://invisible-island.net