Re: The future of monodoc.dll

Miguel de Icaza <[email protected]> Fri, 30 May 2008 19:53:41 -0400
Newsgroups gmane.comp.gnome.mono.documentation
Organization Novell, Inc.
Message-ID <1212191621.6334.91.camel@frost>
Hello,

> One of the things I'd like to do before the Mono 2.0 release is migrate
> monodoc.dll to use C# 2.0 features such as generics in the public API.
> For example, instead of Monodoc.Node.Nodes being an ArrayList, it should
> be an IEnumerable<Node> or IList<Node>, and Monodoc.Node should
> implement IComparable<Node>, etc.
> 
> However, I'm not sure that this can actually be done, as monodoc.dll is
> installed into the GAC, and such an API change would break any existing
> clients on upgrade.

We can consider monodoc.dll in the GAC as being an internal API, it was
never supposed to be an API set in stone, we never really advertised it,
and other than MonoDevelop, I do not believe there are many users of it.

So I would not sweat too much about it.

> 4. Something else?

This one ;-)

Its an internal API, lets just move ahead.

> Thoughts?
>  - Jon
> 
> 
> _______________________________________________
> Mono-docs-list maillist  -  [email protected]
> http://lists.ximian.com/mailman/listinfo/mono-docs-list
_______________________________________________
Mono-docs-list maillist  -  [email protected]
http://lists.ximian.com/mailman/listinfo/mono-docs-list