[Mono-dev] patch for Mono.Cairo to rename Graphics to Context

[Mike Kestner]

On Tue, 2005-11-29 at 12:40 -0500, John Luke wrote:

> > [Obsolete ("Replaced by Cairo.Context")]
> > public class Graphics : Context {}
> > 
> I would rather not make the change if we have to add Obsolete API, I
> consider that an even more likely source of confusion.

Peter pointed me to this:

http://www.cairographics.org/manual/language-bindings.html

Which clearly supports the change.

As far as confusion with Obsolete API, we need to add some support to
monodoc for stuffing obsolete API onto a special page or at least
highlighting summaries for obsolete members/types. 

I guess we just need an official statement from Miguel as to whether the
Mono.Cairo API was ever declared stable.  It has shipped with stable
releases already, but I don't know if that alone carries an expectation
of stability.

Since the Gtk# exposure of Cairo.Graphics is so new and unstable, we
could probably get around the issue by simultaneously releasing a new
Gtk# with the next mono release.

We also need to address the issue of Mono.Cairo availability on win32
with the MS runtime.  We need to be able to build/ship Mono.Cairo
without mono on win32 for Gtk#.

-- 
Mike Kestner <mkestner at novell.com>