1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
1999-09-22 21:30:57 +00:00
|
|
|
Version Information
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2002-11-29 23:08:54 +00:00
|
|
|
Variables and functions to check the GTK+ version
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2001-09-08 04:39:53 +00:00
|
|
|
GTK+ provides version information, primarily useful in configure checks
|
|
|
|
for builds that have a configure script. Applications will not
|
|
|
|
typically use the features described here.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2005-06-20 22:06:27 +00:00
|
|
|
<!-- ##### SECTION Stability_Level ##### -->
|
|
|
|
|
|
|
|
|
2010-05-08 05:18:53 +00:00
|
|
|
<!-- ##### SECTION Image ##### -->
|
|
|
|
|
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### VARIABLE gtk_major_version ##### -->
|
|
|
|
<para>
|
2001-09-08 04:39:53 +00:00
|
|
|
The major version number of the GTK+ library. (e.g. in GTK+ version
|
|
|
|
1.2.5 this is 1.)
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
This variable is in the library, so represents the
|
|
|
|
GTK+ library you have linked against. Contrast with the
|
|
|
|
#GTK_MAJOR_VERSION macro, which represents the major version of the
|
|
|
|
GTK+ headers you have included.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### VARIABLE gtk_minor_version ##### -->
|
|
|
|
<para>
|
1999-09-22 21:30:57 +00:00
|
|
|
The minor version number of the GTK+ library.
|
|
|
|
(e.g. in GTK+ version 1.2.5 this is 2.)
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2001-09-08 04:39:53 +00:00
|
|
|
<para>
|
|
|
|
This variable is in the library, so represents the
|
|
|
|
GTK+ library you have linked against. Contrast with the
|
|
|
|
#GTK_MINOR_VERSION macro, which represents the minor version of the
|
|
|
|
GTK+ headers you have included.
|
|
|
|
</para>
|
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
<!-- ##### VARIABLE gtk_micro_version ##### -->
|
|
|
|
<para>
|
1999-09-22 21:30:57 +00:00
|
|
|
The micro version number of the GTK+ library.
|
|
|
|
(e.g. in GTK+ version 1.2.5 this is 5.)
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<para>
|
2001-09-08 04:39:53 +00:00
|
|
|
This variable is in the library, so represents the GTK+ library you
|
|
|
|
have linked against. Contrast with the #GTK_MICRO_VERSION macro, which
|
|
|
|
represents the micro version of the GTK+ headers you have included.
|
|
|
|
</para>
|
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
|
2001-09-08 04:39:53 +00:00
|
|
|
<!-- ##### VARIABLE gtk_binary_age ##### -->
|
|
|
|
<para>
|
Doc typo fix. (#68172)
* gtk/gtksocket.c (gtk_socket_get_id): Doc typo fix. (#68172)
* gtk/gtktreemodel.c (gtk_tree_path_is_descendant): Fix docs.
* gtk/gtktreemodel.c (gtk_tree_model_rows_reordered): Document.
* gtk/gtkwindow.c (gtk_window_remove_accel_group): Fix docs.
* gtk/gtkrc.c (gtk_rc_get_style_by_paths),
gtk/gtkwidget.c (gtk_widget_get_toplevel,
gtk_widget_push_composite_child), gtk/gtkdialog.c
(gtk_dialog_new_with_buttons, gtk_dialog_run): Keep gtk-doc
from messing up the indentation of inline examples.
* gtk/gtkmain.c, gtk/gtkrc.c: Consistently call g_getenv()
instead of getenv().
* gtk/gtktreemodel.c, gtk/gtkaccelgroup.c, gtk/gtkclipboard.c,
gtk/gtkdnd.c, gtk/gtkiconfactory.c, gtk/gtkrc.c,
gtk/gtkstyle.c, gtk/gtkselection.c: Doc fixes.
* gtk/gtkaccelmap.c (gtk_accel_map_add_filter,
gtk_accel_map_foreach_unfiltered, gtk_accel_map_load_scanner):
Document.
* gtk/tmpl/gtksocket.sgml: Mention gtk_socket_get_id()
instead of GTK_WINDOW_XWINDOW(). (#68172)
* gtk/gtk-sections.txt: Move functions which are documented
as "private" or "internal" into Private subsections.
* gtk/tmpl/gtkdnd.sgml, gtk/tmpl/gtkobject.sgml,
gtk/tmpl/gtkrc.sgml, gtk/tmpl/gtktooltips.sgml,
gtk/tmpl/gtkwidget.sgml, gtk/tmpl/gtkclipboard.sgml,
gtk/tmpl/gtkstyle.sgml, gtk/tmpl/gtkselection.sgml,
gtk/tmpl/gtkfeatures.sgml: Minor markup fixes.
* gtk/tmpl/gtksignal.sgml: Add link to GLib signal docs.
* gtk/tmpl/gtkpreview.sgml, gtk/tmpl/gtktext.sgml,
gtk/tmpl/gtktree.sgml: Remove "deprecated" from short desc.
* gtk/tmpl/gtkrc.sgml: Correct names of default RC files.
2002-01-08 00:04:57 +00:00
|
|
|
This is the binary age passed to <application>libtool</application>. If
|
|
|
|
<application>libtool</application> means nothing to you, don't worry
|
|
|
|
about it. ;-)
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### VARIABLE gtk_interface_age ##### -->
|
|
|
|
<para>
|
Doc typo fix. (#68172)
* gtk/gtksocket.c (gtk_socket_get_id): Doc typo fix. (#68172)
* gtk/gtktreemodel.c (gtk_tree_path_is_descendant): Fix docs.
* gtk/gtktreemodel.c (gtk_tree_model_rows_reordered): Document.
* gtk/gtkwindow.c (gtk_window_remove_accel_group): Fix docs.
* gtk/gtkrc.c (gtk_rc_get_style_by_paths),
gtk/gtkwidget.c (gtk_widget_get_toplevel,
gtk_widget_push_composite_child), gtk/gtkdialog.c
(gtk_dialog_new_with_buttons, gtk_dialog_run): Keep gtk-doc
from messing up the indentation of inline examples.
* gtk/gtkmain.c, gtk/gtkrc.c: Consistently call g_getenv()
instead of getenv().
* gtk/gtktreemodel.c, gtk/gtkaccelgroup.c, gtk/gtkclipboard.c,
gtk/gtkdnd.c, gtk/gtkiconfactory.c, gtk/gtkrc.c,
gtk/gtkstyle.c, gtk/gtkselection.c: Doc fixes.
* gtk/gtkaccelmap.c (gtk_accel_map_add_filter,
gtk_accel_map_foreach_unfiltered, gtk_accel_map_load_scanner):
Document.
* gtk/tmpl/gtksocket.sgml: Mention gtk_socket_get_id()
instead of GTK_WINDOW_XWINDOW(). (#68172)
* gtk/gtk-sections.txt: Move functions which are documented
as "private" or "internal" into Private subsections.
* gtk/tmpl/gtkdnd.sgml, gtk/tmpl/gtkobject.sgml,
gtk/tmpl/gtkrc.sgml, gtk/tmpl/gtktooltips.sgml,
gtk/tmpl/gtkwidget.sgml, gtk/tmpl/gtkclipboard.sgml,
gtk/tmpl/gtkstyle.sgml, gtk/tmpl/gtkselection.sgml,
gtk/tmpl/gtkfeatures.sgml: Minor markup fixes.
* gtk/tmpl/gtksignal.sgml: Add link to GLib signal docs.
* gtk/tmpl/gtkpreview.sgml, gtk/tmpl/gtktext.sgml,
gtk/tmpl/gtktree.sgml: Remove "deprecated" from short desc.
* gtk/tmpl/gtkrc.sgml: Correct names of default RC files.
2002-01-08 00:04:57 +00:00
|
|
|
This is the interface age passed to <application>libtool</application>. If
|
|
|
|
<application>libtool</application> means nothing to you, don't worry
|
|
|
|
about it. ;-)
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_check_version ##### -->
|
|
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
2003-10-28 14:23:28 +00:00
|
|
|
@required_major:
|
2003-12-08 22:55:03 +00:00
|
|
|
@required_minor:
|
|
|
|
@required_micro:
|
|
|
|
@Returns:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
2000-09-07 18:17:06 +00:00
|
|
|
<!-- ##### MACRO GTK_MAJOR_VERSION ##### -->
|
|
|
|
<para>
|
2001-09-08 04:39:53 +00:00
|
|
|
Like #gtk_major_version, but from the headers used at
|
|
|
|
application compile time, rather than from the library linked against
|
|
|
|
at application run time.
|
2000-09-07 18:17:06 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GTK_MINOR_VERSION ##### -->
|
|
|
|
<para>
|
2001-09-08 04:39:53 +00:00
|
|
|
Like #gtk_minor_version, but from the headers used at
|
|
|
|
application compile time, rather than from the library linked against
|
|
|
|
at application run time.
|
2000-09-07 18:17:06 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GTK_MICRO_VERSION ##### -->
|
|
|
|
<para>
|
2001-09-08 04:39:53 +00:00
|
|
|
Like #gtk_micro_version, but from the headers used at
|
|
|
|
application compile time, rather than from the library linked against
|
|
|
|
at application run time.
|
2000-09-07 18:17:06 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GTK_BINARY_AGE ##### -->
|
|
|
|
<para>
|
2001-09-08 04:39:53 +00:00
|
|
|
Like #gtk_binary_age, but from the headers used at
|
|
|
|
application compile time, rather than from the library linked against
|
|
|
|
at application run time.
|
2000-09-07 18:17:06 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GTK_INTERFACE_AGE ##### -->
|
|
|
|
<para>
|
2001-09-08 04:39:53 +00:00
|
|
|
Like #gtk_interface_age, but from the headers used at
|
|
|
|
application compile time, rather than from the library linked against
|
|
|
|
at application run time.
|
2000-09-07 18:17:06 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GTK_CHECK_VERSION ##### -->
|
|
|
|
<para>
|
2004-12-17 01:41:05 +00:00
|
|
|
Returns %TRUE if the version of the GTK+ header files is the same
|
|
|
|
as or newer than the passed-in version.
|
2000-09-07 18:17:06 +00:00
|
|
|
</para>
|
|
|
|
|
Doc typo fix. (#68172)
* gtk/gtksocket.c (gtk_socket_get_id): Doc typo fix. (#68172)
* gtk/gtktreemodel.c (gtk_tree_path_is_descendant): Fix docs.
* gtk/gtktreemodel.c (gtk_tree_model_rows_reordered): Document.
* gtk/gtkwindow.c (gtk_window_remove_accel_group): Fix docs.
* gtk/gtkrc.c (gtk_rc_get_style_by_paths),
gtk/gtkwidget.c (gtk_widget_get_toplevel,
gtk_widget_push_composite_child), gtk/gtkdialog.c
(gtk_dialog_new_with_buttons, gtk_dialog_run): Keep gtk-doc
from messing up the indentation of inline examples.
* gtk/gtkmain.c, gtk/gtkrc.c: Consistently call g_getenv()
instead of getenv().
* gtk/gtktreemodel.c, gtk/gtkaccelgroup.c, gtk/gtkclipboard.c,
gtk/gtkdnd.c, gtk/gtkiconfactory.c, gtk/gtkrc.c,
gtk/gtkstyle.c, gtk/gtkselection.c: Doc fixes.
* gtk/gtkaccelmap.c (gtk_accel_map_add_filter,
gtk_accel_map_foreach_unfiltered, gtk_accel_map_load_scanner):
Document.
* gtk/tmpl/gtksocket.sgml: Mention gtk_socket_get_id()
instead of GTK_WINDOW_XWINDOW(). (#68172)
* gtk/gtk-sections.txt: Move functions which are documented
as "private" or "internal" into Private subsections.
* gtk/tmpl/gtkdnd.sgml, gtk/tmpl/gtkobject.sgml,
gtk/tmpl/gtkrc.sgml, gtk/tmpl/gtktooltips.sgml,
gtk/tmpl/gtkwidget.sgml, gtk/tmpl/gtkclipboard.sgml,
gtk/tmpl/gtkstyle.sgml, gtk/tmpl/gtkselection.sgml,
gtk/tmpl/gtkfeatures.sgml: Minor markup fixes.
* gtk/tmpl/gtksignal.sgml: Add link to GLib signal docs.
* gtk/tmpl/gtkpreview.sgml, gtk/tmpl/gtktext.sgml,
gtk/tmpl/gtktree.sgml: Remove "deprecated" from short desc.
* gtk/tmpl/gtkrc.sgml: Correct names of default RC files.
2002-01-08 00:04:57 +00:00
|
|
|
@major: major version (e.g. 1 for version 1.2.5)
|
|
|
|
@minor: minor version (e.g. 2 for version 1.2.5)
|
|
|
|
@micro: micro version (e.g. 5 for version 1.2.5)
|
2000-09-07 18:17:06 +00:00
|
|
|
|
|
|
|
|