diff --git a/docs/reference/glib/tmpl/.gitignore b/docs/reference/glib/tmpl/.gitignore
index 2d9b777cc..eb37d583a 100644
--- a/docs/reference/glib/tmpl/.gitignore
+++ b/docs/reference/glib/tmpl/.gitignore
@@ -30,6 +30,7 @@ misc_utils.sgml
option.sgml
patterns.sgml
quarks.sgml
+queue.sgml
random_numbers.sgml
relations.sgml
sequence.sgml
@@ -42,3 +43,4 @@ trees-binary.sgml
trees-nary.sgml
timers.sgml
timezone.sgml
+version.sgml
diff --git a/docs/reference/glib/tmpl/version.sgml b/docs/reference/glib/tmpl/version.sgml
deleted file mode 100644
index 027a0f456..000000000
--- a/docs/reference/glib/tmpl/version.sgml
+++ /dev/null
@@ -1,115 +0,0 @@
-
-Version Information
-
-
-Variables and functions to check the GLib version
-
-
-
-GLib provides version information, primarily useful in configure checks
-for builds that have a configure script. Applications will not
-typically use the features described here.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-@required_major:
-@required_minor:
-@required_micro:
-@Returns:
-
-
-
-
-The major version number of the GLib library.
-Like #glib_major_version, but from the headers used at
-application compile time, rather than from the library linked against
-at application run time.
-
-
-
-
-
-
-The minor version number of the GLib library.
-Like #gtk_minor_version, but from the headers used at
-application compile time, rather than from the library linked against
-at application run time.
-
-
-
-
-
-
-The micro version number of the GLib library.
-Like #gtk_micro_version, but from the headers used at
-application compile time, rather than from the library linked against
-at application run time.
-
-
-
-
-
-
-Checks the version of the GLib library.
-Returns %TRUE if the version of the GLib header files is the same
-as or newer than the passed-in version.
-
-
-Checking the version of the GLib library
-
- if (!GLIB_CHECK_VERSION (1, 2, 0))
- g_error ("GLib version 1.2.0 or above is needed");
-
-
-
-
-@major: the major version number.
-@minor: the minor version number.
-@micro: the micro version number.
-
-
diff --git a/glib/gutils.c b/glib/gutils.c
index a48725788..de7f41e2b 100644
--- a/glib/gutils.c
+++ b/glib/gutils.c
@@ -28,6 +28,46 @@
* MT safe for the unix part, FIXME: make the win32 part MT safe as well.
*/
+/**
+ * SECTION:version
+ * @Title: Version Information
+ * @Short_description: Variables and functions to check the GLib version
+ *
+ * GLib provides version information, primarily useful in configure
+ * checks for builds that have a configure script. Applications will
+ * not typically use the features described here.
+ */
+
+/**
+ * GLIB_MAJOR_VERSION:
+ *
+ * The major version number of the GLib library.
+ *
+ * Like #glib_major_version, but from the headers used at
+ * application compile time, rather than from the library
+ * linked against at application run time.
+ */
+
+/**
+ * GLIB_MINOR_VERSION:
+ *
+ * The minor version number of the GLib library.
+ *
+ * Like #gtk_minor_version, but from the headers used at
+ * application compile time, rather than from the library
+ * linked against at application run time.
+ */
+
+/**
+ * GLIB_MICRO_VERSION:
+ *
+ * The micro version number of the GLib library.
+ *
+ * Like #gtk_micro_version, but from the headers used at
+ * application compile time, rather than from the library
+ * linked against at application run time.
+ */
+
#include "config.h"
#ifdef HAVE_UNISTD_H
diff --git a/glib/gutils.h b/glib/gutils.h
index a07097104..a082903c0 100644
--- a/glib/gutils.h
+++ b/glib/gutils.h
@@ -446,6 +446,24 @@ const gchar * glib_check_version (guint required_major,
guint required_minor,
guint required_micro);
+/**
+ * GLIB_CHECK_VERSION:
+ * @major: the major version to check for
+ * @minor: the minor version to check for
+ * @micro: the micro version to check for
+ *
+ * Checks the version of the GLib library.
+ * Returns %TRUE if the version of the GLib header files
+ * is the same as or newer than the passed-in version.
+ *
+ *
+ * Checking the version of the GLib library
+ *
+ * if (!GLIB_CHECK_VERSION (1, 2, 0))
+ * g_error ("GLib version 1.2.0 or above is needed");
+ *
+ *
+ */
#define GLIB_CHECK_VERSION(major,minor,micro) \
(GLIB_MAJOR_VERSION > (major) || \
(GLIB_MAJOR_VERSION == (major) && GLIB_MINOR_VERSION > (minor)) || \