[gtk/ebassi/issue-3945] docs: Fix indentation of the arguments




commit 8ef353a97068085af2eaeac69719ba1e8a89bf0c
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Wed May 12 17:38:07 2021 +0100

    docs: Fix indentation of the arguments
    
    The indentation of new lines inside documentation blurbs must be smaller
    than 4 spaces, otherwise the Markdown parser will consider the line to
    be part of a pre-formatted code block.
    
    Fixes: #3945

 gtk/gtkdroptarget.c | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)
---
diff --git a/gtk/gtkdroptarget.c b/gtk/gtkdroptarget.c
index bd6002422a..b2dc6f0eed 100644
--- a/gtk/gtkdroptarget.c
+++ b/gtk/gtkdroptarget.c
@@ -876,8 +876,8 @@ gtk_drop_target_get_formats (GtkDropTarget *self)
 /**
  * gtk_drop_target_set_gtypes:
  * @self: a `GtkDropTarget`
- * @types: (nullable) (transfer none) (array length=n_types):
- *     all supported #GTypes that can be dropped
+ * @types: (nullable) (transfer none) (array length=n_types): all supported `GType`s
+ *   that can be dropped on the target
  * @n_types: number of @types
  *
  * Sets the supported `GTypes` for this drop target.
@@ -907,16 +907,16 @@ gtk_drop_target_set_gtypes (GtkDropTarget *self,
 /**
  * gtk_drop_target_get_gtypes:
  * @self: a `GtkDropTarget`
- * @n_types: (out) (optional): optional pointer to take the
- *     number of #GTypes contained in the return value
+ * @n_types: (out) (optional): the number of `GType`s contained in the
+ *   return value
  *
- * Gets the list of supported `GTypes` for @self.
+ * Gets the list of supported `GType`s that can be dropped on the target.
  *
- * If no type have been set, %NULL will be returned.
+ * If no types have been set, `NULL` will be returned.
  *
  * Returns: (transfer none) (nullable) (array length=n_types):
- *   %G_TYPE_INVALID-terminated array of types included in
- *   @formats or %NULL if none.
+ *   the `G_TYPE_INVALID`-terminated array of types included in
+ *   formats
  */
 const GType *
 gtk_drop_target_get_gtypes (GtkDropTarget *self,


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]