Re: migration document missing
On Fri, Feb 11, 2011 at 12:14:16AM -0500, Colin Walters wrote: > Well, I think the easiest thing is to explain at the top of each > version, like I did for 3. Though now that library can parallel > display the two I need to update it to say GTK+ 2 is at /gtk and GTK3 > is at /gtk3. Perhaps easiest to have the latest version (gtk3) be 'gtk' and the previous version 'gtk2'? -- Regards, Olav ___ gtk-devel-list mailing list gtk-devel-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-devel-list
Re: [gobject-introspection] How should name collisions be resolved
On Thu, Feb 10, 2011 at 12:14 PM, Alan wrote: > In .NET it is invalid to generate a property or a method which is the > same name as an event as it is ambiguous as to whether you're invoking > the event or calling the method. Yeah, this fits into a general class of corner case restrictions from a language mapping. Similar to adding methods to a GObject interface is OK in C, but an API break in the obvious Java and .NET mapping. I think it'd be reasonable to add warnings for this to the introspection scanner, but that doesn't help all the existing code out there like GTK3 that just got released. Related to this is the issue of language keywords; for example you could call a method gtk_widget_switch () or something fine in C, but then you end up with mywidget.switch() which is a problem since it's a keyword. > What are peoples opinions on taking care of this in the gir format and > using the "renameto" feature to avoid the collision in all languages? > Is this feasible? Are there any better ways of handling this kind of > case? We can do this for GTK3; but I'm loathe to use Rename-to except as a binding band aid on top of a library that's already shipped. It has the compound problem that all of a sudden the *old* name isn't accessible, and there was a possibility something was using it. ___ gtk-devel-list mailing list gtk-devel-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-devel-list
Re: migration document missing
On Fri, Feb 11, 2011 at 12:14 AM, Colin Walters wrote: > Well, I think the easiest thing is to explain at the top of each > version, like I did for 3. Though now that library can parallel > display the two I need to update it to say GTK+ 2 is at /gtk and GTK3 > is at /gtk3. I updated the links before the release. > Similarly it would make sense to have the GTK+ 2 docs mention GTK3. This is a good idea, indeed. ___ gtk-devel-list mailing list gtk-devel-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-devel-list
Re: migration document missing
On Fri, Feb 11, 2011 at 10:14 AM, Matthias Clasen wrote: > >> Similarly it would make sense to have the GTK+ 2 docs mention GTK3. > > This is a good idea, indeed. How about these two patches for GTK3 and GTK2 respectively? Not tested, building now. From ad4cf7915e28503d1952c2a8b17628e52f646e00 Mon Sep 17 00:00:00 2001 From: Colin Walters Date: Fri, 11 Feb 2011 11:59:01 -0500 Subject: [PATCH] docs: Link to all GTK+ 3 versions, fix GTK2 link Now that we have both URLs on library.gnome.org, improve the links so that we point at all versions of both. --- docs/reference/gtk/gtk-docs.sgml |9 ++--- 1 files changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/reference/gtk/gtk-docs.sgml b/docs/reference/gtk/gtk-docs.sgml index 0274da7..36f1ded 100644 --- a/docs/reference/gtk/gtk-docs.sgml +++ b/docs/reference/gtk/gtk-docs.sgml @@ -10,9 +10,12 @@ GTK+ 3 Reference Manual - This document is for GTK+ 3 library; the latest version can be found online at - http://library.gnome.org/devel/gtk/unstable/";>http://library.gnome.org/devel/gtk/unstable/. - If you're looking for the older GTK+ 2 series of libraries, they can be found under their version numbers; for example, 2.22 is available at http://library.gnome.org/devel/gtk/2.22/";>http://library.gnome.org/devel/gtk/2.22/. + This document is for GTK+ 3 library; the latest versions can be found online at + http://library.gnome.org/devel/gtk/";>http://library.gnome.org/devel/gtk/. + If you're looking for the older GTK+ 2 series of libraries, + see http://library.gnome.org/devel/gtk/";>http://library.gnome.org/devel/gtk/. -- 1.7.4 From 0a2e148d3c5804bbe635d113b185742826a24e65 Mon Sep 17 00:00:00 2001 From: Colin Walters Date: Fri, 11 Feb 2011 12:00:05 -0500 Subject: [PATCH] docs: Link to all GTK+ 2 versions, add GTK+ 3 link Now that we have both URLs on library.gnome.org, improve the links so that we point at all versions of both. --- docs/reference/gtk/gtk-docs.sgml | 11 +++ 1 files changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/reference/gtk/gtk-docs.sgml b/docs/reference/gtk/gtk-docs.sgml index f71c998..e95499f 100644 --- a/docs/reference/gtk/gtk-docs.sgml +++ b/docs/reference/gtk/gtk-docs.sgml @@ -7,11 +7,14 @@ http://www.w3.org/2003/XInclude";> -GTK+ Reference Manual +GTK+ 2 Reference Manual - for GTK+ &version; - The latest version of this documentation can be found on-line at - http://library.gnome.org/devel/gtk/unstable/";>http://library.gnome.org/devel/gtk/unstable/. + This document is for the GTK+ 2 library; the latest versions can be found online at + http://library.gnome.org/devel/gtk/";>http://library.gnome.org/devel/gtk. + If you're looking for the newer GTK+ 3 series of libraries, + see http://library.gnome.org/devel/gtk3/";>http://library.gnome.org/devel/gtk3/. -- 1.7.4 ___ gtk-devel-list mailing list gtk-devel-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-devel-list
Re: migration document missing
On Fri, Feb 11, 2011 at 12:01 PM, Colin Walters wrote: > On Fri, Feb 11, 2011 at 10:14 AM, Matthias Clasen > wrote: >> >>> Similarly it would make sense to have the GTK+ 2 docs mention GTK3. >> >> This is a good idea, indeed. > > How about these two patches for GTK3 and GTK2 respectively? Not > tested, building now. > Looks fine in principle, but please apply the corresponding changes to the gdk manuals as well. ___ gtk-devel-list mailing list gtk-devel-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-devel-list