diff options
author | Matthias Clasen <mclasen@redhat.com> | 2011-09-25 20:58:59 -0400 |
---|---|---|
committer | Matthias Clasen <mclasen@redhat.com> | 2011-09-25 21:04:49 -0400 |
commit | 5ff8fe69715a7f0da56816246be7ffaa05bd5ce9 (patch) | |
tree | 8d4b5c65c9c61639b0982b98f184065e2a429b75 /gtk/gtkmessagedialog.c | |
parent | a6151ebb9566ed39a6b100d1cca6d5eae7246201 (diff) | |
download | gtk+-5ff8fe69715a7f0da56816246be7ffaa05bd5ce9.tar.gz |
Documentation fixes
Mostly making sure that return values and varargs don't loose
their docs.
Diffstat (limited to 'gtk/gtkmessagedialog.c')
-rw-r--r-- | gtk/gtkmessagedialog.c | 34 |
1 files changed, 17 insertions, 17 deletions
diff --git a/gtk/gtkmessagedialog.c b/gtk/gtkmessagedialog.c index 19ab948efc..cc154ee07a 100644 --- a/gtk/gtkmessagedialog.c +++ b/gtk/gtkmessagedialog.c @@ -582,7 +582,7 @@ gtk_message_dialog_get_property (GObject *object, * @type: type of message * @buttons: set of buttons to use * @message_format: (allow-none): printf()-style format string, or %NULL - * @Varargs: arguments for @message_format + * @...: arguments for @message_format * * Creates a new message dialog, which is a simple dialog with an icon * indicating the dialog type (error, warning, etc.) and some text the @@ -591,7 +591,7 @@ gtk_message_dialog_get_property (GObject *object, * #GtkDialog for more details. * * Return value: (transfer none): a new #GtkMessageDialog - **/ + */ GtkWidget* gtk_message_dialog_new (GtkWindow *parent, GtkDialogFlags flags, @@ -640,13 +640,13 @@ gtk_message_dialog_new (GtkWindow *parent, /** * gtk_message_dialog_new_with_markup: - * @parent: (allow-none): transient parent, or %NULL for none + * @parent: (allow-none): transient parent, or %NULL for none * @flags: flags * @type: type of message * @buttons: set of buttons to use * @message_format: (allow-none): printf()-style format string, or %NULL - * @Varargs: arguments for @message_format - * + * @...: arguments for @message_format + * * Creates a new message dialog, which is a simple dialog with an icon * indicating the dialog type (error, warning, etc.) and some text which * is marked up with the <link linkend="PangoMarkupFormat">Pango text markup language</link>. @@ -794,16 +794,16 @@ gtk_message_dialog_set_markup (GtkMessageDialog *message_dialog, * gtk_message_dialog_format_secondary_text: * @message_dialog: a #GtkMessageDialog * @message_format: (allow-none): printf()-style format string, or %NULL - * @Varargs: arguments for @message_format - * - * Sets the secondary text of the message dialog to be @message_format + * @...: arguments for @message_format + * + * Sets the secondary text of the message dialog to be @message_format * (with printf()-style). * * Note that setting a secondary text makes the primary text become * bold, unless you have provided explicit markup. * * Since: 2.6 - **/ + */ void gtk_message_dialog_format_secondary_text (GtkMessageDialog *message_dialog, const gchar *message_format, @@ -842,32 +842,32 @@ gtk_message_dialog_format_secondary_text (GtkMessageDialog *message_dialog, /** * gtk_message_dialog_format_secondary_markup: * @message_dialog: a #GtkMessageDialog - * @message_format: printf()-style markup string (see + * @message_format: printf()-style markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>), or %NULL - * @Varargs: arguments for @message_format - * - * Sets the secondary text of the message dialog to be @message_format (with - * printf()-style), which is marked up with the + * @...: arguments for @message_format + * + * Sets the secondary text of the message dialog to be @message_format (with + * printf()-style), which is marked up with the * <link linkend="PangoMarkupFormat">Pango text markup language</link>. * * Note that setting a secondary text makes the primary text become * bold, unless you have provided explicit markup. * * Due to an oversight, this function does not escape special XML characters - * like gtk_message_dialog_new_with_markup() does. Thus, if the arguments + * like gtk_message_dialog_new_with_markup() does. Thus, if the arguments * may contain special XML characters, you should use g_markup_printf_escaped() * to escape it. * <informalexample><programlisting> * gchar *msg; - * + * * msg = g_markup_printf_escaped (message_format, ...); * gtk_message_dialog_format_secondary_markup (message_dialog, "%s", msg); * g_free (msg); * </programlisting></informalexample> * * Since: 2.6 - **/ + */ void gtk_message_dialog_format_secondary_markup (GtkMessageDialog *message_dialog, const gchar *message_format, |