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: migration document missing
On Fri, Feb 11, 2011 at 12:14 AM, Colin Walters walt...@verbum.org 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 matthias.cla...@gmail.com 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 walt...@verbum.org 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 @@ bookinfo titleGTK+ 3 Reference Manual/title releaseinfo - This document is for GTK+ 3 library; the latest version can be found online at - ulink role=online-location url=http://library.gnome.org/devel/gtk/unstable/;http://library.gnome.org/devel/gtk/unstable//ulink. - 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 ulink role=online-location url=http://library.gnome.org/devel/gtk/2.22/;http://library.gnome.org/devel/gtk/2.22//ulink. + This document is for GTK+ 3 library; the latest versions can be found online at + ulink role=online-location + url=http://library.gnome.org/devel/gtk/;http://library.gnome.org/devel/gtk//ulink. + If you're looking for the older GTK+ 2 series of libraries, + see ulink role=online-location + url=http://library.gnome.org/devel/gtk/;http://library.gnome.org/devel/gtk//ulink. /releaseinfo /bookinfo -- 1.7.4 From 0a2e148d3c5804bbe635d113b185742826a24e65 Mon Sep 17 00:00:00 2001 From: Colin Walters walt...@verbum.org 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 @@ !--ENTITY index-Objects-Grouped SYSTEM objects_grouped.sgml-- book id=index xmlns:xi=http://www.w3.org/2003/XInclude; bookinfo -titleGTK+ Reference Manual/title +titleGTK+ 2 Reference Manual/title releaseinfo - for GTK+ version; - The latest version of this documentation can be found on-line at - ulink role=online-location url=http://library.gnome.org/devel/gtk/unstable/;http://library.gnome.org/devel/gtk/unstable//ulink. + This document is for the GTK+ 2 library; the latest versions can be found online at + ulink role=online-location + url=http://library.gnome.org/devel/gtk/;http://library.gnome.org/devel/gtk/ulink. + If you're looking for the newer GTK+ 3 series of libraries, + see ulink role=online-location + url=http://library.gnome.org/devel/gtk3/;http://library.gnome.org/devel/gtk3//ulink. /releaseinfo /bookinfo -- 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 walt...@verbum.org wrote: On Fri, Feb 11, 2011 at 10:14 AM, Matthias Clasen matthias.cla...@gmail.com 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
migration document missing
the migration doc mentioned in matthias' email announcement is 404'd ___ gtk-devel-list mailing list gtk-devel-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-devel-list
Re: migration document missing
On Thu, Feb 10, 2011 at 4:05 PM, Paul Davis p...@linuxaudiosystems.com wrote: the migration doc mentioned in matthias' email announcement is 404'd as is the common questions document. ___ gtk-devel-list mailing list gtk-devel-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-devel-list
Re: migration document missing
On Thu, Feb 10, 2011 at 4:05 PM, Paul Davis p...@linuxaudiosystems.com wrote: the migration doc mentioned in matthias' email announcement is 404'd Should be there now, I think. ___ gtk-devel-list mailing list gtk-devel-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-devel-list
Re: migration document missing
On Thu, 2011-02-10 at 16:05 -0500, Paul Davis wrote: the migration doc mentioned in matthias' email announcement is 404'd yes, library.gnome.org will take just a bit to pick it up from the tarball. ciao, Emmanuele. -- W: http://www.emmanuelebassi.name B: http://blogs.gnome.org/ebassi ___ gtk-devel-list mailing list gtk-devel-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-devel-list
Re: migration document missing
On Thu, 2011-02-10 at 22:24 +0100, Tadej Borovšak wrote: http://library.gnome.org/devel/gtk3/unstable/gtk-migrating-2-to-3.html Any reason not to have the URLs at .../gtk/3.0/... ? AfC Sydney ___ 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, 2011-02-11 at 10:00 +1100, Andrew Cowie wrote: On Thu, 2011-02-10 at 22:24 +0100, Tadej Borovšak wrote: http://library.gnome.org/devel/gtk3/unstable/gtk-migrating-2-to-3.html Any reason not to have the URLs at .../gtk/3.0/... ? It's there now. It takes library.gnome.org a little while to notice and build documents from new releases. The material under /unstable/ is there from previous 2.9x releases. -- Shaun ___ gtk-devel-list mailing list gtk-devel-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-devel-list
Re: migration document missing
On Thu, 2011-02-10 at 19:47 -0500, Shaun McCance wrote: On Fri, 2011-02-11 at 10:00 +1100, Andrew Cowie wrote: On Thu, 2011-02-10 at 22:24 +0100, Tadej Borovšak wrote: http://library.gnome.org/devel/gtk3/unstable/gtk-migrating-2-to-3.html Any reason not to have the URLs at .../gtk/3.0/... ? It's there now. Really? Here we get: http://library.gnome.org/devel/gtk/3.0/gtk-migrating-2-to-3.html http://library.gnome.org/devel/gtk/stable/gtk-migrating-2-to-3.html 404 I just noticed that other /gtk/stable/ URLs point to GTK 2.24; is GTK 3.0 now not the stable release? Regardless, I still don't understand: http://library.gnome.org/devel/gtk/2.24/GtkWindow.html http://library.gnome.org/devel/gtk/3.0/GtkWindow.html What's the parallel filename problem? AfC Sydney ___ gtk-devel-list mailing list gtk-devel-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-devel-list
Re: migration document missing
On Thu, Feb 10, 2011 at 10:03 PM, Andrew Cowie and...@operationaldynamics.com wrote: On Thu, 2011-02-10 at 19:47 -0500, Shaun McCance wrote: On Fri, 2011-02-11 at 10:00 +1100, Andrew Cowie wrote: On Thu, 2011-02-10 at 22:24 +0100, Tadej Borovšak wrote: http://library.gnome.org/devel/gtk3/unstable/gtk-migrating-2-to-3.html Any reason not to have the URLs at .../gtk/3.0/... ? It's there now. Really? Here we get: http://library.gnome.org/devel/gtk/3.0/gtk-migrating-2-to-3.html http://library.gnome.org/devel/gtk/stable/gtk-migrating-2-to-3.html 404 I just noticed that other /gtk/stable/ URLs point to GTK 2.24; is GTK 3.0 now not the stable release? Regardless, I still don't understand: We essentially now have a stable 2.x release (2.24) and a stable 3.0 release. library.gnome.org shows them as http://library.gnome.org/devel/gtk/stable and http://library.gnome.org/devel/gtk3/stable. which I think is clear enough. http://library.gnome.org/devel/gtk/2.24/GtkWindow.html http://library.gnome.org/devel/gtk/3.0/GtkWindow.html What's the parallel filename problem? The filename problem happens in local packages. Could it have been solved by embedding the version number in the path ? Certainly. But thats not how gtk-doc is set up to work... ___ 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, 2011-02-11 at 14:03 +1100, Andrew Cowie wrote: On Thu, 2011-02-10 at 19:47 -0500, Shaun McCance wrote: On Fri, 2011-02-11 at 10:00 +1100, Andrew Cowie wrote: On Thu, 2011-02-10 at 22:24 +0100, Tadej Borovšak wrote: http://library.gnome.org/devel/gtk3/unstable/gtk-migrating-2-to-3.html Any reason not to have the URLs at .../gtk/3.0/... ? It's there now. Really? Here we get: http://library.gnome.org/devel/gtk/3.0/gtk-migrating-2-to-3.html http://library.gnome.org/devel/gtk/stable/gtk-migrating-2-to-3.html 404 I just noticed that other /gtk/stable/ URLs point to GTK 2.24; is GTK 3.0 now not the stable release? Regardless, I still don't understand: http://library.gnome.org/devel/gtk/2.24/GtkWindow.html http://library.gnome.org/devel/gtk/3.0/GtkWindow.html What's the parallel filename problem? My fault. I missed that you asked why it's /gtk3/ instead of just /gtk/. I just answered the bit about /unstable/ instead of /3.0/. Because GTK+ 3.x is parallel-installable with 2.x, every file it installs has to be in a different location. That includes its API reference documentation. And library.gnome.org just uses that information when determining where to plop files on the web server. I can see how this could lead some users to get to the wrong place though. Even with navigation and layout that pushes people towards the 3.0 stack, the URLs are so predictable that it's not unreasonable to expect somebody might just type /gtk/stable/ into their location bar. Perhaps we could teach library some tricks with versioned libraries. Frederic Peters would know best. -- Shaun ___ 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:05 AM, Shaun McCance sha...@gnome.org wrote: I can see how this could lead some users to get to the wrong place though. Even with navigation and layout that pushes people towards the 3.0 stack, the URLs are so predictable that it's not unreasonable to expect somebody might just type /gtk/stable/ into their location bar. 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. Similarly it would make sense to have the GTK+ 2 docs mention GTK3. ___ gtk-devel-list mailing list gtk-devel-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-devel-list