Pileus Git - ~andy/gtk/blob - docs/reference/gtk/tmpl/gtkfeatures.sgml

   1 <!-- ##### SECTION Title ##### -->
   2 Version Information
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 Variables and functions to check the GTK+ version
   6
   7 <!-- ##### SECTION Long_Description ##### -->
   8 <para>
   9 GTK+ provides version information, primarily useful in configure checks
  10 for builds that have a configure script. Applications will not
  11 typically use the features described here.
  12 </para>
  13
  14 <!-- ##### SECTION See_Also ##### -->
  15 <para>
  16
  17 </para>
  18
  19 <!-- ##### SECTION Stability_Level ##### -->
  20
  21
  22 <!-- ##### SECTION Image ##### -->
  23
  24
  25 <!-- ##### VARIABLE gtk_major_version ##### -->
  26 <para>
  27 The major version number of the GTK+ library.  (e.g. in GTK+ version
  28 1.2.5 this is 1.)
  29 </para>
  30
  31 <para>
  32 This variable is in the library, so represents the
  33 GTK+ library you have linked against. Contrast with the
  34 #GTK_MAJOR_VERSION macro, which represents the major version of the
  35 GTK+ headers you have included.
  36 </para>
  37
  38
  39 <!-- ##### VARIABLE gtk_minor_version ##### -->
  40 <para>
  41 The minor version number of the GTK+ library.
  42 (e.g. in GTK+ version 1.2.5 this is 2.)
  43 </para>
  44
  45 <para>
  46 This variable is in the library, so represents the
  47 GTK+ library you have linked against. Contrast with the
  48 #GTK_MINOR_VERSION macro, which represents the minor version of the
  49 GTK+ headers you have included.
  50 </para>
  51
  52
  53 <!-- ##### VARIABLE gtk_micro_version ##### -->
  54 <para>
  55 The micro version number of the GTK+ library.
  56 (e.g. in GTK+ version 1.2.5 this is 5.)
  57 </para>
  58
  59
  60 <para>
  61 This variable is in the library, so represents the GTK+ library you
  62 have linked against. Contrast with the #GTK_MICRO_VERSION macro, which
  63 represents the micro version of the GTK+ headers you have included.
  64 </para>
  65
  66
  67 <!-- ##### VARIABLE gtk_binary_age ##### -->
  68 <para>
  69 This is the binary age passed to <application>libtool</application>. If
  70 <application>libtool</application> means nothing to you, don't worry
  71 about it. ;-)
  72 </para>
  73
  74
  75 <!-- ##### VARIABLE gtk_interface_age ##### -->
  76 <para>
  77 This is the interface age passed to <application>libtool</application>. If
  78 <application>libtool</application> means nothing to you, don't worry
  79 about it. ;-)
  80 </para>
  81
  82
  83 <!-- ##### FUNCTION gtk_check_version ##### -->
  84 <para>
  85 </para>
  86
  87 @required_major:
  88 @required_minor:
  89 @required_micro:
  90 @Returns:
  91
  92
  93 <!-- ##### MACRO GTK_MAJOR_VERSION ##### -->
  94 <para>
  95 Like #gtk_major_version, but from the headers used at
  96 application compile time, rather than from the library linked against
  97 at application run time.
  98 </para>
  99
 100
 101
 102 <!-- ##### MACRO GTK_MINOR_VERSION ##### -->
 103 <para>
 104 Like #gtk_minor_version, but from the headers used at
 105 application compile time, rather than from the library linked against
 106 at application run time.
 107 </para>
 108
 109
 110
 111 <!-- ##### MACRO GTK_MICRO_VERSION ##### -->
 112 <para>
 113 Like #gtk_micro_version, but from the headers used at
 114 application compile time, rather than from the library linked against
 115 at application run time.
 116 </para>
 117
 118
 119
 120 <!-- ##### MACRO GTK_BINARY_AGE ##### -->
 121 <para>
 122 Like #gtk_binary_age, but from the headers used at
 123 application compile time, rather than from the library linked against
 124 at application run time.
 125 </para>
 126
 127
 128
 129 <!-- ##### MACRO GTK_INTERFACE_AGE ##### -->
 130 <para>
 131 Like #gtk_interface_age, but from the headers used at
 132 application compile time, rather than from the library linked against
 133 at application run time.
 134 </para>
 135
 136
 137
 138 <!-- ##### MACRO GTK_CHECK_VERSION ##### -->
 139 <para>
 140 Returns %TRUE if the version of the GTK+ header files is the same
 141 as or newer than the passed-in version.
 142 </para>
 143
 144 @major: major version (e.g. 1 for version 1.2.5)
 145 @minor: minor version (e.g. 2 for version 1.2.5)
 146 @micro: micro version (e.g. 5 for version 1.2.5)
 147
 148