diff options
| author | Matthias Clasen <mclasen@redhat.com> | 2021-05-20 20:45:06 -0400 |
|---|---|---|
| committer | Matthias Clasen <mclasen@redhat.com> | 2021-05-20 20:45:06 -0400 |
| commit | 4a0d3d7acc35ce7c1f2fcb29facf58b9720eb6a5 (patch) | |
| tree | e4157e70d282f7e8edac07406c67bb051334d7c7 /gtk/gtkfilechoosernative.c | |
| parent | 7fe0610b681c96823c45b88ca2c9657f1320bef8 (diff) | |
| download | gtk+-4a0d3d7acc35ce7c1f2fcb29facf58b9720eb6a5.tar.gz | |
docs: Reduce redundancy
Remove a boatload of "or %NULL" from nullable parameters
and return values. gi-docgen generates suitable text from
the annotation that we don't need to duplicate.
This adds a few missing nullable annotations too.
Diffstat (limited to 'gtk/gtkfilechoosernative.c')
| -rw-r--r-- | gtk/gtkfilechoosernative.c | 14 |
1 files changed, 6 insertions, 8 deletions
diff --git a/gtk/gtkfilechoosernative.c b/gtk/gtkfilechoosernative.c index f0c12265e6..0a9cce88e1 100644 --- a/gtk/gtkfilechoosernative.c +++ b/gtk/gtkfilechoosernative.c @@ -217,8 +217,7 @@ G_DEFINE_TYPE_WITH_CODE (GtkFileChooserNative, gtk_file_chooser_native, GTK_TYPE * * Retrieves the custom label text for the accept button. * - * Returns: (nullable): The custom label, or %NULL for the default. - * This string is owned by GTK and should not be modified or freed + * Returns: (nullable): The custom label */ const char * gtk_file_chooser_native_get_accept_label (GtkFileChooserNative *self) @@ -231,7 +230,7 @@ gtk_file_chooser_native_get_accept_label (GtkFileChooserNative *self) /** * gtk_file_chooser_native_set_accept_label: (attributes org.gtk.Method.set_property=accept-label) * @self: a `GtkFileChooserNative` - * @accept_label: (nullable): custom label or %NULL for the default + * @accept_label: (nullable): custom label * * Sets the custom label text for the accept button. * @@ -260,8 +259,7 @@ gtk_file_chooser_native_set_accept_label (GtkFileChooserNative *self, * * Retrieves the custom label text for the cancel button. * - * Returns: (nullable): The custom label, or %NULL for the default. - * This string is owned by GTK and should not be modified or freed + * Returns: (nullable): The custom label */ const char * gtk_file_chooser_native_get_cancel_label (GtkFileChooserNative *self) @@ -274,7 +272,7 @@ gtk_file_chooser_native_get_cancel_label (GtkFileChooserNative *self) /** * gtk_file_chooser_native_set_cancel_label: (attributes org.gtk.Method.set_property=cancel-label) * @self: a `GtkFileChooserNative` - * @cancel_label: (nullable): custom label or %NULL for the default + * @cancel_label: (nullable): custom label * * Sets the custom label text for the cancel button. * @@ -520,8 +518,8 @@ gtk_file_chooser_native_init (GtkFileChooserNative *self) /** * gtk_file_chooser_native_new: - * @title: (nullable): Title of the native, or %NULL - * @parent: (nullable): Transient parent of the native, or %NULL + * @title: (nullable): Title of the native + * @parent: (nullable): Transient parent of the native * @action: Open or save mode for the dialog * @accept_label: (nullable): text to go in the accept button, or %NULL for the default * @cancel_label: (nullable): text to go in the cancel button, or %NULL for the default |