Make 3.0 parallel-installable to 2.x

[~andy/gtk] / docs / reference / gdk-pixbuf / tmpl / initialization_versions.sgml

diff --git a/docs/reference/gdk-pixbuf/tmpl/initialization_versions.sgml b/docs/reference/gdk-pixbuf/tmpl/initialization_versions.sgml
index 41302c27ca084250c73490b55d7cc9284e2c752a..b3cce4122bbd9c4c16c2be37cb4e67f128b2ab81 100644 (file)
--- a/docs/reference/gdk-pixbuf/tmpl/initialization_versions.sgml
+++ b/docs/reference/gdk-pixbuf/tmpl/initialization_versions.sgml
@@ -3,10 +3,12 @@ Initialization and Versions
 
 <!-- ##### SECTION Short_Description ##### -->
 
+Library version numbers.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+These macros and variables let you check the version of &gdk-pixbuf;
+you're linking against.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
@@ -14,61 +16,90 @@ Initialization and Versions
 
 </para>
 
-<!-- ##### FUNCTION gdk_pixbuf_init ##### -->
-<para>
+<!-- ##### SECTION Stability_Level ##### -->
 
-</para>
 
+<!-- ##### SECTION Image ##### -->
 
 
-<!-- ##### FUNCTION gdk_pixbuf_preinit ##### -->
+<!-- ##### VARIABLE gdk_pixbuf_version ##### -->
 <para>
-
+Contains the full version of the &gdk-pixbuf; library as a string.
+This is the version currently in use by a running program.
 </para>
 
-@app: 
-@modinfo: 
 
+<!-- ##### VARIABLE gdk_pixbuf_major_version ##### -->
+<para>
+The major version number of the &gdk-pixbuf; library.  (e.g. in 
+&gdk-pixbuf; version 1.2.5 this is 1.) 
+</para>
 
-<!-- ##### FUNCTION gdk_pixbuf_postinit ##### -->
 <para>
+This variable is in the library, so represents the
+&gdk-pixbuf; library you have linked against. Contrast with the
+#GDK_PIXBUF_MAJOR macro, which represents the major version of the
+&gdk-pixbuf; headers you have included.
+</para>
 
+
+<!-- ##### VARIABLE gdk_pixbuf_minor_version ##### -->
+<para>
+The minor version number of the &gdk-pixbuf; library.  (e.g. in 
+&gdk-pixbuf; version 1.2.5 this is 2.) 
 </para>
 
-@app: 
-@modinfo: 
+<para>
+This variable is in the library, so represents the
+&gdk-pixbuf; library you have linked against. Contrast with the
+#GDK_PIXBUF_MINOR macro, which represents the minor version of the
+&gdk-pixbuf; headers you have included.
+</para>
 
 
-<!-- ##### VARIABLE gdk_pixbuf_version ##### -->
+<!-- ##### VARIABLE gdk_pixbuf_micro_version ##### -->
 <para>
+The micro version number of the &gdk-pixbuf; library.  (e.g. in 
+&gdk-pixbuf; version 1.2.5 this is 5.) 
+</para>
 
+<para>
+This variable is in the library, so represents the
+&gdk-pixbuf; library you have linked against. Contrast with the
+#GDK_PIXBUF_MICRO macro, which represents the micro version of the
+&gdk-pixbuf; headers you have included.
 </para>
 
 
 <!-- ##### MACRO GDK_PIXBUF_VERSION ##### -->
 <para>
-
+Contains the full version of the &gdk-pixbuf; header as a string.
+This is the version being compiled against; contrast with
+#gdk_pixbuf_version.
 </para>
 
 
 
 <!-- ##### MACRO GDK_PIXBUF_MAJOR ##### -->
 <para>
-
+Major version of &gdk-pixbuf; library, that is the first "0" in
+"0.8.0" for example.
 </para>
 
 
 
 <!-- ##### MACRO GDK_PIXBUF_MINOR ##### -->
 <para>
-
+Minor version of &gdk-pixbuf; library, that is the "8" in
+"0.8.0" for example.
 </para>
 
 
 
 <!-- ##### MACRO GDK_PIXBUF_MICRO ##### -->
 <para>
-
+Micro version of &gdk-pixbuf; library, that is the last "0" in
+"0.8.0" for example.
 </para>