forked from AuroraMiddleware/gtk
c1808baa01
* 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.
152 lines
4.1 KiB
Plaintext
152 lines
4.1 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
Version Information
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
variables and functions to check the GTK+ version.
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
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.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### VARIABLE gtk_major_version ##### -->
|
|
<para>
|
|
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.
|
|
</para>
|
|
|
|
|
|
<!-- ##### VARIABLE gtk_minor_version ##### -->
|
|
<para>
|
|
The minor version number of the GTK+ library.
|
|
(e.g. in GTK+ version 1.2.5 this is 2.)
|
|
</para>
|
|
|
|
<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>
|
|
|
|
|
|
<!-- ##### VARIABLE gtk_micro_version ##### -->
|
|
<para>
|
|
The micro version number of the GTK+ library.
|
|
(e.g. in GTK+ version 1.2.5 this is 5.)
|
|
</para>
|
|
|
|
|
|
<para>
|
|
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>
|
|
|
|
|
|
<!-- ##### VARIABLE gtk_binary_age ##### -->
|
|
<para>
|
|
This is the binary age passed to <application>libtool</application>. If
|
|
<application>libtool</application> means nothing to you, don't worry
|
|
about it. ;-)
|
|
</para>
|
|
|
|
|
|
<!-- ##### VARIABLE gtk_interface_age ##### -->
|
|
<para>
|
|
This is the interface age passed to <application>libtool</application>. If
|
|
<application>libtool</application> means nothing to you, don't worry
|
|
about it. ;-)
|
|
</para>
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_check_version ##### -->
|
|
<para>
|
|
Checks that the GTK+ library in use is equal to the given
|
|
version. Primarily useful to compare the header file version
|
|
(from #GTK_MAJOR_VERSION, #GTK_MINOR_VERSION, #GTK_MICRO_VERSION)
|
|
the the runtime library version. This should only be done
|
|
in the build for your application, to check that the user's libraries
|
|
and header files are the same. Applications should not do this
|
|
when deployed, because it's OK for applications to use a different
|
|
micro version of GTK+ than the one they were compiled against.
|
|
</para>
|
|
|
|
@required_major: the required major version.
|
|
@required_minor: the required major version.
|
|
@required_micro: the required major version.
|
|
@Returns: %NULL if the GTK+ library is compatible with the given version, or
|
|
a string describing the version mismatch.
|
|
|
|
|
|
<!-- ##### MACRO GTK_MAJOR_VERSION ##### -->
|
|
<para>
|
|
Like #gtk_major_version, but from the headers used at
|
|
application compile time, rather than from the library linked against
|
|
at application run time.
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### MACRO GTK_MINOR_VERSION ##### -->
|
|
<para>
|
|
Like #gtk_minor_version, but from the headers used at
|
|
application compile time, rather than from the library linked against
|
|
at application run time.
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### MACRO GTK_MICRO_VERSION ##### -->
|
|
<para>
|
|
Like #gtk_micro_version, but from the headers used at
|
|
application compile time, rather than from the library linked against
|
|
at application run time.
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### MACRO GTK_BINARY_AGE ##### -->
|
|
<para>
|
|
Like #gtk_binary_age, but from the headers used at
|
|
application compile time, rather than from the library linked against
|
|
at application run time.
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### MACRO GTK_INTERFACE_AGE ##### -->
|
|
<para>
|
|
Like #gtk_interface_age, but from the headers used at
|
|
application compile time, rather than from the library linked against
|
|
at application run time.
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### MACRO GTK_CHECK_VERSION ##### -->
|
|
<para>
|
|
Returns %TRUE if the version of the GTK+ header files is the same
|
|
as the passed-in version.
|
|
</para>
|
|
|
|
@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)
|
|
|
|
|