[GTK] DOM bindings documentation errors
authorphiln@webkit.org <philn@webkit.org@268f45cc-cd09-0410-ab3c-d52691b4dbfc>
Tue, 29 Oct 2013 17:53:09 +0000 (17:53 +0000)
committerphiln@webkit.org <philn@webkit.org@268f45cc-cd09-0410-ab3c-d52691b4dbfc>
Tue, 29 Oct 2013 17:53:09 +0000 (17:53 +0000)
https://bugs.webkit.org/show_bug.cgi?id=123448

Reviewed by Carlos Garcia Campos.

* bindings/gobject/WebKitDOMCustom.h: Basic documentation for
return types.
* bindings/scripts/CodeGeneratorGObject.pm:
(GenerateFunction): Generate Returns documentation tag for
non-void return types and provide basic documentation.
* bindings/scripts/test/GObject/WebKitDOMTestActiveDOMObject.h:
Reset tests results.
* bindings/scripts/test/GObject/WebKitDOMTestCallback.h:
* bindings/scripts/test/GObject/WebKitDOMTestEventConstructor.h:
* bindings/scripts/test/GObject/WebKitDOMTestEventTarget.h:
* bindings/scripts/test/GObject/WebKitDOMTestException.h:
* bindings/scripts/test/GObject/WebKitDOMTestInterface.h:
* bindings/scripts/test/GObject/WebKitDOMTestObj.h:
* bindings/scripts/test/GObject/WebKitDOMTestSerializedScriptValueInterface.h:
* bindings/scripts/test/GObject/WebKitDOMTestTypedefs.h:
* bindings/scripts/test/GObject/WebKitDOMattribute.h:

git-svn-id: https://svn.webkit.org/repository/webkit/trunk@158200 268f45cc-cd09-0410-ab3c-d52691b4dbfc

13 files changed:
Source/WebCore/ChangeLog
Source/WebCore/bindings/gobject/WebKitDOMCustom.h
Source/WebCore/bindings/scripts/CodeGeneratorGObject.pm
Source/WebCore/bindings/scripts/test/GObject/WebKitDOMTestActiveDOMObject.h
Source/WebCore/bindings/scripts/test/GObject/WebKitDOMTestCallback.h
Source/WebCore/bindings/scripts/test/GObject/WebKitDOMTestEventConstructor.h
Source/WebCore/bindings/scripts/test/GObject/WebKitDOMTestEventTarget.h
Source/WebCore/bindings/scripts/test/GObject/WebKitDOMTestException.h
Source/WebCore/bindings/scripts/test/GObject/WebKitDOMTestInterface.h
Source/WebCore/bindings/scripts/test/GObject/WebKitDOMTestObj.h
Source/WebCore/bindings/scripts/test/GObject/WebKitDOMTestSerializedScriptValueInterface.h
Source/WebCore/bindings/scripts/test/GObject/WebKitDOMTestTypedefs.h
Source/WebCore/bindings/scripts/test/GObject/WebKitDOMattribute.h

index a2efb51..179f818 100644 (file)
@@ -1,3 +1,27 @@
+2013-10-29  Philippe Normand  <pnormand@igalia.com>
+
+        [GTK] DOM bindings documentation errors
+        https://bugs.webkit.org/show_bug.cgi?id=123448
+
+        Reviewed by Carlos Garcia Campos.
+
+        * bindings/gobject/WebKitDOMCustom.h: Basic documentation for
+        return types.
+        * bindings/scripts/CodeGeneratorGObject.pm:
+        (GenerateFunction): Generate Returns documentation tag for
+        non-void return types and provide basic documentation.
+        * bindings/scripts/test/GObject/WebKitDOMTestActiveDOMObject.h:
+        Reset tests results.
+        * bindings/scripts/test/GObject/WebKitDOMTestCallback.h:
+        * bindings/scripts/test/GObject/WebKitDOMTestEventConstructor.h:
+        * bindings/scripts/test/GObject/WebKitDOMTestEventTarget.h:
+        * bindings/scripts/test/GObject/WebKitDOMTestException.h:
+        * bindings/scripts/test/GObject/WebKitDOMTestInterface.h:
+        * bindings/scripts/test/GObject/WebKitDOMTestObj.h:
+        * bindings/scripts/test/GObject/WebKitDOMTestSerializedScriptValueInterface.h:
+        * bindings/scripts/test/GObject/WebKitDOMTestTypedefs.h:
+        * bindings/scripts/test/GObject/WebKitDOMattribute.h:
+
 2013-10-24  Brent Fulgham  <bfulgham@apple.com>
 
         Invalid cast in WebCore::toRenderMathMLBlock
index cf37076..2f82310 100644 (file)
@@ -29,7 +29,7 @@ G_BEGIN_DECLS
  * webkit_dom_html_text_area_element_is_edited:
  * @input: A #WebKitDOMHTMLTextAreaElement
  *
- * Returns:
+ * Returns: A #gboolean
  */
 WEBKIT_API gboolean webkit_dom_html_text_area_element_is_edited(WebKitDOMHTMLTextAreaElement* input);
 
