2006-09-04 Michael Dominic Kostrzewa <michael.kostrzewa@nokia.com>

[hildon] / hildon-widgets / hildon-note.c

diff --git a/hildon-widgets/hildon-note.c b/hildon-widgets/hildon-note.c
index 7ccc808..2046a49 100644 (file)
--- a/hildon-widgets/hildon-note.c
+++ b/hildon-widgets/hildon-note.c
@@ -1,14 +1,14 @@
 /*
  * This file is part of hildon-libs
  *
- * Copyright (C) 2005 Nokia Corporation.
+ * Copyright (C) 2005, 2006 Nokia Corporation.
  *
- * Contact: Luc Pionchon <luc.pionchon@nokia.com>
+ * Contact: Michael Dominic Kostrzewa <michael.kostrzewa@nokia.com>
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public License
- * as published by the Free Software Foundation; either version 2.1 of
- * the License, or (at your option) any later version.
+ * as published by the Free Software Foundation; version 2.1 of
+ * the License.
  *
  * This library is distributed in the hope that it will be useful, but
  * WITHOUT ANY WARRANTY; without even the implied warranty of
@@ -46,7 +46,7 @@
 #include <libintl.h>
 #include <hildon-widgets/hildon-defines.h>
 #include <hildon-widgets/hildon-system-sound.h>
-#include <hildon-widgets/hildon-banner.h>
+#include <hildon-widgets/hildon-banner.h> /* for _hildon_gtk_label_set_text_n_lines */
 
 #include <stdio.h>
 #include <string.h>
@@ -459,7 +459,6 @@ hildon_note_rebuild(HildonNote *note)
  *   correctly.
  *   In GTK the X window ID can be checked using
  *   GDK_WINDOW_XID(GTK_WIDGET(parent)->window).
- *
  * @description: the message to confirm
  * @Varargs: arguments pairs for new buttons(label and return value). 
  *   Terminate the list with %NULL value.
@@ -470,15 +469,15 @@ hildon_note_rebuild(HildonNote *note)
  * default ok/cancel buttons are not appended but you have to provide
  * all of the buttons.
  *
+ * FIXME: This doc seems to be wrong, the two buttons aren't added so
+ * it would only contain the "additional" buttons? However, changing
+ * this would break those applications that rely on current behaviour.
+ *
  * Returns: A #GtkWidget pointer of the note
  */
-
-/* FIXME: This doc seems to be wrong, the two buttons aren't added so it
- * would only contain the "additional" buttons? However, changing this would
-   break those applications that rely on current behaviour. */
-GtkWidget *hildon_note_new_confirmation_add_buttons(GtkWindow * parent,
-                                                    const gchar *
-                                                    description, ...)
+GtkWidget *hildon_note_new_confirmation_add_buttons(GtkWindow   *parent,
+                                                    const gchar *description,
+                                                   ...)
 {
     va_list args;
     char *message;
@@ -551,8 +550,7 @@ GtkWidget *hildon_note_new_confirmation(GtkWindow * parent,
  * Create a new confirmation note. Confirmation note has text (description) 
  * that you specify, two buttons and an icon.
  *
- * Note! This function is deprecated and broken, and really should not
- *       be used by anyone!
+ * Deprecated: this function is broken, and really should not be used by anyone!
  *
  * Returns: a #GtkWidget pointer of the note
  */
@@ -718,7 +716,6 @@ GtkWidget *hildon_note_new_information_with_icon_name(GtkWindow * parent,
  *   important so that the window manager could handle the windows
  *   correctly. In GTK the X window ID can be checked using
  *   GDK_WINDOW_XID(GTK_WIDGET(parent)->window).
- *
  * @description: the message to confirm
  * @icon: #GtkIconTheme icon to be displayed
  *