mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2025-03-04 07:02:10 +01:00
229b76a388
Move it to a separate documentation file, since most of what’s covered isn’t introspectable. Signed-off-by: Philip Withnall <pwithnall@gnome.org> Helps: #3037
47 lines
1.7 KiB
Markdown
47 lines
1.7 KiB
Markdown
Title: Version Information
|
|
SPDX-License-Identifier: LGPL-2.1-or-later
|
|
SPDX-FileCopyrightText: 2004 Matthias Clasen
|
|
SPDX-FileCopyrightText: 2012 Emmanuele Bassi
|
|
|
|
# Version Information
|
|
|
|
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.
|
|
|
|
## Run-time Version Numbers
|
|
|
|
The variables `glib_major_version`, `glib_minor_version`, `glib_micro_version`,
|
|
`glib_binary_age` and `glib_interface_age` are all available to check.
|
|
|
|
They can be compared using the function [func@GLib.check_version].
|
|
|
|
## Compile-time Version Numbers
|
|
|
|
* [const@GLib.MAJOR_VERSION]
|
|
* [const@GLib.MINOR_VERSION]
|
|
* [const@GLib.MICRO_VERSION]
|
|
* [func@GLib.CHECK_VERSION]
|
|
|
|
## Version Numbers
|
|
|
|
The GLib headers annotate deprecated APIs in a way that produces
|
|
compiler warnings if these deprecated APIs are used. The warnings
|
|
can be turned off by defining the macro `GLIB_DISABLE_DEPRECATION_WARNINGS`
|
|
before including the `glib.h` header.
|
|
|
|
GLib also provides support for building applications against
|
|
defined subsets of deprecated or new GLib APIs. Define the macro
|
|
`GLIB_VERSION_MIN_REQUIRED` to specify up to what version of GLib
|
|
you want to receive warnings about deprecated APIs. Define the
|
|
macro `GLIB_VERSION_MAX_ALLOWED` to specify the newest version of
|
|
GLib whose API you want to use.
|
|
|
|
The macros `GLIB_VERSION_2_2`, `GLIB_VERSION_2_4`, …, `GLIB_VERSION_2_80`, etc.
|
|
are defined automatically in each release, and can be used to set the value
|
|
of macros like `GLIB_VERSION_MIN_REQUIRED`.
|
|
|
|
The macros `GLIB_VERSION_CUR_STABLE` and `GLIB_VERSION_PREV_STABLE` are also
|
|
automatically defined to point to the right version definitions.
|
|
|