*
* Return the list of currently loaded namespaces.
*
- * Returns: (utf8) (transfer full): List of namespaces
+ * Returns: (element-type utf8) (transfer full): List of namespaces
*/
gchar **
g_irepository_get_loaded_namespaces (GIRepository *repository)
}
/**
- * g_irepository_get_c_prefix
+ * g_irepository_get_c_prefix:
* @repository: (allow-none): A #GIRepository, may be %NULL for the default
* @namespace_: Namespace to inspect
*
}
/**
- * g_irepository_get_typelib_path
+ * g_irepository_get_typelib_path:
* @repository: (allow-none): Repository, may be %NULL for the default
* @namespace_: GI namespace to use, e.g. "Gtk"
*
};
/**
- * GIRepositoryLoadFlags
+ * GIRepositoryLoadFlags:
* @G_IREPOSITORY_LOAD_FLAG_LAZY: Load the types lazily.
*
* Flags that controlls how a typelib is loaded by
typedef GIBaseInfo GISignalInfo;
/**
- * GIVFuncInfo
+ * GIVFuncInfo:
*
* Represents a virtual function.
*/
/**
* gi_marshalling_tests_array_fixed_int_return:
+ *
* Returns: (array fixed-size=4):
*/
const gint *
/**
* gi_marshalling_tests_array_fixed_short_return:
+ *
* Returns: (array fixed-size=4):
*/
const gshort *
/**
* gi_marshalling_tests_array_return:
+ *
* Returns: (array length=length):
*/
const gint *
* @length: (out):
* @last:
* @sum: (out):
+ *
* Returns: (array length=length):
*/
const gint *
/**
* gi_marshalling_tests_array_zero_terminated_return:
+ *
* Returns: (array zero-terminated=1) (transfer none):
*/
gchar **
/**
* gi_marshalling_tests_array_zero_terminated_return_null:
+ *
* Returns: (array zero-terminated=1) (transfer none):
*/
gchar **
/**
* gi_marshalling_tests_array_zero_terminated_return_struct:
+ *
* Returns: (array zero-terminated=1) (transfer full):
*/
GIMarshallingTestsBoxedStruct **
/**
* gi_marshalling_tests_array_gvariant_none_in:
* @variants: (array zero-terminated=1) (transfer none):
+ *
* Returns: (array zero-terminated=1) (transfer none):
*/
GVariant **
/**
* gi_marshalling_tests_array_gvariant_container_in:
* @variants: (array zero-terminated=1) (transfer container):
+ *
* Returns: (array zero-terminated=1) (transfer container):
*/
GVariant **
/**
* gi_marshalling_tests_array_gvariant_full_in:
* @variants: (array zero-terminated=1) (transfer full):
+ *
* Returns: (array zero-terminated=1) (transfer full):
*/
GVariant **
/**
* gi_marshalling_tests_garray_int_none_return:
+ *
* Returns: (element-type gint) (transfer none):
*/
GArray *
/**
* gi_marshalling_tests_garray_utf8_none_return:
+ *
* Returns: (element-type utf8) (transfer none):
*/
GArray *
/**
* gi_marshalling_tests_garray_utf8_container_return:
+ *
* Returns: (element-type utf8) (transfer container):
*/
GArray *
/**
* gi_marshalling_tests_garray_utf8_full_return:
+ *
* Returns: (element-type utf8) (transfer full):
*/
GArray *
/**
* gi_marshalling_tests_gptrarray_utf8_none_return:
+ *
* Returns: (element-type utf8) (transfer none):
*/
GPtrArray *
/**
* gi_marshalling_tests_gptrarray_utf8_container_return:
+ *
* Returns: (element-type utf8) (transfer container):
*/
GPtrArray *
/**
* gi_marshalling_tests_gptrarray_utf8_full_return:
+ *
* Returns: (element-type utf8) (transfer full):
*/
GPtrArray *
/**
* gi_marshalling_tests_bytearray_full_return:
+ *
* Returns: (transfer full):
*/
GByteArray *
/**
* gi_marshalling_tests_glist_int_none_return:
+ *
* Returns: (element-type gint) (transfer none):
*/
GList *
/**
* gi_marshalling_tests_glist_utf8_none_return:
+ *
* Returns: (element-type utf8) (transfer none):
*/
GList *
/**
* gi_marshalling_tests_glist_utf8_container_return:
+ *
* Returns: (element-type utf8) (transfer container):
*/
GList *
/**
* gi_marshalling_tests_glist_utf8_full_return:
+ *
* Returns: (element-type utf8) (transfer full):
*/
GList *
/**
* gi_marshalling_tests_gslist_int_none_return:
+ *
* Returns: (element-type gint) (transfer none):
*/
GSList *
/**
* gi_marshalling_tests_gslist_utf8_none_return:
+ *
* Returns: (element-type utf8) (transfer none):
*/
GSList *
/**
* gi_marshalling_tests_gslist_utf8_container_return:
+ *
* Returns: (element-type utf8) (transfer container):
*/
GSList *
/**
* gi_marshalling_tests_gslist_utf8_full_return:
+ *
* Returns: (element-type utf8) (transfer full):
*/
GSList *
/**
* gi_marshalling_tests_ghashtable_int_none_return:
+ *
* Returns: (element-type gint gint) (transfer none):
*/
GHashTable *
/**
* gi_marshalling_tests_ghashtable_utf8_none_return:
+ *
* Returns: (element-type utf8 utf8) (transfer none):
*/
GHashTable *
/**
* gi_marshalling_tests_ghashtable_utf8_container_return:
+ *
* Returns: (element-type utf8 utf8) (transfer container):
*/
GHashTable *
/**
* gi_marshalling_tests_ghashtable_utf8_full_return:
+ *
* Returns: (element-type utf8 utf8) (transfer full):
*/
GHashTable *
/**
* gi_marshalling_tests_gvalue_return:
+ *
* Returns: (transfer none):
*/
GValue *
/**
* gi_marshalling_tests_simple_struct_returnv:
+ *
* Returns: (transfer none):
*/
GIMarshallingTestsSimpleStruct *
/**
* gi_marshalling_tests_pointer_struct_returnv:
+ *
* Returns: (transfer none):
*/
GIMarshallingTestsPointerStruct *
/**
* gi_marshalling_tests_boxed_struct_returnv:
+ *
* Returns: (transfer none):
*/
GIMarshallingTestsBoxedStruct *
/**
* gi_marshalling_tests_union_returnv:
+ *
* Returns: (transfer none):
*/
GIMarshallingTestsUnion *
/**
* gi_marshalling_tests_object_method_array_return:
+ *
* Returns: (array length=length):
*/
const gint *
/**
* gi_marshalling_tests_object_none_return:
+ *
* Returns: (transfer none):
*/
GIMarshallingTestsObject *
/**
* gi_marshalling_tests_object_full_return:
+ *
* Returns: (transfer full):
*/
GIMarshallingTestsObject *
<type name="none"/>
</return-value>
<parameters>
- <parameter name="object" transfer-ownership="none">
+ <parameter name="arg1" transfer-ownership="none">
<type name="gpointer"/>
</parameter>
</parameters>
closure="1">
<type name="GObject.Callback" c:type="GCallback"/>
</parameter>
- <parameter name="data" transfer-ownership="none">
+ <parameter name="user_data" transfer-ownership="none" closure="1">
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
closure="1">
<type name="GObject.Callback" c:type="GCallback"/>
</parameter>
- <parameter name="data" transfer-ownership="none">
+ <parameter name="user_data" transfer-ownership="none">
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
closure="2">
<type name="GObject.Callback" c:type="GCallback"/>
</parameter>
- <parameter name="data" transfer-ownership="none">
+ <parameter name="user_data" transfer-ownership="none" closure="2">
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</glib:signal>
<glib:signal name="sig-with-array-prop" when="last">
<doc xml:whitespace="preserve">This test signal is like TelepathyGlib's
-TpChannel:: group-members-changed-detailed:</doc>
+ TpChannel:: group-members-changed-detailed:</doc>
<return-value transfer-ownership="none">
<type name="none"/>
</return-value>
</glib:signal>
<glib:signal name="sig-with-hash-prop" when="last">
<doc xml:whitespace="preserve">This test signal is like TelepathyGlib's
-TpAccount::status-changed</doc>
+ TpAccount::status-changed</doc>
<return-value transfer-ownership="none">
<type name="none"/>
</return-value>
<function name="test_nested_parameter"
c:identifier="regress_test_nested_parameter">
<doc xml:whitespace="preserve"><informaltable>
-<tgroup cols="3">
-<thead>
-<row>
-<entry>Syntax</entry>
-<entry>Explanation</entry>
-<entry>Examples</entry>
-</row>
-</thead>
-<tbody>
-<row>
-<entry>rgb(@r, @g, @b)</entry>
-<entry>An opaque color; @r, @g, @b can be either integers between
-0 and 255 or percentages</entry>
-<entry><literallayout>rgb(128, 10, 54)
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Syntax</entry>
+ <entry>Explanation</entry>
+ <entry>Examples</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>rgb(@r, @g, @b)</entry>
+ <entry>An opaque color; @r, @g, @b can be either integers between
+ 0 and 255 or percentages</entry>
+ <entry><literallayout>rgb(128, 10, 54)
rgb(20%, 30%, 0%)</literallayout></entry>
-</row>
-<row>
-<entry>rgba(@r, @g, @b, @a)</entry>
-<entry>A translucent color; @r, @g, @b are as in the previous row,
-@a is a floating point number between 0 and 1</entry>
-<entry><literallayout>rgba(255, 255, 0, 0.5)</literallayout></entry>
-</row>
-</tbody>
-</tgroup>
+ </row>
+ <row>
+ <entry>rgba(@r, @g, @b, @a)</entry>
+ <entry>A translucent color; @r, @g, @b are as in the previous row,
+ @a is a floating point number between 0 and 1</entry>
+ <entry><literallayout>rgba(255, 255, 0, 0.5)</literallayout></entry>
+ </row>
+ </tbody>
+ </tgroup>
</informaltable>
What we're testing here is that the scanner ignores the @a nested inside XML.</doc>
/**
* annotation_object_out:
* @object: a #GObject
+ * @outarg: (out): This is an argument test
*
* This is a test for out arguments
*
- * @outarg: (out): This is an argument test
* Return value: an int
*/
gint
/**
* annotation_object_in:
* @object: a #GObject
+ * @inarg: (in) (transfer none): This is an argument test
*
* This is a test for in arguments
*
- * @inarg: (in) (transfer none): This is an argument test
* Return value: an int
*/
gint
/**
* annotation_object_inout:
* @object: a #GObject
+ * @inoutarg: (inout): This is an argument test
*
* This is a test for out arguments
*
- * @inoutarg: (inout): This is an argument test
* Return value: an int
*/
gint
/**
* annotation_object_inout2:
* @object: a #GObject
+ * @inoutarg: (inout): This is an argument test
*
* This is a second test for out arguments
*
- * @inoutarg: (inout): This is an argument test
* Return value: an int
*/
gint
/**
* annotation_object_inout3:
* @object: a #GObject
+ * @inoutarg: (inout) (allow-none): This is an argument test
*
* This is a 3th test for out arguments
*
- * @inoutarg: (inout) (allow-none): This is an argument test
* Return value: an int
*/
gint
/**
* annotation_object_calleeowns:
* @object: a #GObject
+ * @toown: (out): a #GObject
*
* This is a test for out arguments; GObject defaults to transfer
*
- * @toown: (out): a #GObject
* Return value: an int
*/
gint
/**
* annotation_object_calleesowns:
* @object: a #GObject
+ * @toown1: (out) (transfer full): a #GObject
+ * @toown2: (out) (transfer none): a #GObject
*
* This is a test for out arguments, one transferred, other not
*
- * @toown1: (out) (transfer full): a #GObject
- * @toown2: (out) (transfer none): a #GObject
* Return value: an int
*/
gint
}
/**
- * annotation_object_with_voidp
+ * annotation_object_with_voidp:
* @data: Opaque pointer handle
*/
void
/**
* annotation_custom_destroy:
- *
* @callback: (destroy destroy) (closure data): Destroy notification
*
* Test messing up the heuristic of closure/destroy-notification
* @self:
* @callback: (scope call):
* @user_data:
- *
*/
void
foo_sub_interface_do_baz (FooSubInterface *self, GCallback callback, gpointer user_data)
/**
* foo_test_array:
+ *
* Returns: (element-type utf8) (transfer container):
*/
GArray *
/* explicitly test un-named parameters */
void (*do_moo) (FooSubInterface *self, int, gpointer);
- void (*do_baz) (FooSubInterface *self, GCallback callback, gpointer data);
+ void (*do_baz) (FooSubInterface *self, GCallback callback, gpointer user_data);
};
GType foo_sub_interface_get_type (void) G_GNUC_CONST;
void foo_sub_interface_do_moo (FooSubInterface *self, int, gpointer);
void foo_sub_interface_do_baz (FooSubInterface *self,
GCallback callback,
- gpointer data);
+ gpointer user_data);
struct _FooObject
{
/**
* regress_test_cairo_context_full_return:
+ *
* Returns: (transfer full):
*/
cairo_t *
/**
* regress_test_cairo_surface_none_return:
+ *
* Returns: (transfer none):
*/
cairo_surface_t *
/**
* regress_test_cairo_surface_full_return:
+ *
* Returns: (transfer full):
*/
cairo_surface_t *
/**
* regress_test_utf8_const_return:
+ *
* Return value: UTF-8 string
*/
const char *
* @types: (array length=n_types): List of types
*
* Return value: (transfer full): string representation of provided types
- * */
+ */
char *
regress_test_array_gtype_in (int n_types, GType *types)
{
/**
* regress_test_array_fixed_size_int_return:
+ *
* Returns: (array fixed-size=5) (transfer full): a list of 5 integers ranging from 0 to 4
*/
int *
/**
* regress_test_array_int_full_out:
* @len: length of the returned array.
+ *
* Returns: (array length=len) (transfer full): a new array of integers.
*/
int *
/**
* regress_test_array_int_none_out:
* @len: length of the returned array.
+ *
* Returns: (array length=len) (transfer none): a static array of integers.
*/
int *
int (*matrix) (RegressTestObj *obj, const char *somestr);
/**
- * RegressTestObjClass::allow_none_vfunc
+ * RegressTestObjClass::allow_none_vfunc:
* @two: (allow-none): Another object
*/
void (*allow_none_vfunc) (RegressTestObj *obj, RegressTestObj *two);
// EXPECT:23: Warning: Test: scope annotation needs one value, not 2
-// EXPECT:12: Warning: Test: test_callback_invalid2: argument callback: Missing (scope) annotation for callback without GDestroyNotify (valid: call, async)
-// EXPECT:21: Warning: Test: test_callback_invalid3: argument callback: Missing (scope) annotation for callback without GDestroyNotify (valid: call, async)
+// EXPECT:13: Warning: Test: test_callback_invalid2: argument callback: Missing (scope) annotation for callback without GDestroyNotify (valid: call, async)
+// EXPECT:22: Warning: Test: test_callback_invalid3: argument callback: Missing (scope) annotation for callback without GDestroyNotify (valid: call, async)
// EXPECT:51: Warning: Test: element-type annotation takes at least one option, none given
// EXPECT:52: Warning: Test: invalid (element-type) for a GPtrArray, must be a pointer
// EXPECT:63: Warning: Test: test_unresolved_element_type: Unknown type: 'Unresolved'
-// EXPECT:3: Warning: Test: test_invalid_list_element_type: argument l1: Missing (element-type) annotation
-// EXPECT:3: Warning: Test: test_invalid_list_element_type: argument l2: Missing (element-type) annotation
+// EXPECT:4: Warning: Test: test_invalid_list_element_type: argument l1: Missing (element-type) annotation
+// EXPECT:4: Warning: Test: test_invalid_list_element_type: argument l2: Missing (element-type) annotation
// EXPECT:7: Warning: Test: test_method_no_parameters: Methods must have parameters
/**
- * test_method_invalid_first_parameter: (method):
+ * test_method_invalid_first_parameter: (method)
*
*/
void test_method_invalid_first_parameter(int param);
// EXPECT:15: Warning: Test: test_method_invalid_first_parameter: Methods must have a pointer as their first parameter
/**
- * test_method_invalid_namespace: (method):
+ * test_method_invalid_namespace: (method)
*
*/
void test_method_invalid_namespace(GClosure *param);
*/
GObject * test_get_object2(void);
-// EXPECT:7: Warning: Test: test_get_object2: return value: Missing (transfer) annotation
+// EXPECT:8: Warning: Test: test_get_object2: return value: Missing (transfer) annotation