| 1 |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| 2 |
<html> |
| 3 |
<head> |
| 4 |
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| 5 |
<title>Annotation Glossary: libxfce4windowing Reference Manual</title> |
| 6 |
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"> |
| 7 |
<link rel="home" href="index.html" title="libxfce4windowing Reference Manual"> |
| 8 |
<link rel="up" href="index.html" title="libxfce4windowing Reference Manual"> |
| 9 |
<link rel="prev" href="deprecated-api-index.html" title="Index of deprecated API"> |
| 10 |
<meta name="generator" content="GTK-Doc V1.34.0 (XML mode)"> |
| 11 |
<link rel="stylesheet" href="style.css" type="text/css"> |
| 12 |
</head> |
| 13 |
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> |
| 14 |
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle"> |
| 15 |
<td width="100%" align="left" class="shortcuts"><span id="nav_glossary"><a class="shortcut" href="#glsC">C</a> |
| 16 |
<span class="dim">|</span> |
| 17 |
<a class="shortcut" href="#glsN">N</a> |
| 18 |
<span class="dim">|</span> |
| 19 |
<a class="shortcut" href="#glsS">S</a> |
| 20 |
<span class="dim">|</span> |
| 21 |
<a class="shortcut" href="#glsT">T</a> |
| 22 |
<span class="dim">|</span> |
| 23 |
<a class="shortcut" href="#glsU">U</a></span></td> |
| 24 |
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> |
| 25 |
<td><img src="up-insensitive.png" width="16" height="16" border="0"></td> |
| 26 |
<td><a accesskey="p" href="deprecated-api-index.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> |
| 27 |
<td><img src="right-insensitive.png" width="16" height="16" border="0"></td> |
| 28 |
</tr></table> |
| 29 |
<div class="glossary"> |
| 30 |
<div class="titlepage"><div><div><h1 class="title"> |
| 31 |
<a name="annotation-glossary"></a>Annotation Glossary</h1></div></div></div> |
| 32 |
<a name="glsC"></a><h3 class="title">C</h3> |
| 33 |
<dt><span class="glossterm"><a name="annotation-glossterm-constructor"></a>constructor</span></dt> |
| 34 |
<dd class="glossdef"><p>This symbol is a constructor, not a static method.</p></dd> |
| 35 |
<a name="glsN"></a><h3 class="title">N</h3> |
| 36 |
<dt><span class="glossterm"><a name="annotation-glossterm-not%20nullable"></a>not nullable</span></dt> |
| 37 |
<dd class="glossdef"><p>NULL must not be passed as the value in, out, in-out; or as a return value.</p></dd> |
| 38 |
<dt><span class="glossterm"><a name="annotation-glossterm-nullable"></a>nullable</span></dt> |
| 39 |
<dd class="glossdef"><p>NULL may be passed as the value in, out, in-out; or as a return value.</p></dd> |
| 40 |
<a name="glsS"></a><h3 class="title">S</h3> |
| 41 |
<dt><span class="glossterm"><a name="annotation-glossterm-Stable"></a>Stable</span></dt> |
| 42 |
<dd class="glossdef"><p>The intention of a Stable interface is to enable arbitrary third parties to |
| 43 |
develop applications to these interfaces, release them, and have confidence that |
| 44 |
they will run on all minor releases of the product (after the one in which the |
| 45 |
interface was introduced, and within the same major release). Even at a major |
| 46 |
release, incompatible changes are expected to be rare, and to have strong |
| 47 |
justifications. |
| 48 |
</p></dd> |
| 49 |
<a name="glsT"></a><h3 class="title">T</h3> |
| 50 |
<dt><span class="glossterm"><a name="annotation-glossterm-transfer%20floating"></a>transfer floating</span></dt> |
| 51 |
<dd class="glossdef"><p>Alias for <acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>, used for objects with floating refs.</p></dd> |
| 52 |
<dt><span class="glossterm"><a name="annotation-glossterm-transfer%20full"></a>transfer full</span></dt> |
| 53 |
<dd class="glossdef"><p>The caller owns the data, and is responsible for free it.</p></dd> |
| 54 |
<dt><span class="glossterm"><a name="annotation-glossterm-transfer%20none"></a>transfer none</span></dt> |
| 55 |
<dd class="glossdef"><p>The data is owned by the callee, which is responsible of freeing it.</p></dd> |
| 56 |
<a name="glsU"></a><h3 class="title">U</h3> |
| 57 |
<dt><span class="glossterm"><a name="annotation-glossterm-Unstable"></a>Unstable</span></dt> |
| 58 |
<dd class="glossdef"><p>Unstable interfaces are experimental or transitional. They are typically used to |
| 59 |
give outside developers early access to new or rapidly changing technology, or |
| 60 |
to provide an interim solution to a problem where a more general solution is |
| 61 |
anticipated. No claims are made about either source or binary compatibility from |
| 62 |
one minor release to the next. |
| 63 |
|
| 64 |
The Unstable interface level is a warning that these interfaces are subject to |
| 65 |
change without warning and should not be used in unbundled products. |
| 66 |
|
| 67 |
Given such caveats, customer impact need not be a factor when considering |
| 68 |
incompatible changes to an Unstable interface in a major or minor release. |
| 69 |
Nonetheless, when such changes are introduced, the changes should still be |
| 70 |
mentioned in the release notes for the affected release. |
| 71 |
</p></dd> |
| 72 |
</div> |
| 73 |
<div class="footer"> |
| 74 |
<hr>Generated by GTK-Doc V1.34.0</div> |
| 75 |
</body> |
| 76 |
</html> |