fix a few introspection and doc warnings

raveit65 · sc0w · commit 18eb46ced43f · 2018-09-16T23:30:48.000+02:00
diff --git a/pluma/pluma-app.c b/pluma/pluma-app.c
@@ -667,7 +667,7 @@ is_in_viewport (PlumaWindow  *window,
 }
 
 /**
- * _pluma_app_get_window_in_viewport
+ * _pluma_app_get_window_in_viewport:
  * @app: the #PlumaApp
  * @screen: the #GdkScreen
  * @workspace: the workspace number
diff --git a/pluma/pluma-document.c b/pluma/pluma-document.c
@@ -1167,7 +1167,7 @@ pluma_document_get_short_name_for_display (PlumaDocument *doc)
 /**
  * pluma_document_set_short_name_for_display:
  * @doc:
- * @short_name: (allow-none):
+ * @name: (allow-none):
  */
 void
 pluma_document_set_short_name_for_display (PlumaDocument *doc,
diff --git a/pluma/pluma-message-type.c b/pluma/pluma-message-type.c
@@ -227,7 +227,7 @@ pluma_message_type_is_supported (GType type)
  * @object_path: (allow-none): the object path
  * @method: (allow-none): the method
  * @num_optional: number of optional arguments
- * @var_args: key/gtype pair variable argument list
+ * @va_args: key/gtype pair variable argument list
  *
  * Create a new #PlumaMessageType for @method at @object_path. Argument names
  * and values are supplied by the NULL terminated variable argument list.
@@ -320,10 +320,10 @@ pluma_message_type_set (PlumaMessageType *message_type,
  * pluma_message_type_set_valist:
  * @message_type: the #PlumaMessageType
  * @num_optional: number of optional arguments
- * @var_args: key/gtype pair variable argument list
+ * @va_args: key/gtype pair variable argument list
  *
  * Sets argument names/types supplied by the NULL terminated variable
- * argument list @var_args. The last @num_optional provided arguments are 
+ * argument list @va_args. The last @num_optional provided arguments are 
  * considered optional.
  *
  */
diff --git a/pluma/pluma-utils.c b/pluma/pluma-utils.c
@@ -714,8 +714,8 @@ pluma_utils_uri_get_dirname (const gchar *uri)
 }
 
 /**
- * pluma_utils_location_get_dirname_for_display
- * @file: the location
+ * pluma_utils_location_get_dirname_for_display:
+ * @location: the location
  *
  * Returns a string suitable to be displayed in the UI indicating
  * the name of the directory where the file is located.

Original file line number	Diff line number	Diff line change
`@@ -667,7 +667,7 @@ is_in_viewport (PlumaWindow *window,`
`667`	`667`	`}`
`668`	`668`
`669`	`669`	`/**`
`670`		`- * _pluma_app_get_window_in_viewport`
	`670`	`+ * _pluma_app_get_window_in_viewport:`
`671`	`671`	`* @app: the #PlumaApp`
`672`	`672`	`* @screen: the #GdkScreen`
`673`	`673`	`* @workspace: the workspace number`
Original file line number	Diff line number	Diff line change
`@@ -714,8 +714,8 @@ pluma_utils_uri_get_dirname (const gchar *uri)`
`714`	`714`	`}`
`715`	`715`
`716`	`716`	`/**`
`717`		`- * pluma_utils_location_get_dirname_for_display`
`718`		`- * @file: the location`
	`717`	`+ * pluma_utils_location_get_dirname_for_display:`
	`718`	`+ * @location: the location`
`719`	`719`	`*`
`720`	`720`	`* Returns a string suitable to be displayed in the UI indicating`
`721`	`721`	`* the name of the directory where the file is located.`