@@ -37,7 +37,7 @@ WEBKIT_API gboolean webkit_dom_html_text_area_element_is_edited(WebKitDOMHTMLTex
  * webkit_dom_html_input_element_is_edited:
  * @input: A #WebKitDOMHTMLInputElement
  *
- * Returns:
+ * Returns: A #gboolean
  */
 WEBKIT_API gboolean webkit_dom_html_input_element_is_edited(WebKitDOMHTMLInputElement* input);
 
@@ -56,7 +56,7 @@ WEBKIT_API WebKitDOMBlob* webkit_dom_blob_webkit_slice(WebKitDOMBlob* self, gint
  * webkit_dom_html_element_get_class_name:
  * @element: A #WebKitDOMHTMLElement
  *
- * Returns:
+ * Returns: A #gchar
  *
  */
 WEBKIT_API gchar* webkit_dom_html_element_get_class_name(WebKitDOMHTMLElement* element);
@@ -98,7 +98,7 @@ WEBKIT_API void webkit_dom_html_form_element_dispatch_form_input(WebKitDOMHTMLFo
  *
  * This method is deprecated. Use webkit_dom_element_set_id() instead.
  *
- * Returns:
+ * Returns: A #gchar
  *
 **/
 WEBKIT_API gchar* webkit_dom_html_element_get_id(WebKitDOMHTMLElement* self);
@@ -119,7 +119,7 @@ WEBKIT_API void webkit_dom_html_element_set_id(WebKitDOMHTMLElement* self, const
  * webkit_dom_webkit_named_flow_get_overflow:
  * @flow: A #WebKitDOMWebKitNamedFlow
  *
- * Returns:
+ * Returns: A #gboolean
  *
  */
 WEBKIT_API gboolean webkit_dom_webkit_named_flow_get_overflow(WebKitDOMWebKitNamedFlow* flow);
@@ -128,7 +128,7 @@ WEBKIT_API gboolean webkit_dom_webkit_named_flow_get_overflow(WebKitDOMWebKitNam
  * webkit_dom_element_get_webkit_region_overflow:
  * @element: A #WebKitDOMElement
  *
- * Returns:
+ * Returns: A #gchar
  *
  */
 WEBKIT_API gchar* webkit_dom_element_get_webkit_region_overflow(WebKitDOMElement* element);
@@ -160,7 +160,7 @@ WEBKIT_API GType webkit_dom_bar_info_get_type(void);
  *
  * The BarInfo type has been removed from the DOM spec, this function does nothing.
  *
- * Returns:
+ * Returns: A #gboolean
  *
 **/
 WEBKIT_API gboolean webkit_dom_bar_info_get_visible(void* self);
@@ -194,7 +194,7 @@ WEBKIT_API WebKitDOMCSSValue* webkit_dom_css_style_declaration_get_property_css_
  *
  * This functionality has been removed from WebKit, this function does nothing.
  *
- * Returns:
+ * Returns: A #gboolean
  *
 **/
 WEBKIT_API gboolean webkit_dom_document_get_webkit_hidden(WebKitDOMDocument* self);
@@ -205,7 +205,7 @@ WEBKIT_API gboolean webkit_dom_document_get_webkit_hidden(WebKitDOMDocument* sel
  *
  * This functionality has been removed from WebKit, this function does nothing.
  *
- * Returns:
+ * Returns: A #gchar
  *
 **/
 WEBKIT_API gchar* webkit_dom_document_get_webkit_visibility_state(WebKitDOMDocument* self);
@@ -233,7 +233,7 @@ WEBKIT_API void webkit_dom_html_element_set_item_id(WebKitDOMHTMLElement* self,
  *
  * This functionality has been removed from WebKit, this function does nothing.
  *
- * Returns:
+ * Returns: A #gchar
  *
 **/
 WEBKIT_API gchar* webkit_dom_html_element_get_item_id(WebKitDOMHTMLElement* self);
@@ -276,7 +276,7 @@ WEBKIT_API void webkit_dom_html_element_set_item_scope(WebKitDOMHTMLElement* sel
  *
  * This functionality has been removed from WebKit, this function does nothing.
  *
- * Returns:
+ * Returns: A #gboolean
  *
 **/
 WEBKIT_API gboolean webkit_dom_html_element_get_item_scope(WebKitDOMHTMLElement* self);
@@ -309,7 +309,7 @@ WEBKIT_API void webkit_dom_html_style_element_set_scoped(WebKitDOMHTMLStyleEleme
  *
  * This functionality has been removed from WebKit, this function does nothing.
  *
- * Returns:
+ * Returns: A #gboolean
  *
 **/
 WEBKIT_API gboolean webkit_dom_html_style_element_get_scoped(WebKitDOMHTMLStyleElement* self);
@@ -347,7 +347,7 @@ WEBKIT_API void* webkit_dom_html_properties_collection_named_item(void* self, co
  *
  * The PropertiesCollection object has been removed from WebKit, this function does nothing.
  *
- * Returns:
+ * Returns: A #gulong
  *
 **/
 WEBKIT_API gulong webkit_dom_html_properties_collection_get_length(void* self);
@@ -380,7 +380,7 @@ WEBKIT_API WebKitDOMNamedNodeMap* webkit_dom_node_get_attributes(WebKitDOMNode*
  *
  * This functionality has been removed from WebKit, this function does nothing.
  *
- * Returns:
+ * Returns: A #gboolean
  *
 **/
 WEBKIT_API gboolean webkit_dom_node_has_attributes(WebKitDOMNode* self);
@@ -393,7 +393,7 @@ WEBKIT_API GType webkit_dom_memory_info_get_type(void);
  *
  * The MemoryInfo object has been removed from WebKit, this function does nothing.
  *
- * Returns:
+ * Returns: A #gulong
  *
 **/
 WEBKIT_API gulong webkit_dom_memory_info_get_total_js_heap_size(void* self);
@@ -404,7 +404,7 @@ WEBKIT_API gulong webkit_dom_memory_info_get_total_js_heap_size(void* self);
  *
  * The MemoryInfo object has been removed from WebKit, this function does nothing.
  *
- * Returns:
+ * Returns: A #gulong
  *
 **/
 WEBKIT_API gulong webkit_dom_memory_info_get_used_js_heap_size(void* self);
@@ -415,7 +415,7 @@ WEBKIT_API gulong webkit_dom_memory_info_get_used_js_heap_size(void* self);
  *
  * The MemoryInfo object has been removed from WebKit, this function does nothing.
  *
- * Returns:
+ * Returns: A #gulong
  *
 **/
 WEBKIT_API gulong webkit_dom_memory_info_get_js_heap_size_limit(void* self);
@@ -453,7 +453,7 @@ WEBKIT_API WebKitDOMNode* webkit_dom_property_node_list_item(void* self, gulong
  *
  * The PropertyNodeList object has been removed from WebKit, this function does nothing.
  *
- * Returns:
+ * Returns: A #gulong
  *
 **/
 WEBKIT_API gulong webkit_dom_property_node_list_get_length(void* self);
@@ -464,10 +464,10 @@ WEBKIT_API gulong webkit_dom_property_node_list_get_length(void* self);
  *
  * The HTMLMediaElement:start-time property has been removed from WebKit, this function does nothing.
  *
- * Returns:
+ * Returns: A #gdouble
  *
 **/
-WEBKIT_API gdouble webkit_dom_html_media_element_get_start_time(WebKitDOMHTMLMediaElement*);
+WEBKIT_API gdouble webkit_dom_html_media_element_get_start_time(WebKitDOMHTMLMediaElement* self);
 
 G_END_DECLS
 
index b4f3b26..5b42935 100644 (file)
@@ -976,10 +976,12 @@ sub GenerateFunction {
     }
     push(@hBody, " * \@error: #GError\n") if $raisesException;
     push(@hBody, " *\n");
-    if (IsGDOMClassType($function->signature->type)) {
-        push(@hBody, " * Returns: (transfer none):\n");
+    my $returnTypeName = $returnType;
+    $returnTypeName =~ s/\*$//;
+    if ($returnValueIsGDOMType) {
+        push(@hBody, " * Returns: (transfer none): A #${returnTypeName}\n");
     } elsif ($returnType ne "void") {
-        push(@hBody, " * Returns:\n");
+        push(@hBody, " * Returns: A #${returnTypeName}\n");
     }
     if ($deprecationVersion) {
         push(@hBody, " *\n");
index 941052d..7a5d567 100644 (file)
@@ -71,7 +71,7 @@ webkit_dom_test_active_dom_object_post_message(WebKitDOMTestActiveDOMObject* sel
  * webkit_dom_test_active_dom_object_get_exciting_attr:
  * @self: A #WebKitDOMTestActiveDOMObject
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_active_dom_object_get_exciting_attr(WebKitDOMTestActiveDOMObject* self);
index 92e1530..e5e6a90 100644 (file)
@@ -53,7 +53,7 @@ webkit_dom_test_callback_get_type (void);
  * webkit_dom_test_callback_callback_with_no_param:
  * @self: A #WebKitDOMTestCallback
  *
- * Returns:
+ * Returns: A #gboolean
 **/
 WEBKIT_API gboolean
 webkit_dom_test_callback_callback_with_no_param(WebKitDOMTestCallback* self);
@@ -63,7 +63,7 @@ webkit_dom_test_callback_callback_with_no_param(WebKitDOMTestCallback* self);
  * @self: A #WebKitDOMTestCallback
  * @arrayParam: A #WebKitDOMFloat32Array
  *
- * Returns:
+ * Returns: A #gboolean
 **/
 WEBKIT_API gboolean
 webkit_dom_test_callback_callback_with_array_param(WebKitDOMTestCallback* self, WebKitDOMFloat32Array* arrayParam);
@@ -74,7 +74,7 @@ webkit_dom_test_callback_callback_with_array_param(WebKitDOMTestCallback* self,
  * @srzParam: A #WebKitDOMSerializedScriptValue
  * @strArg: A #gchar
  *
- * Returns:
+ * Returns: A #gboolean
 **/
 WEBKIT_API gboolean
 webkit_dom_test_callback_callback_with_serialized_script_value_param(WebKitDOMTestCallback* self, WebKitDOMSerializedScriptValue* srzParam, const gchar* strArg);
@@ -84,7 +84,7 @@ webkit_dom_test_callback_callback_with_serialized_script_value_param(WebKitDOMTe
  * @self: A #WebKitDOMTestCallback
  * @strArg: A #gchar
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_callback_callback_with_non_bool_return_type(WebKitDOMTestCallback* self, const gchar* strArg);
@@ -94,7 +94,7 @@ webkit_dom_test_callback_callback_with_non_bool_return_type(WebKitDOMTestCallbac
  * @self: A #WebKitDOMTestCallback
  * @listParam: A #WebKitDOMDOMStringList
  *
- * Returns:
+ * Returns: A #gboolean
 **/
 WEBKIT_API gboolean
 webkit_dom_test_callback_callback_with_string_list(WebKitDOMTestCallback* self, WebKitDOMDOMStringList* listParam);
@@ -104,7 +104,7 @@ webkit_dom_test_callback_callback_with_string_list(WebKitDOMTestCallback* self,
  * @self: A #WebKitDOMTestCallback
  * @boolParam: A #gboolean
  *
- * Returns:
+ * Returns: A #gboolean
 **/
 WEBKIT_API gboolean
 webkit_dom_test_callback_callback_with_boolean(WebKitDOMTestCallback* self, gboolean boolParam);
@@ -115,7 +115,7 @@ webkit_dom_test_callback_callback_with_boolean(WebKitDOMTestCallback* self, gboo
  * @longParam: A #glong
  * @testNodeParam: A #WebKitDOMTestNode
  *
- * Returns:
+ * Returns: A #gboolean
 **/
 WEBKIT_API gboolean
 webkit_dom_test_callback_callback_requires_this_to_pass(WebKitDOMTestCallback* self, glong longParam, WebKitDOMTestNode* testNodeParam);
index cfb71ba..098ba19 100644 (file)
@@ -53,7 +53,7 @@ webkit_dom_test_event_constructor_get_type (void);
  * webkit_dom_test_event_constructor_get_attr1:
  * @self: A #WebKitDOMTestEventConstructor
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_event_constructor_get_attr1(WebKitDOMTestEventConstructor* self);
@@ -62,7 +62,7 @@ webkit_dom_test_event_constructor_get_attr1(WebKitDOMTestEventConstructor* self)
  * webkit_dom_test_event_constructor_get_attr2:
  * @self: A #WebKitDOMTestEventConstructor
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_event_constructor_get_attr2(WebKitDOMTestEventConstructor* self);
index 2429dca..f601afb 100644 (file)
@@ -54,7 +54,7 @@ webkit_dom_test_event_target_get_type (void);
  * @self: A #WebKitDOMTestEventTarget
  * @index: A #gulong
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMNode
 **/
 WEBKIT_API WebKitDOMNode*
 webkit_dom_test_event_target_item(WebKitDOMTestEventTarget* self, gulong index);
@@ -65,7 +65,7 @@ webkit_dom_test_event_target_item(WebKitDOMTestEventTarget* self, gulong index);
  * @evt: A #WebKitDOMEvent
  * @error: #GError
  *
- * Returns:
+ * Returns: A #gboolean
  *
  * Deprecated: 2.4: Use webkit_dom_event_target_dispatch_event() instead.
 **/
index d5ddfcc..596dfbd 100644 (file)
@@ -53,7 +53,7 @@ webkit_dom_test_exception_get_type (void);
  * webkit_dom_test_exception_get_name:
  * @self: A #WebKitDOMTestException
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_exception_get_name(WebKitDOMTestException* self);
index b67c21a..558f5b9 100644 (file)
@@ -64,7 +64,7 @@ webkit_dom_test_interface_implements_method1(WebKitDOMTestInterface* self);
  * @objArg: A #WebKitDOMTestObj
  * @error: #GError
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_interface_implements_method2(WebKitDOMTestInterface* self, const gchar* strArg, WebKitDOMTestObj* objArg, GError** error);
@@ -92,7 +92,7 @@ webkit_dom_test_interface_supplemental_method1(WebKitDOMTestInterface* self);
  * @objArg: A #WebKitDOMTestObj
  * @error: #GError
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_interface_supplemental_method2(WebKitDOMTestInterface* self, const gchar* strArg, WebKitDOMTestObj* objArg, GError** error);
@@ -109,7 +109,7 @@ webkit_dom_test_interface_supplemental_method4(WebKitDOMTestInterface* self);
  * webkit_dom_test_interface_get_implements_str1:
  * @self: A #WebKitDOMTestInterface
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_interface_get_implements_str1(WebKitDOMTestInterface* self);
@@ -118,7 +118,7 @@ webkit_dom_test_interface_get_implements_str1(WebKitDOMTestInterface* self);
  * webkit_dom_test_interface_get_implements_str2:
  * @self: A #WebKitDOMTestInterface
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_interface_get_implements_str2(WebKitDOMTestInterface* self);
@@ -136,7 +136,7 @@ webkit_dom_test_interface_set_implements_str2(WebKitDOMTestInterface* self, cons
  * webkit_dom_test_interface_get_implements_node:
  * @self: A #WebKitDOMTestInterface
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMNode
 **/
 WEBKIT_API WebKitDOMNode*
 webkit_dom_test_interface_get_implements_node(WebKitDOMTestInterface* self);
@@ -146,7 +146,6 @@ webkit_dom_test_interface_get_implements_node(WebKitDOMTestInterface* self);
  * @self: A #WebKitDOMTestInterface
  * @value: A #WebKitDOMNode
  *
- * Returns: (transfer none):
 **/
 WEBKIT_API void
 webkit_dom_test_interface_set_implements_node(WebKitDOMTestInterface* self, WebKitDOMNode* value);
@@ -155,7 +154,7 @@ webkit_dom_test_interface_set_implements_node(WebKitDOMTestInterface* self, WebK
  * webkit_dom_test_interface_get_supplemental_str1:
  * @self: A #WebKitDOMTestInterface
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_interface_get_supplemental_str1(WebKitDOMTestInterface* self);
@@ -164,7 +163,7 @@ webkit_dom_test_interface_get_supplemental_str1(WebKitDOMTestInterface* self);
  * webkit_dom_test_interface_get_supplemental_str2:
  * @self: A #WebKitDOMTestInterface
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_interface_get_supplemental_str2(WebKitDOMTestInterface* self);
@@ -182,7 +181,7 @@ webkit_dom_test_interface_set_supplemental_str2(WebKitDOMTestInterface* self, co
  * webkit_dom_test_interface_get_supplemental_node:
  * @self: A #WebKitDOMTestInterface
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMNode
 **/
 WEBKIT_API WebKitDOMNode*
 webkit_dom_test_interface_get_supplemental_node(WebKitDOMTestInterface* self);
@@ -192,7 +191,6 @@ webkit_dom_test_interface_get_supplemental_node(WebKitDOMTestInterface* self);
  * @self: A #WebKitDOMTestInterface
  * @value: A #WebKitDOMNode
  *
- * Returns: (transfer none):
 **/
 WEBKIT_API void
 webkit_dom_test_interface_set_supplemental_node(WebKitDOMTestInterface* self, WebKitDOMNode* value);
index 4cad5dc..01be63c 100644 (file)
@@ -72,7 +72,7 @@ webkit_dom_test_obj_void_method_with_args(WebKitDOMTestObj* self, glong longArg,
  * webkit_dom_test_obj_byte_method:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gint8
 **/
 WEBKIT_API gint8
 webkit_dom_test_obj_byte_method(WebKitDOMTestObj* self);
@@ -84,7 +84,7 @@ webkit_dom_test_obj_byte_method(WebKitDOMTestObj* self);
  * @strArg: A #gchar
  * @objArg: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gint8
 **/
 WEBKIT_API gint8
 webkit_dom_test_obj_byte_method_with_args(WebKitDOMTestObj* self, gint8 byteArg, const gchar* strArg, WebKitDOMTestObj* objArg);
@@ -93,7 +93,7 @@ webkit_dom_test_obj_byte_method_with_args(WebKitDOMTestObj* self, gint8 byteArg,
  * webkit_dom_test_obj_octet_method:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #guint8
 **/
 WEBKIT_API guint8
 webkit_dom_test_obj_octet_method(WebKitDOMTestObj* self);
@@ -105,7 +105,7 @@ webkit_dom_test_obj_octet_method(WebKitDOMTestObj* self);
  * @strArg: A #gchar
  * @objArg: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #guint8
 **/
 WEBKIT_API guint8
 webkit_dom_test_obj_octet_method_with_args(WebKitDOMTestObj* self, guint8 octetArg, const gchar* strArg, WebKitDOMTestObj* objArg);
@@ -114,7 +114,7 @@ webkit_dom_test_obj_octet_method_with_args(WebKitDOMTestObj* self, guint8 octetA
  * webkit_dom_test_obj_long_method:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_long_method(WebKitDOMTestObj* self);
@@ -126,7 +126,7 @@ webkit_dom_test_obj_long_method(WebKitDOMTestObj* self);
  * @strArg: A #gchar
  * @objArg: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_long_method_with_args(WebKitDOMTestObj* self, glong longArg, const gchar* strArg, WebKitDOMTestObj* objArg);
@@ -135,7 +135,7 @@ webkit_dom_test_obj_long_method_with_args(WebKitDOMTestObj* self, glong longArg,
  * webkit_dom_test_obj_obj_method:
  * @self: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_obj_obj_method(WebKitDOMTestObj* self);
@@ -147,7 +147,7 @@ webkit_dom_test_obj_obj_method(WebKitDOMTestObj* self);
  * @strArg: A #gchar
  * @objArg: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_obj_obj_method_with_args(WebKitDOMTestObj* self, glong longArg, const gchar* strArg, WebKitDOMTestObj* objArg);
@@ -168,7 +168,7 @@ webkit_dom_test_obj_method_with_enum_arg(WebKitDOMTestObj* self, WebKitDOMTestEn
  * @objArg: A #WebKitDOMTestObj
  * @error: #GError
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_obj_method_that_requires_all_args_and_throws(WebKitDOMTestObj* self, const gchar* strArg, WebKitDOMTestObj* objArg, GError** error);
@@ -213,7 +213,7 @@ webkit_dom_test_obj_with_script_state_void(WebKitDOMTestObj* self);
  * webkit_dom_test_obj_with_script_state_obj:
  * @self: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_obj_with_script_state_obj(WebKitDOMTestObj* self);
@@ -232,7 +232,7 @@ webkit_dom_test_obj_with_script_state_void_exception(WebKitDOMTestObj* self, GEr
  * @self: A #WebKitDOMTestObj
  * @error: #GError
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_obj_with_script_state_obj_exception(WebKitDOMTestObj* self, GError** error);
@@ -258,7 +258,7 @@ webkit_dom_test_obj_with_script_execution_context_and_script_state(WebKitDOMTest
  * @self: A #WebKitDOMTestObj
  * @error: #GError
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_obj_with_script_execution_context_and_script_state_obj_exception(WebKitDOMTestObj* self, GError** error);
@@ -267,7 +267,7 @@ webkit_dom_test_obj_with_script_execution_context_and_script_state_obj_exception
  * webkit_dom_test_obj_with_script_execution_context_and_script_state_with_spaces:
  * @self: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_obj_with_script_execution_context_and_script_state_with_spaces(WebKitDOMTestObj* self);
@@ -333,7 +333,7 @@ webkit_dom_test_obj_method_with_optional_string_is_null_string(WebKitDOMTestObj*
  * webkit_dom_test_obj_conditional_method1:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_obj_conditional_method1(WebKitDOMTestObj* self);
@@ -367,7 +367,7 @@ webkit_dom_test_obj_class_method(WebKitDOMTestObj* self);
  * @self: A #WebKitDOMTestObj
  * @arg: A #glong
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_class_method_with_optional(WebKitDOMTestObj* self, glong arg);
@@ -430,7 +430,7 @@ webkit_dom_test_obj_convert5(WebKitDOMTestObj* self, WebKitDOMTestNode* value);
  * webkit_dom_test_obj_mutable_point_function:
  * @self: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMSVGPoint
 **/
 WEBKIT_API WebKitDOMSVGPoint*
 webkit_dom_test_obj_mutable_point_function(WebKitDOMTestObj* self);
@@ -439,7 +439,7 @@ webkit_dom_test_obj_mutable_point_function(WebKitDOMTestObj* self);
  * webkit_dom_test_obj_immutable_point_function:
  * @self: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMSVGPoint
 **/
 WEBKIT_API WebKitDOMSVGPoint*
 webkit_dom_test_obj_immutable_point_function(WebKitDOMTestObj* self);
@@ -460,7 +460,7 @@ webkit_dom_test_obj_orange(WebKitDOMTestObj* self);
  * @b: A #glong
  * @error: #GError
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMbool
 **/
 WEBKIT_API WebKitDOMbool*
 webkit_dom_test_obj_strict_function(WebKitDOMTestObj* self, const gchar* str, gfloat a, glong b, GError** error);
@@ -509,7 +509,7 @@ webkit_dom_test_obj_any(WebKitDOMTestObj* self, gfloat a, glong b);
  * webkit_dom_test_obj_get_read_only_long_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_read_only_long_attr(WebKitDOMTestObj* self);
@@ -518,7 +518,7 @@ webkit_dom_test_obj_get_read_only_long_attr(WebKitDOMTestObj* self);
  * webkit_dom_test_obj_get_read_only_string_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_obj_get_read_only_string_attr(WebKitDOMTestObj* self);
@@ -527,7 +527,7 @@ webkit_dom_test_obj_get_read_only_string_attr(WebKitDOMTestObj* self);
  * webkit_dom_test_obj_get_read_only_test_obj_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_obj_get_read_only_test_obj_attr(WebKitDOMTestObj* self);
@@ -536,7 +536,7 @@ webkit_dom_test_obj_get_read_only_test_obj_attr(WebKitDOMTestObj* self);
  * webkit_dom_test_obj_get_byte_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gint8
 **/
 WEBKIT_API gint8
 webkit_dom_test_obj_get_byte_attr(WebKitDOMTestObj* self);
@@ -554,7 +554,7 @@ webkit_dom_test_obj_set_byte_attr(WebKitDOMTestObj* self, gint8 value);
  * webkit_dom_test_obj_get_octet_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #guint8
 **/
 WEBKIT_API guint8
 webkit_dom_test_obj_get_octet_attr(WebKitDOMTestObj* self);
@@ -572,7 +572,7 @@ webkit_dom_test_obj_set_octet_attr(WebKitDOMTestObj* self, guint8 value);
  * webkit_dom_test_obj_get_short_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gshort
 **/
 WEBKIT_API gshort
 webkit_dom_test_obj_get_short_attr(WebKitDOMTestObj* self);
@@ -590,7 +590,7 @@ webkit_dom_test_obj_set_short_attr(WebKitDOMTestObj* self, gshort value);
  * webkit_dom_test_obj_get_unsigned_short_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gushort
 **/
 WEBKIT_API gushort
 webkit_dom_test_obj_get_unsigned_short_attr(WebKitDOMTestObj* self);
@@ -608,7 +608,7 @@ webkit_dom_test_obj_set_unsigned_short_attr(WebKitDOMTestObj* self, gushort valu
  * webkit_dom_test_obj_get_long_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_long_attr(WebKitDOMTestObj* self);
@@ -626,7 +626,7 @@ webkit_dom_test_obj_set_long_attr(WebKitDOMTestObj* self, glong value);
  * webkit_dom_test_obj_get_long_long_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gint64
 **/
 WEBKIT_API gint64
 webkit_dom_test_obj_get_long_long_attr(WebKitDOMTestObj* self);
@@ -644,7 +644,7 @@ webkit_dom_test_obj_set_long_long_attr(WebKitDOMTestObj* self, gint64 value);
  * webkit_dom_test_obj_get_unsigned_long_long_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #guint64
 **/
 WEBKIT_API guint64
 webkit_dom_test_obj_get_unsigned_long_long_attr(WebKitDOMTestObj* self);
@@ -662,7 +662,7 @@ webkit_dom_test_obj_set_unsigned_long_long_attr(WebKitDOMTestObj* self, guint64
  * webkit_dom_test_obj_get_string_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_obj_get_string_attr(WebKitDOMTestObj* self);
@@ -680,7 +680,7 @@ webkit_dom_test_obj_set_string_attr(WebKitDOMTestObj* self, const gchar* value);
  * webkit_dom_test_obj_get_test_obj_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_obj_get_test_obj_attr(WebKitDOMTestObj* self);
@@ -690,7 +690,6 @@ webkit_dom_test_obj_get_test_obj_attr(WebKitDOMTestObj* self);
  * @self: A #WebKitDOMTestObj
  * @value: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
 **/
 WEBKIT_API void
 webkit_dom_test_obj_set_test_obj_attr(WebKitDOMTestObj* self, WebKitDOMTestObj* value);
@@ -699,7 +698,7 @@ webkit_dom_test_obj_set_test_obj_attr(WebKitDOMTestObj* self, WebKitDOMTestObj*
  * webkit_dom_test_obj_get_xml_obj_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_obj_get_xml_obj_attr(WebKitDOMTestObj* self);
@@ -709,7 +708,6 @@ webkit_dom_test_obj_get_xml_obj_attr(WebKitDOMTestObj* self);
  * @self: A #WebKitDOMTestObj
  * @value: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
 **/
 WEBKIT_API void
 webkit_dom_test_obj_set_xml_obj_attr(WebKitDOMTestObj* self, WebKitDOMTestObj* value);
@@ -718,7 +716,7 @@ webkit_dom_test_obj_set_xml_obj_attr(WebKitDOMTestObj* self, WebKitDOMTestObj* v
  * webkit_dom_test_obj_get_create:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gboolean
 **/
 WEBKIT_API gboolean
 webkit_dom_test_obj_get_create(WebKitDOMTestObj* self);
@@ -736,7 +734,7 @@ webkit_dom_test_obj_set_create(WebKitDOMTestObj* self, gboolean value);
  * webkit_dom_test_obj_get_reflected_string_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_obj_get_reflected_string_attr(WebKitDOMTestObj* self);
@@ -754,7 +752,7 @@ webkit_dom_test_obj_set_reflected_string_attr(WebKitDOMTestObj* self, const gcha
  * webkit_dom_test_obj_get_reflected_integral_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_reflected_integral_attr(WebKitDOMTestObj* self);
@@ -772,7 +770,7 @@ webkit_dom_test_obj_set_reflected_integral_attr(WebKitDOMTestObj* self, glong va
  * webkit_dom_test_obj_get_reflected_unsigned_integral_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gulong
 **/
 WEBKIT_API gulong
 webkit_dom_test_obj_get_reflected_unsigned_integral_attr(WebKitDOMTestObj* self);
@@ -790,7 +788,7 @@ webkit_dom_test_obj_set_reflected_unsigned_integral_attr(WebKitDOMTestObj* self,
  * webkit_dom_test_obj_get_reflected_boolean_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gboolean
 **/
 WEBKIT_API gboolean
 webkit_dom_test_obj_get_reflected_boolean_attr(WebKitDOMTestObj* self);
@@ -808,7 +806,7 @@ webkit_dom_test_obj_set_reflected_boolean_attr(WebKitDOMTestObj* self, gboolean
  * webkit_dom_test_obj_get_reflected_url_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_obj_get_reflected_url_attr(WebKitDOMTestObj* self);
@@ -826,7 +824,7 @@ webkit_dom_test_obj_set_reflected_url_attr(WebKitDOMTestObj* self, const gchar*
  * webkit_dom_test_obj_get_reflected_string_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_obj_get_reflected_string_attr(WebKitDOMTestObj* self);
@@ -844,7 +842,7 @@ webkit_dom_test_obj_set_reflected_string_attr(WebKitDOMTestObj* self, const gcha
  * webkit_dom_test_obj_get_reflected_custom_integral_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_reflected_custom_integral_attr(WebKitDOMTestObj* self);
@@ -862,7 +860,7 @@ webkit_dom_test_obj_set_reflected_custom_integral_attr(WebKitDOMTestObj* self, g
  * webkit_dom_test_obj_get_reflected_custom_boolean_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gboolean
 **/
 WEBKIT_API gboolean
 webkit_dom_test_obj_get_reflected_custom_boolean_attr(WebKitDOMTestObj* self);
@@ -880,7 +878,7 @@ webkit_dom_test_obj_set_reflected_custom_boolean_attr(WebKitDOMTestObj* self, gb
  * webkit_dom_test_obj_get_reflected_custom_url_attr:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_obj_get_reflected_custom_url_attr(WebKitDOMTestObj* self);
@@ -899,7 +897,7 @@ webkit_dom_test_obj_set_reflected_custom_url_attr(WebKitDOMTestObj* self, const
  * @self: A #WebKitDOMTestObj
  * @error: #GError
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_attr_with_getter_exception(WebKitDOMTestObj* self, GError** error);
@@ -917,7 +915,7 @@ webkit_dom_test_obj_set_attr_with_getter_exception(WebKitDOMTestObj* self, glong
  * webkit_dom_test_obj_get_attr_with_setter_exception:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_attr_with_setter_exception(WebKitDOMTestObj* self);
@@ -937,7 +935,7 @@ webkit_dom_test_obj_set_attr_with_setter_exception(WebKitDOMTestObj* self, glong
  * @self: A #WebKitDOMTestObj
  * @error: #GError
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_obj_get_string_attr_with_getter_exception(WebKitDOMTestObj* self, GError** error);
@@ -955,7 +953,7 @@ webkit_dom_test_obj_set_string_attr_with_getter_exception(WebKitDOMTestObj* self
  * webkit_dom_test_obj_get_string_attr_with_setter_exception:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_obj_get_string_attr_with_setter_exception(WebKitDOMTestObj* self);
@@ -974,7 +972,7 @@ webkit_dom_test_obj_set_string_attr_with_setter_exception(WebKitDOMTestObj* self
  * webkit_dom_test_obj_get_with_script_state_attribute:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_with_script_state_attribute(WebKitDOMTestObj* self);
@@ -992,7 +990,7 @@ webkit_dom_test_obj_set_with_script_state_attribute(WebKitDOMTestObj* self, glon
  * webkit_dom_test_obj_get_with_script_execution_context_attribute:
  * @self: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_obj_get_with_script_execution_context_attribute(WebKitDOMTestObj* self);
@@ -1002,7 +1000,6 @@ webkit_dom_test_obj_get_with_script_execution_context_attribute(WebKitDOMTestObj
  * @self: A #WebKitDOMTestObj
  * @value: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
 **/
 WEBKIT_API void
 webkit_dom_test_obj_set_with_script_execution_context_attribute(WebKitDOMTestObj* self, WebKitDOMTestObj* value);
@@ -1012,7 +1009,7 @@ webkit_dom_test_obj_set_with_script_execution_context_attribute(WebKitDOMTestObj
  * @self: A #WebKitDOMTestObj
  * @error: #GError
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_obj_get_with_script_state_attribute_raises(WebKitDOMTestObj* self, GError** error);
@@ -1022,7 +1019,6 @@ webkit_dom_test_obj_get_with_script_state_attribute_raises(WebKitDOMTestObj* sel
  * @self: A #WebKitDOMTestObj
  * @value: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
 **/
 WEBKIT_API void
 webkit_dom_test_obj_set_with_script_state_attribute_raises(WebKitDOMTestObj* self, WebKitDOMTestObj* value);
@@ -1032,7 +1028,7 @@ webkit_dom_test_obj_set_with_script_state_attribute_raises(WebKitDOMTestObj* sel
  * @self: A #WebKitDOMTestObj
  * @error: #GError
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_obj_get_with_script_execution_context_attribute_raises(WebKitDOMTestObj* self, GError** error);
@@ -1042,7 +1038,6 @@ webkit_dom_test_obj_get_with_script_execution_context_attribute_raises(WebKitDOM
  * @self: A #WebKitDOMTestObj
  * @value: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
 **/
 WEBKIT_API void
 webkit_dom_test_obj_set_with_script_execution_context_attribute_raises(WebKitDOMTestObj* self, WebKitDOMTestObj* value);
@@ -1051,7 +1046,7 @@ webkit_dom_test_obj_set_with_script_execution_context_attribute_raises(WebKitDOM
  * webkit_dom_test_obj_get_with_script_execution_context_and_script_state_attribute:
  * @self: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_obj_get_with_script_execution_context_and_script_state_attribute(WebKitDOMTestObj* self);
@@ -1061,7 +1056,6 @@ webkit_dom_test_obj_get_with_script_execution_context_and_script_state_attribute
  * @self: A #WebKitDOMTestObj
  * @value: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
 **/
 WEBKIT_API void
 webkit_dom_test_obj_set_with_script_execution_context_and_script_state_attribute(WebKitDOMTestObj* self, WebKitDOMTestObj* value);
@@ -1071,7 +1065,7 @@ webkit_dom_test_obj_set_with_script_execution_context_and_script_state_attribute
  * @self: A #WebKitDOMTestObj
  * @error: #GError
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_obj_get_with_script_execution_context_and_script_state_attribute_raises(WebKitDOMTestObj* self, GError** error);
@@ -1081,7 +1075,6 @@ webkit_dom_test_obj_get_with_script_execution_context_and_script_state_attribute
  * @self: A #WebKitDOMTestObj
  * @value: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
 **/
 WEBKIT_API void
 webkit_dom_test_obj_set_with_script_execution_context_and_script_state_attribute_raises(WebKitDOMTestObj* self, WebKitDOMTestObj* value);
@@ -1090,7 +1083,7 @@ webkit_dom_test_obj_set_with_script_execution_context_and_script_state_attribute
  * webkit_dom_test_obj_get_with_script_execution_context_and_script_state_with_spaces_attribute:
  * @self: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMTestObj
 **/
 WEBKIT_API WebKitDOMTestObj*
 webkit_dom_test_obj_get_with_script_execution_context_and_script_state_with_spaces_attribute(WebKitDOMTestObj* self);
@@ -1100,7 +1093,6 @@ webkit_dom_test_obj_get_with_script_execution_context_and_script_state_with_spac
  * @self: A #WebKitDOMTestObj
  * @value: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
 **/
 WEBKIT_API void
 webkit_dom_test_obj_set_with_script_execution_context_and_script_state_with_spaces_attribute(WebKitDOMTestObj* self, WebKitDOMTestObj* value);
@@ -1109,7 +1101,7 @@ webkit_dom_test_obj_set_with_script_execution_context_and_script_state_with_spac
  * webkit_dom_test_obj_get_conditional_attr1:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_conditional_attr1(WebKitDOMTestObj* self);
@@ -1127,7 +1119,7 @@ webkit_dom_test_obj_set_conditional_attr1(WebKitDOMTestObj* self, glong value);
  * webkit_dom_test_obj_get_conditional_attr2:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_conditional_attr2(WebKitDOMTestObj* self);
@@ -1145,7 +1137,7 @@ webkit_dom_test_obj_set_conditional_attr2(WebKitDOMTestObj* self, glong value);
  * webkit_dom_test_obj_get_conditional_attr3:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_conditional_attr3(WebKitDOMTestObj* self);
@@ -1163,7 +1155,7 @@ webkit_dom_test_obj_set_conditional_attr3(WebKitDOMTestObj* self, glong value);
  * webkit_dom_test_obj_get_any_attribute:
  * @self: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMany
 **/
 WEBKIT_API WebKitDOMany*
 webkit_dom_test_obj_get_any_attribute(WebKitDOMTestObj* self);
@@ -1173,7 +1165,6 @@ webkit_dom_test_obj_get_any_attribute(WebKitDOMTestObj* self);
  * @self: A #WebKitDOMTestObj
  * @value: A #WebKitDOMany
  *
- * Returns: (transfer none):
 **/
 WEBKIT_API void
 webkit_dom_test_obj_set_any_attribute(WebKitDOMTestObj* self, WebKitDOMany* value);
@@ -1182,7 +1173,7 @@ webkit_dom_test_obj_set_any_attribute(WebKitDOMTestObj* self, WebKitDOMany* valu
  * webkit_dom_test_obj_get_content_document:
  * @self: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMDocument
 **/
 WEBKIT_API WebKitDOMDocument*
 webkit_dom_test_obj_get_content_document(WebKitDOMTestObj* self);
@@ -1191,7 +1182,7 @@ webkit_dom_test_obj_get_content_document(WebKitDOMTestObj* self);
  * webkit_dom_test_obj_get_mutable_point:
  * @self: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMSVGPoint
 **/
 WEBKIT_API WebKitDOMSVGPoint*
 webkit_dom_test_obj_get_mutable_point(WebKitDOMTestObj* self);
@@ -1201,7 +1192,6 @@ webkit_dom_test_obj_get_mutable_point(WebKitDOMTestObj* self);
  * @self: A #WebKitDOMTestObj
  * @value: A #WebKitDOMSVGPoint
  *
- * Returns: (transfer none):
 **/
 WEBKIT_API void
 webkit_dom_test_obj_set_mutable_point(WebKitDOMTestObj* self, WebKitDOMSVGPoint* value);
@@ -1210,7 +1200,7 @@ webkit_dom_test_obj_set_mutable_point(WebKitDOMTestObj* self, WebKitDOMSVGPoint*
  * webkit_dom_test_obj_get_immutable_point:
  * @self: A #WebKitDOMTestObj
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMSVGPoint
 **/
 WEBKIT_API WebKitDOMSVGPoint*
 webkit_dom_test_obj_get_immutable_point(WebKitDOMTestObj* self);
@@ -1220,7 +1210,6 @@ webkit_dom_test_obj_get_immutable_point(WebKitDOMTestObj* self);
  * @self: A #WebKitDOMTestObj
  * @value: A #WebKitDOMSVGPoint
  *
- * Returns: (transfer none):
 **/
 WEBKIT_API void
 webkit_dom_test_obj_set_immutable_point(WebKitDOMTestObj* self, WebKitDOMSVGPoint* value);
@@ -1229,7 +1218,7 @@ webkit_dom_test_obj_set_immutable_point(WebKitDOMTestObj* self, WebKitDOMSVGPoin
  * webkit_dom_test_obj_get_strawberry:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_strawberry(WebKitDOMTestObj* self);
@@ -1247,7 +1236,7 @@ webkit_dom_test_obj_set_strawberry(WebKitDOMTestObj* self, glong value);
  * webkit_dom_test_obj_get_strict_float:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gfloat
 **/
 WEBKIT_API gfloat
 webkit_dom_test_obj_get_strict_float(WebKitDOMTestObj* self);
@@ -1265,7 +1254,7 @@ webkit_dom_test_obj_set_strict_float(WebKitDOMTestObj* self, gfloat value);
  * webkit_dom_test_obj_get_description:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_description(WebKitDOMTestObj* self);
@@ -1274,7 +1263,7 @@ webkit_dom_test_obj_get_description(WebKitDOMTestObj* self);
  * webkit_dom_test_obj_get_id:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_id(WebKitDOMTestObj* self);
@@ -1292,7 +1281,7 @@ webkit_dom_test_obj_set_id(WebKitDOMTestObj* self, glong value);
  * webkit_dom_test_obj_get_hash:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_obj_get_hash(WebKitDOMTestObj* self);
@@ -1301,7 +1290,7 @@ webkit_dom_test_obj_get_hash(WebKitDOMTestObj* self);
  * webkit_dom_test_obj_get_replaceable_attribute:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_replaceable_attribute(WebKitDOMTestObj* self);
@@ -1310,7 +1299,7 @@ webkit_dom_test_obj_get_replaceable_attribute(WebKitDOMTestObj* self);
  * webkit_dom_test_obj_get_nullable_double_attribute:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gdouble
 **/
 WEBKIT_API gdouble
 webkit_dom_test_obj_get_nullable_double_attribute(WebKitDOMTestObj* self);
@@ -1319,7 +1308,7 @@ webkit_dom_test_obj_get_nullable_double_attribute(WebKitDOMTestObj* self);
  * webkit_dom_test_obj_get_nullable_long_attribute:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_nullable_long_attribute(WebKitDOMTestObj* self);
@@ -1328,7 +1317,7 @@ webkit_dom_test_obj_get_nullable_long_attribute(WebKitDOMTestObj* self);
  * webkit_dom_test_obj_get_nullable_boolean_attribute:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gboolean
 **/
 WEBKIT_API gboolean
 webkit_dom_test_obj_get_nullable_boolean_attribute(WebKitDOMTestObj* self);
@@ -1337,7 +1326,7 @@ webkit_dom_test_obj_get_nullable_boolean_attribute(WebKitDOMTestObj* self);
  * webkit_dom_test_obj_get_nullable_string_attribute:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_obj_get_nullable_string_attribute(WebKitDOMTestObj* self);
@@ -1346,7 +1335,7 @@ webkit_dom_test_obj_get_nullable_string_attribute(WebKitDOMTestObj* self);
  * webkit_dom_test_obj_get_nullable_long_settable_attribute:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_nullable_long_settable_attribute(WebKitDOMTestObj* self);
@@ -1365,7 +1354,7 @@ webkit_dom_test_obj_set_nullable_long_settable_attribute(WebKitDOMTestObj* self,
  * @self: A #WebKitDOMTestObj
  * @error: #GError
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_obj_get_nullable_string_value(WebKitDOMTestObj* self, GError** error);
@@ -1383,7 +1372,7 @@ webkit_dom_test_obj_set_nullable_string_value(WebKitDOMTestObj* self, glong valu
  * webkit_dom_test_obj_get_attribute:
  * @self: A #WebKitDOMTestObj
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_obj_get_attribute(WebKitDOMTestObj* self);
index 67afae2..88ba278 100644 (file)
@@ -53,7 +53,7 @@ webkit_dom_test_serialized_script_value_interface_get_type (void);
  * webkit_dom_test_serialized_script_value_interface_get_value:
  * @self: A #WebKitDOMTestSerializedScriptValueInterface
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMSerializedScriptValue
 **/
 WEBKIT_API WebKitDOMSerializedScriptValue*
 webkit_dom_test_serialized_script_value_interface_get_value(WebKitDOMTestSerializedScriptValueInterface* self);
@@ -63,7 +63,6 @@ webkit_dom_test_serialized_script_value_interface_get_value(WebKitDOMTestSeriali
  * @self: A #WebKitDOMTestSerializedScriptValueInterface
  * @value: A #WebKitDOMSerializedScriptValue
  *
- * Returns: (transfer none):
 **/
 WEBKIT_API void
 webkit_dom_test_serialized_script_value_interface_set_value(WebKitDOMTestSerializedScriptValueInterface* self, WebKitDOMSerializedScriptValue* value);
@@ -72,7 +71,7 @@ webkit_dom_test_serialized_script_value_interface_set_value(WebKitDOMTestSeriali
  * webkit_dom_test_serialized_script_value_interface_get_readonly_value:
  * @self: A #WebKitDOMTestSerializedScriptValueInterface
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMSerializedScriptValue
 **/
 WEBKIT_API WebKitDOMSerializedScriptValue*
 webkit_dom_test_serialized_script_value_interface_get_readonly_value(WebKitDOMTestSerializedScriptValueInterface* self);
@@ -81,7 +80,7 @@ webkit_dom_test_serialized_script_value_interface_get_readonly_value(WebKitDOMTe
  * webkit_dom_test_serialized_script_value_interface_get_cached_value:
  * @self: A #WebKitDOMTestSerializedScriptValueInterface
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMSerializedScriptValue
 **/
 WEBKIT_API WebKitDOMSerializedScriptValue*
 webkit_dom_test_serialized_script_value_interface_get_cached_value(WebKitDOMTestSerializedScriptValueInterface* self);
@@ -91,7 +90,6 @@ webkit_dom_test_serialized_script_value_interface_get_cached_value(WebKitDOMTest
  * @self: A #WebKitDOMTestSerializedScriptValueInterface
  * @value: A #WebKitDOMSerializedScriptValue
  *
- * Returns: (transfer none):
 **/
 WEBKIT_API void
 webkit_dom_test_serialized_script_value_interface_set_cached_value(WebKitDOMTestSerializedScriptValueInterface* self, WebKitDOMSerializedScriptValue* value);
@@ -100,7 +98,7 @@ webkit_dom_test_serialized_script_value_interface_set_cached_value(WebKitDOMTest
  * webkit_dom_test_serialized_script_value_interface_get_cached_readonly_value:
  * @self: A #WebKitDOMTestSerializedScriptValueInterface
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMSerializedScriptValue
 **/
 WEBKIT_API WebKitDOMSerializedScriptValue*
 webkit_dom_test_serialized_script_value_interface_get_cached_readonly_value(WebKitDOMTestSerializedScriptValueInterface* self);
index b1c88d0..264f911 100644 (file)
@@ -84,7 +84,7 @@ webkit_dom_test_typedefs_nullable_array_arg(WebKitDOMTestTypedefs* self, WebKitD
  * webkit_dom_test_typedefs_immutable_point_function:
  * @self: A #WebKitDOMTestTypedefs
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMSVGPoint
 **/
 WEBKIT_API WebKitDOMSVGPoint*
 webkit_dom_test_typedefs_immutable_point_function(WebKitDOMTestTypedefs* self);
@@ -95,7 +95,7 @@ webkit_dom_test_typedefs_immutable_point_function(WebKitDOMTestTypedefs* self);
  * @values: A #WebKitDOMDOMString[]
  * @error: #GError
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMDOMString[]
 **/
 WEBKIT_API WebKitDOMDOMString[]*
 webkit_dom_test_typedefs_string_array_function(WebKitDOMTestTypedefs* self, WebKitDOMDOMString[]* values, GError** error);
@@ -106,7 +106,7 @@ webkit_dom_test_typedefs_string_array_function(WebKitDOMTestTypedefs* self, WebK
  * @values: A #WebKitDOMDOMString[]
  * @error: #GError
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMDOMString[]
 **/
 WEBKIT_API WebKitDOMDOMString[]*
 webkit_dom_test_typedefs_string_array_function2(WebKitDOMTestTypedefs* self, WebKitDOMDOMString[]* values, GError** error);
@@ -124,7 +124,7 @@ webkit_dom_test_typedefs_method_with_exception(WebKitDOMTestTypedefs* self, GErr
  * webkit_dom_test_typedefs_get_unsigned_long_long_attr:
  * @self: A #WebKitDOMTestTypedefs
  *
- * Returns:
+ * Returns: A #guint64
 **/
 WEBKIT_API guint64
 webkit_dom_test_typedefs_get_unsigned_long_long_attr(WebKitDOMTestTypedefs* self);
@@ -142,7 +142,7 @@ webkit_dom_test_typedefs_set_unsigned_long_long_attr(WebKitDOMTestTypedefs* self
  * webkit_dom_test_typedefs_get_immutable_serialized_script_value:
  * @self: A #WebKitDOMTestTypedefs
  *
- * Returns: (transfer none):
+ * Returns: (transfer none): A #WebKitDOMSerializedScriptValue
 **/
 WEBKIT_API WebKitDOMSerializedScriptValue*
 webkit_dom_test_typedefs_get_immutable_serialized_script_value(WebKitDOMTestTypedefs* self);
@@ -152,7 +152,6 @@ webkit_dom_test_typedefs_get_immutable_serialized_script_value(WebKitDOMTestType
  * @self: A #WebKitDOMTestTypedefs
  * @value: A #WebKitDOMSerializedScriptValue
  *
- * Returns: (transfer none):
 **/
 WEBKIT_API void
 webkit_dom_test_typedefs_set_immutable_serialized_script_value(WebKitDOMTestTypedefs* self, WebKitDOMSerializedScriptValue* value);
@@ -162,7 +161,7 @@ webkit_dom_test_typedefs_set_immutable_serialized_script_value(WebKitDOMTestType
  * @self: A #WebKitDOMTestTypedefs
  * @error: #GError
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_typedefs_get_attr_with_getter_exception(WebKitDOMTestTypedefs* self, GError** error);
@@ -180,7 +179,7 @@ webkit_dom_test_typedefs_set_attr_with_getter_exception(WebKitDOMTestTypedefs* s
  * webkit_dom_test_typedefs_get_attr_with_setter_exception:
  * @self: A #WebKitDOMTestTypedefs
  *
- * Returns:
+ * Returns: A #glong
 **/
 WEBKIT_API glong
 webkit_dom_test_typedefs_get_attr_with_setter_exception(WebKitDOMTestTypedefs* self);
@@ -200,7 +199,7 @@ webkit_dom_test_typedefs_set_attr_with_setter_exception(WebKitDOMTestTypedefs* s
  * @self: A #WebKitDOMTestTypedefs
  * @error: #GError
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_typedefs_get_string_attr_with_getter_exception(WebKitDOMTestTypedefs* self, GError** error);
@@ -218,7 +217,7 @@ webkit_dom_test_typedefs_set_string_attr_with_getter_exception(WebKitDOMTestType
  * webkit_dom_test_typedefs_get_string_attr_with_setter_exception:
  * @self: A #WebKitDOMTestTypedefs
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_test_typedefs_get_string_attr_with_setter_exception(WebKitDOMTestTypedefs* self);
index dde0a44..aa71ec0 100644 (file)
@@ -55,7 +55,7 @@ webkit_dom_attribute_get_type (void);
  * webkit_dom_attribute_get_readonly:
  * @self: A #WebKitDOMattribute
  *
- * Returns:
+ * Returns: A #gchar
 **/
 WEBKIT_API gchar*
 webkit_dom_attribute_get_readonly(WebKitDOMattribute* self);