WebSVN – Kolibri OS – Diff – /programs/develop/libraries/cairo/src/cairo-version.c

  * Cairo has a three-part version number scheme. In this scheme, we use
  * even vs. odd numbers to distinguish fixed points in the software
  * vs. in-progress development, (such as from git instead of a tar file,
  * or as a "snapshot" tar file as opposed to a "release" tar file).
+ *
  *
  *  _____ Major. Always 1, until we invent a new scheme.
  * /  ___ Minor. Even/Odd = Release/Snapshot (tar files) or Branch/Head (git)
  * | /  _ Micro. Even/Odd = Tar-file/git
  * | | /
  * 1.0.0
  *
+ *
  * Here are a few examples of versions that one might see.
  *
  * Releases
  * --------
  * 1.0.0 - A major release
  * 1.0.2 - A subsequent maintenance release
  * 1.2.0 - Another major release
  *
  * Snapshots
  * ---------
  * 1.1.2 - A snapshot (working toward the 1.2.0 release)
  *
  * In-progress development (eg. from git)
  * --------------------------------------
  * 1.0.1 - Development on a maintenance branch (toward 1.0.2 release)
  * 1.1.1 - Development on head (toward 1.1.2 snapshot and 1.2.0 release)
  *
+ *
+ *
  * Compatibility
+ *
  * The API/ABI compatibility guarantees for various versions are as
  * Cairo provides the ability to examine the version at either
  * compile-time or run-time and in both a human-readable form as well as
  * an encoded form suitable for direct comparison. Cairo also provides the
  * macro CAIRO_VERSION_ENCODE() to perform the encoding.
+ *
  *
  * Compile-time
  * ------------
  * CAIRO_VERSION_STRING    Human-readable
  * CAIRO_VERSION           Encoded, suitable for comparison
  *
  * Run-time
  * --------
  * cairo_version_string()  Human-readable
  * cairo_version()         Encoded, suitable for comparison
  *
+ *
  * For example, checking that the cairo version is greater than or equal
  * to 1.0.0 could be achieved at compile-time or run-time as follows:
+ *
+ *
  * if (cairo_version() >= CAIRO_VERSION_ENCODE(1, 0, 0))
  *     printf ("Running with suitable cairo version: %s\n", cairo_version_string ());
+ *
+ *
+ *
- */
+ **/
 /**
  * CAIRO_VERSION:
+ *
  * The version of cairo available at compile-time, encoded using
+ * CAIRO_VERSION_ENCODE().
+ *
- * CAIRO_VERSION_ENCODE().
+ * Since: 1.0
- */
+ **/
 /**
  * CAIRO_VERSION_MAJOR:
+ *
+ * The major component of the version of cairo available at compile-time.
  *
- * The major component of the version of cairo available at compile-time.
+ * Since: 1.0
- */
+ **/
 /**
+ * CAIRO_VERSION_MINOR:
+ *
- * CAIRO_VERSION_MINOR:
+ * The minor component of the version of cairo available at compile-time.
+ *
- * The minor component of the version of cairo available at compile-time.
+ * Since: 1.0
- */
+ **/
+/**
+ * CAIRO_VERSION_MICRO:
-/**
+ *
- * CAIRO_VERSION_MICRO:
+ * The micro component of the version of cairo available at compile-time.
+ *
- * The micro component of the version of cairo available at compile-time.
+ * Since: 1.0
- */
+ **/
+/**
+ * CAIRO_VERSION_STRING:
-/**
+ *
- * CAIRO_VERSION_STRING:
+ * A human-readable string literal containing the version of cairo available
  * at compile-time, in the form of "X.Y.Z".
  * A human-readable string literal containing the version of cairo available
- * at compile-time, in the form of "X.Y.Z".
+ * Since: 1.8
  * This macro encodes the given cairo version into an integer.  The numbers
  * returned by %CAIRO_VERSION and cairo_version() are encoded using this macro.
  * Two encoded version numbers can be compared as integers.  The encoding ensures
  * that later versions compare greater than earlier versions.
+ *
- * @Returns: the encoded version.
+ * Returns: the encoded version.
+ *
+ * Since: 1.0
- */
+ **/
 /**
  * CAIRO_VERSION_STRINGIZE:
  * @major: the major component of the version number
+ *
  * This macro encodes the given cairo version into an string.  The numbers
  * returned by %CAIRO_VERSION_STRING and cairo_version_string() are encoded using this macro.
  * The parameters to this macro must expand to numerical literals.
+ *
- * @Returns: a string literal containing the version.
+ * Returns: a string literal containing the version.
+ *
- * @Since: 1.8
+ * Since: 1.8
- */
+ **/
 /**
  * cairo_version:
+ *
+ *
  * See also cairo_version_string() as well as the compile-time
  * equivalents %CAIRO_VERSION and %CAIRO_VERSION_STRING.
+ *
  * Return value: the encoded version.
+ *
+ * Since: 1.0
  **/
 int
 cairo_version (void)
+{
     return CAIRO_VERSION;
+ *
  * See also cairo_version() as well as the compile-time equivalents
  * %CAIRO_VERSION_STRING and %CAIRO_VERSION.
+ *
  * Return value: a string containing the version.
+ *
+ * Since: 1.0
  **/
 const char*
 cairo_version_string (void)
+{
     return CAIRO_VERSION_STRING;

Subversion Repositories Kolibri OS

(root)/programs/develop/libraries/cairo/src/cairo-version.c – Rev 1892 → 3959