[gtk+] Clarify documentation header about GTK+ 3 vs 2



commit 22527e802cf0b102bda640b4c30fda1fa13913eb
Author: Colin Walters <walters verbum org>
Date:   Thu Jan 27 11:19:51 2011 -0500

    Clarify documentation header about GTK+ 3 vs 2
    
    I think it's confusing for a lot the developers out there who
    may not even be aware of GTK+ 3 coming, if suddenly GTK+ 3 becomes
    the "stable" version of "gtk" on library.gnome.org.  It may
    not even be feasible for them to port to GTK+3 if it's not
    shipped in the operating systems they're targeting (for example,
    RHEL 6).
    
    Since practically speaking, we expect people to consume GTK+ 2 for
    several years at least, redirect these people to the right pages.
    
    (I didn't attempt to explain the differences between the libraries
     here, but hopefully the major version difference is enough of a hint)
    
    As a side effect, this makes the generated HTML look better; previously
    it looked rather crappy, since the "for GTK &version;" was totally
    offset and in a different group from the documentation title.

 docs/reference/gtk/gtk-docs.sgml |    8 ++++----
 1 files changed, 4 insertions(+), 4 deletions(-)
---
diff --git a/docs/reference/gtk/gtk-docs.sgml b/docs/reference/gtk/gtk-docs.sgml
index 9f57e97..0274da7 100644
--- a/docs/reference/gtk/gtk-docs.sgml
+++ b/docs/reference/gtk/gtk-docs.sgml
@@ -8,11 +8,11 @@
 ]>
 <book id="index" xmlns:xi="http://www.w3.org/2003/XInclude";>
   <bookinfo>
-    <title>GTK+ Reference Manual</title>
+    <title>GTK+ 3 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 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>.
     </releaseinfo>
   </bookinfo>
 



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]