[Cairo] format for api docs

[Carl Worth]

On Oct 15, Thomas Hunger wrote:
 > Also the api is pretty small compared to gtk and not likely (?) to change in 
 > huge leaps in the near future, so an external documentation should
 > be fine. 

Precisely. It is definitely a goal of Cairo to have a small (mostly)
fixed API.

 > Is it docbook then, or rather html/latex or some other format? 

I've done some not-too-major documents in DocBook and I'm mostly happy
with it. It's also getting adopted fairly widely which is encouraging
in terms of long-term maintenance and stability.

One requirement for Cairo documentation is high-quality output on
multiple devices, (displays, printers, etc.). And from what I've seen,
DocBook is among the most promising systems for that.

-Carl