mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2025-08-30 12:54:11 +02:00
Add support for org.gtk.GDBus.Since annotation
And use this for a) documentation purposes; and b) to preserve C ABI when an interface is extended. See https://bugzilla.gnome.org/show_bug.cgi?id=647577#c5 for more details. Also add test cases for this. Signed-off-by: David Zeuthen <davidz@redhat.com>
This commit is contained in:
@@ -215,6 +215,28 @@ gdbus-codegen --c-namespace MyApp \
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><literal>org.gtk.GDBus.Since</literal></term>
|
||||
<listitem>
|
||||
<para>
|
||||
Can be used on any <literal><interface></literal>,
|
||||
<literal><method></literal>,
|
||||
<literal><signal></literal> and
|
||||
<literal><property></literal> element to specify the
|
||||
version (any free-form string but compared using a
|
||||
version-aware sort function) the element appeared in.
|
||||
</para>
|
||||
<para>
|
||||
When generating C code, this field is used to ensure
|
||||
function pointer order for preserving ABI/API.
|
||||
</para>
|
||||
<para>
|
||||
When generating Docbook XML, the value of this tag appears
|
||||
in the documentation.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><literal>org.gtk.GDBus.C.ForceGVariant</literal></term>
|
||||
<listitem>
|
||||
|
Reference in New Issue
Block a user