From 2fb29001e82ee0bd2879d16f0e3164491b7b99fd Mon Sep 17 00:00:00 2001 From: Michael Dominic Kostrzewa Date: Thu, 25 Jan 2007 14:25:13 +0000 Subject: [PATCH] Big documentation fix mess continued. --- ChangeLog.2 | 4 + Makefile.am | 3 +- doc/Makefile.am | 32 +- doc/hildon-docs.sgml | 33 +- doc/tmpl/hildon-banner.sgml | 96 -- doc/tmpl/hildon-calendar-popup.sgml | 75 -- doc/tmpl/hildon-caption.sgml | 376 -------- doc/tmpl/hildon-code-dialog.sgml | 50 - doc/tmpl/hildon-color-button.sgml | 61 -- doc/tmpl/hildon-color-chooser-dialog.sgml | 45 - doc/tmpl/hildon-color-chooser.sgml | 45 - doc/tmpl/hildon-controlbar.sgml | 100 -- doc/tmpl/hildon-date-editor.sgml | 112 --- doc/tmpl/hildon-defines.sgml | 501 ---------- doc/tmpl/hildon-find-toolbar.sgml | 45 - doc/tmpl/hildon-font-selection-dialog.sgml | 43 - doc/tmpl/hildon-get-password-dialog.sgml | 107 --- doc/tmpl/hildon-hvolumebar.sgml | 37 - doc/tmpl/hildon-input-mode-hint.sgml | 60 -- doc/tmpl/hildon-libs-enum-types.sgml | 109 --- doc/tmpl/hildon-libs-unused.sgml | 1412 ---------------------------- doc/tmpl/hildon-marshalers.sgml | 16 - doc/tmpl/hildon-name-password-dialog.sgml | 126 --- doc/tmpl/hildon-note.sgml | 127 --- doc/tmpl/hildon-number-editor.sgml | 68 -- doc/tmpl/hildon-program.sgml | 159 ---- doc/tmpl/hildon-range-editor.sgml | 160 ---- doc/tmpl/hildon-scroll-area.sgml | 58 -- doc/tmpl/hildon-search.sgml | 53 -- doc/tmpl/hildon-seekbar.sgml | 104 -- doc/tmpl/hildon-set-password-dialog.sgml | 97 -- doc/tmpl/hildon-sort-dialog.sgml | 140 --- doc/tmpl/hildon-system-sound.sgml | 27 - doc/tmpl/hildon-telephone-editor.sgml | 166 ---- doc/tmpl/hildon-time-editor.sgml | 226 ----- doc/tmpl/hildon-time-picker.sgml | 71 -- doc/tmpl/hildon-volumebar.sgml | 61 -- doc/tmpl/hildon-vvolumebar.sgml | 37 - doc/tmpl/hildon-weekday-picker.sgml | 92 -- doc/tmpl/hildon-window.sgml | 142 --- doc/tmpl/hildon-wizard-dialog.sgml | 51 - src/hildon-helper.c | 6 +- 42 files changed, 45 insertions(+), 5288 deletions(-) delete mode 100644 doc/tmpl/hildon-banner.sgml delete mode 100644 doc/tmpl/hildon-calendar-popup.sgml delete mode 100644 doc/tmpl/hildon-caption.sgml delete mode 100644 doc/tmpl/hildon-code-dialog.sgml delete mode 100644 doc/tmpl/hildon-color-button.sgml delete mode 100644 doc/tmpl/hildon-color-chooser-dialog.sgml delete mode 100644 doc/tmpl/hildon-color-chooser.sgml delete mode 100644 doc/tmpl/hildon-controlbar.sgml delete mode 100644 doc/tmpl/hildon-date-editor.sgml delete mode 100644 doc/tmpl/hildon-defines.sgml delete mode 100644 doc/tmpl/hildon-find-toolbar.sgml delete mode 100644 doc/tmpl/hildon-font-selection-dialog.sgml delete mode 100644 doc/tmpl/hildon-get-password-dialog.sgml delete mode 100644 doc/tmpl/hildon-hvolumebar.sgml delete mode 100644 doc/tmpl/hildon-input-mode-hint.sgml delete mode 100644 doc/tmpl/hildon-libs-enum-types.sgml delete mode 100644 doc/tmpl/hildon-libs-unused.sgml delete mode 100644 doc/tmpl/hildon-marshalers.sgml delete mode 100644 doc/tmpl/hildon-name-password-dialog.sgml delete mode 100644 doc/tmpl/hildon-note.sgml delete mode 100644 doc/tmpl/hildon-number-editor.sgml delete mode 100644 doc/tmpl/hildon-program.sgml delete mode 100644 doc/tmpl/hildon-range-editor.sgml delete mode 100644 doc/tmpl/hildon-scroll-area.sgml delete mode 100644 doc/tmpl/hildon-search.sgml delete mode 100644 doc/tmpl/hildon-seekbar.sgml delete mode 100644 doc/tmpl/hildon-set-password-dialog.sgml delete mode 100644 doc/tmpl/hildon-sort-dialog.sgml delete mode 100644 doc/tmpl/hildon-system-sound.sgml delete mode 100644 doc/tmpl/hildon-telephone-editor.sgml delete mode 100644 doc/tmpl/hildon-time-editor.sgml delete mode 100644 doc/tmpl/hildon-time-picker.sgml delete mode 100644 doc/tmpl/hildon-volumebar.sgml delete mode 100644 doc/tmpl/hildon-vvolumebar.sgml delete mode 100644 doc/tmpl/hildon-weekday-picker.sgml delete mode 100644 doc/tmpl/hildon-window.sgml delete mode 100644 doc/tmpl/hildon-wizard-dialog.sgml diff --git a/ChangeLog.2 b/ChangeLog.2 index 7733444..9bf7f59 100644 --- a/ChangeLog.2 +++ b/ChangeLog.2 @@ -1,5 +1,9 @@ 2007-01-25 Michael Dominic Kostrzewa + * ./: Big documentation fix mess continued. + +2007-01-25 Michael Dominic Kostrzewa + * ./: Big documentation fix mess. 2007-01-25 Michael Dominic Kostrzewa diff --git a/Makefile.am b/Makefile.am index 0a70d49..ece1be9 100644 --- a/Makefile.am +++ b/Makefile.am @@ -20,7 +20,8 @@ MAINTAINERCLEANFILES = Makefile.in aclocal.m4 configure \ config.guess intltool-extract.in \ intltool-merge.in intltool-update.in \ mkinstalldirs build-stamp configure-stamp \ - gtk-doc.make + gtk-doc.make \ + m4/gtk-doc.m4 deb: dist -mkdir debian-build diff --git a/doc/Makefile.am b/doc/Makefile.am index fede150..1153dd3 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -14,13 +14,40 @@ HFILE_GLOB =$(top_srcdir)/src/*.h CFILE_GLOB =$(top_srcdir)/src/*.c -IGNORE_HFILES = +IGNORE_HFILES = hildon-banner-private.h \ + hildon-calendar-popup-private.h \ + hildon-caption-private.h \ + hildon-code-dialog-private.h \ + hildon-color-button-private.h \ + hildon-color-chooser-dialog-private.h \ + hildon-color-chooser-private.h \ + hildon-controlbar-private.h \ + hildon-date-editor-private.h \ + hildon-find-toolbar-private.h \ + hildon-font-selection-dialog-private.h\ + hildon-get-password-dialog-private.h \ + hildon-login-dialog-private.h \ + hildon-note-private.h \ + hildon-number-editor-private.h \ + hildon-private.c \ + hildon-private.h \ + hildon-program-private.h \ + hildon-range-editor-private.h \ + hildon-seekbar-private.h \ + hildon-set-password-dialog-private.h \ + hildon-sort-dialog-private.h \ + hildon-time-editor-private.h \ + hildon-time-picker-private.h \ + hildon-volumebar-private.h \ + hildon-weekday-picker-private.h \ + hildon-window-private.h \ + hildon-wizard-dialog-private.h INCLUDES = $(GTK_CFLAGS) -I$(top_srcdir) GTKDOC_LIBS = $(GTK_LIBS) ../src/libhildon_@PACKAGE_VERSION_MAJOR@.la -MKDB_OPTIONS =--sgml-mode --output-format=xml +MKDB_OPTIONS =--sgml-mode --ignore-files=parse content_files = version.xml @@ -33,4 +60,3 @@ FIXXREF_OPTIONS = include $(top_srcdir)/gtk-doc.make - diff --git a/doc/hildon-docs.sgml b/doc/hildon-docs.sgml index 8fef9ee..4c44641 100644 --- a/doc/hildon-docs.sgml +++ b/doc/hildon-docs.sgml @@ -6,7 +6,7 @@ - hildon-libs &version; Reference Manual + hildon &version; Reference Manual @@ -16,9 +16,6 @@ Toplevel Widgets - - - @@ -27,8 +24,7 @@ Selectors - - + @@ -37,8 +33,6 @@ - - @@ -57,17 +51,15 @@ Notifications - - Dialogs - + @@ -76,30 +68,15 @@ Other - - - - - + + - Index - - Index of deprecated symbols - - Index of new symbols in 0.12.0 - Index of new symbols in 0.12.2 - Index of new symbols in 0.12.4 - Index of new symbols in 0.12.8 - Index of new symbols in 0.12.10 diff --git a/doc/tmpl/hildon-banner.sgml b/doc/tmpl/hildon-banner.sgml deleted file mode 100644 index 65d44f2..0000000 --- a/doc/tmpl/hildon-banner.sgml +++ /dev/null @@ -1,96 +0,0 @@ - -HildonBanner - - - - - - - - - - - - - - - - - - - -@widget: -@icon_name: -@text: - - - - - - - -@widget: -@icon_name: -@format: -@Varargs: - - - - - - - -@widget: -@icon_name: -@markup: - - - - - - - -@widget: -@animation_name: -@text: -@Returns: - - - - - - - -@widget: -@bar: -@text: -@Returns: - - - - - - - -@self: -@text: - - - - - - - -@self: -@markup: - - - - - - - -@self: -@fraction: - - diff --git a/doc/tmpl/hildon-calendar-popup.sgml b/doc/tmpl/hildon-calendar-popup.sgml deleted file mode 100644 index f58a49f..0000000 --- a/doc/tmpl/hildon-calendar-popup.sgml +++ /dev/null @@ -1,75 +0,0 @@ - -HildonCalendarPopup - - - - - - - - -... - gint y, m, d; - GtkWidget *parent, *popup; - - /* get current date - into &y, &m, &d... */ - - gtk_widget_get_ancestor(GTK_WIDGET(data), GTK_TYPE_WINDOW); - popup = hildon_calendar_popup_new(GTK_WINDOW (parent), y, m, d); - - result = gtk_dialog_run(GTK_DIALOG(popup)); - switch(result) - { - case GTK_RESPONSE_OK: - case GTK_RESPONSE_ACCEPT: - - hildon_calendar_popup_get_date(HILDON_CALENDAR_POPUP(popup), &y, &m, &d); - - /* here set the new date*/ - } - gtk_widget_destroy(popup); -... - - - - - - -#GtkCalendar - - - - - - - -@parent: -@year: -@month: -@day: -@Returns: - - - - - - - -@cal: -@year: -@month: -@day: - - - - - - - -@cal: -@year: -@month: -@day: - - diff --git a/doc/tmpl/hildon-caption.sgml b/doc/tmpl/hildon-caption.sgml deleted file mode 100644 index 55933a5..0000000 --- a/doc/tmpl/hildon-caption.sgml +++ /dev/null @@ -1,376 +0,0 @@ - -HildonCaption - - - - - - - - - - - - - -##include <hildon-widgets/hildon-caption.h> - -##include <gtk/gtkwidget.h> -##include <gtk/gtkvbox.h> -##include <gtk/gtkhbox.h> -##include <gtk/gtkcombobox.h> -##include <gtk/gtkcomboboxentry.h> -##include <gtk/gtkentry.h> -##include <gtk/gtkscrolledwindow.h> -##include <gtk/gtkimage.h> -##include <gtk/gtkcheckbutton.h> -##include <glib/glist.h> -##include <gtk/gtktogglebutton.h> -##include <gtk/gtklabel.h> - -##include <libintl.h> -##define _(String) gettext(String) - -static void destroy_callback( GtkWidget *widget ); -void _testCaptionControl(GtkWidget *parent, gchar **help); - -gchar *hildon_icons[] = { "hildon-file-open", - "gtk-ok", - "gtk-refresh", - "gtk-remove" -}; - -const int num_icons = sizeof( hildon_icons ) / sizeof( gchar * ); - -static GList *caption_list = NULL; - -static void text_changed_callback( HildonCaption *caption, gpointer user_data ) -{ - hildon_caption_set_label( caption, gtk_entry_get_text( user_data ) ); -} - -static void icon_toggled_callback( HildonCaption *caption, gpointer user_data ) -{ - GtkWidget *phone_image = NULL; - GList *cur = caption_list; - int i = 0; - while ( cur ) - { - if ( !hildon_caption_get_icon_image( HILDON_CAPTION(cur->data) ) ) - { - phone_image = gtk_image_new_from_stock( hildon_icons[i], GTK_ICON_SIZE_SMALL_TOOLBAR ); - } - - hildon_caption_set_icon_image( HILDON_CAPTION( cur->data), phone_image ); - - cur = cur->next; - if ( ++i >= num_icons ) - { - i = 0; - } - - } -} -static void mandatory_toggled_callback( HildonCaption *caption, gpointer user_data ) -{ - GList *cur = caption_list; - int i = 0; - while ( cur ) - { - if ( hildon_caption_is_mandatory( HILDON_CAPTION(cur->data) ) ) - { - hildon_caption_set_status( HILDON_CAPTION(cur->data), HILDON_CAPTION_OPTIONAL ); - } - else - { - hildon_caption_set_status( HILDON_CAPTION(cur->data), HILDON_CAPTION_MANDATORY ); - } - - cur = cur->next; - if ( ++i > num_icons ) - { - i = 0; - } - } -} - -static void destroy_callback( GtkWidget *widget ) -{ - g_print( "Destroying the empty label\n" ); -} - -void _testCaptionControl(GtkWidget *parent, gchar **help) -{ - - GtkWidget *control = NULL; - GtkWidget *caption_control = NULL; - GtkWidget *vbox = gtk_vbox_new( FALSE, 0 ); - GtkWidget *top_vbox = GTK_WIDGET(gtk_vbox_new( FALSE, 0 )); - GtkWidget *hbox = GTK_WIDGET(gtk_hbox_new( FALSE, 0 )); - GtkSizeGroup *group= GTK_SIZE_GROUP( gtk_size_group_new( GTK_SIZE_GROUP_HORIZONTAL ) ); - - GtkWidget *some_image = gtk_image_new_from_file( "../share/themes/commonimages/question.png" ); - - control = gtk_entry_new(); - caption_control = hildon_caption_new( group, _("Man Entry"), control, - NULL, HILDON_CAPTION_MANDATORY); - gtk_box_pack_start( GTK_BOX( top_vbox ), caption_control, FALSE, FALSE, 0 ); - - g_signal_connect( G_OBJECT( control ), "destroy", G_CALLBACK( destroy_callback ), NULL ); - - control = gtk_entry_new(); - caption_control = hildon_caption_new( group, _("O grow"), control, - NULL, HILDON_CAPTION_OPTIONAL); - g_signal_connect_swapped( control, "changed", - G_CALLBACK( text_changed_callback ), caption_control ); - gtk_box_pack_start( GTK_BOX( top_vbox ), caption_control, FALSE, FALSE, 0 ); - - gtk_box_pack_end( GTK_BOX( hbox ), some_image, FALSE, FALSE, 0 ); - gtk_box_pack_end( GTK_BOX( hbox ), top_vbox, TRUE, TRUE, 0 ); - - gtk_box_pack_start( GTK_BOX( vbox ), hbox, FALSE, FALSE, 0 ); - - control = gtk_combo_box_entry_new_text(); - gtk_combo_box_append_text(GTK_COMBO_BOX(control), _("First Item")); - gtk_combo_box_append_text(GTK_COMBO_BOX(control), _("Second Item")); - gtk_combo_box_append_text(GTK_COMBO_BOX(control), _("Third Item")); - gtk_combo_box_append_text(GTK_COMBO_BOX(control), _("Fourth Item")); - gtk_combo_box_append_text(GTK_COMBO_BOX(control), _("Fifth Item")); - caption_control = hildon_caption_new( group, _("M Com"), control, - NULL, HILDON_CAPTION_MANDATORY); - gtk_box_pack_start( GTK_BOX( vbox ), caption_control, FALSE, FALSE, 0 ); - caption_list = g_list_append( caption_list, (gpointer)caption_control ); - - control = gtk_label_new("This text should not be focusable"); - caption_control = hildon_caption_new (group, _("UFLabel"), control, NULL, HILDON_CAPTION_OPTIONAL); - gtk_box_pack_start( GTK_BOX( vbox ), caption_control, FALSE, FALSE, 0 ); - caption_list = g_list_append (caption_list, (gpointer) caption_control ); - - control = gtk_combo_box_new_text(); /* entry */ - - gtk_combo_box_append_text(GTK_COMBO_BOX(control), _("Tango")); - gtk_combo_box_append_text(GTK_COMBO_BOX(control), _("Mambo")); - gtk_combo_box_append_text(GTK_COMBO_BOX(control), _("Merengue")); - gtk_combo_box_append_text(GTK_COMBO_BOX(control), _("Salsa")); - caption_control = hildon_caption_new( group, _("O Option Menu"), control, - NULL, HILDON_CAPTION_MANDATORY); - gtk_box_pack_start( GTK_BOX( vbox ), caption_control, FALSE, FALSE, 0 ); - caption_list = g_list_append( caption_list, (gpointer)caption_control ); - - - control = gtk_check_button_new(); - caption_control = hildon_caption_new( group, _("show icon"), control, - NULL, HILDON_CAPTION_MANDATORY); - g_signal_connect_swapped( control, "toggled", - G_CALLBACK( icon_toggled_callback ), caption_control ); - gtk_box_pack_start( GTK_BOX( vbox ), caption_control, FALSE, FALSE, 0 ); - caption_list = g_list_append( caption_list, (gpointer)caption_control ); - - control = gtk_check_button_new(); - caption_control = hildon_caption_new( group, _("toggle status"), control, - NULL, HILDON_CAPTION_OPTIONAL); - g_signal_connect_swapped( control, "toggled", - G_CALLBACK( mandatory_toggled_callback ), caption_control ); - gtk_box_pack_start( GTK_BOX( vbox ), caption_control, FALSE, FALSE, 0 ); - caption_list = g_list_append( caption_list, (gpointer)caption_control ); - - - gtk_container_add( GTK_CONTAINER( parent ), vbox ); - - gtk_widget_show_all( parent ); - - if (help) - *help = g_strdup (""); - -} - - - - - - - - - - - - - - -@HILDON_CAPTION_OPTIONAL: -@HILDON_CAPTION_MANDATORY: - - - - - - -@HILDON_CAPTION_POSITION_LEFT: -@HILDON_CAPTION_POSITION_RIGHT: - - - - - - -@group: -@value: -@control: -@icon: -@flag: -@Returns: - - - - - - - -@caption: -@Returns: - - - - - - - -@caption: -@new_group: - - - - - - - -@caption: -@Returns: - - - - - - - -@caption: -@flag: - - - - - - - -@caption: -@Returns: - - - - - - - -@caption: -@pos: - - - - - - - -@caption: -@Returns: - - - - - - - -@caption: -@icon: - - - - - - - -@caption: -@Returns: - - - - - - - -@caption: -@label: - - - - - - - -@caption: -@Returns: - - - - - - - -@caption: -@separator: - - - - - - - -@caption: -@Returns: - - - - - - - -@caption: -@alignment: - - - - - - - -@caption: -@Returns: - - - - - - - -@caption: -@expand: - - - - - - - -@caption: -@Returns: - - diff --git a/doc/tmpl/hildon-code-dialog.sgml b/doc/tmpl/hildon-code-dialog.sgml deleted file mode 100644 index d834d2f..0000000 --- a/doc/tmpl/hildon-code-dialog.sgml +++ /dev/null @@ -1,50 +0,0 @@ - -HildonCodeDialog - - - - - - - - - - - - - - - - - - - -@Returns: - - - - - - - -@dialog: -@Returns: - - - - - - - -@dialog: - - - - - - - -@dialog: -@text: - - diff --git a/doc/tmpl/hildon-color-button.sgml b/doc/tmpl/hildon-color-button.sgml deleted file mode 100644 index be8572f..0000000 --- a/doc/tmpl/hildon-color-button.sgml +++ /dev/null @@ -1,61 +0,0 @@ - -HildonColorButton - - - - - - - - -HildonColorButton *cbutton; -GtkColor *color; - -cbutton = hildon_color_button_new(); -gtk_object_get( GTK_OBJECT(cbutton), "color", color ); - - - - - - - - - - - - - - -@Returns: - - - - - - - -@color: -@Returns: - - - - - - - -@button: -@color: - -@Returns: - - - - - - - -@button: -@color: - - diff --git a/doc/tmpl/hildon-color-chooser-dialog.sgml b/doc/tmpl/hildon-color-chooser-dialog.sgml deleted file mode 100644 index 02994c6..0000000 --- a/doc/tmpl/hildon-color-chooser-dialog.sgml +++ /dev/null @@ -1,45 +0,0 @@ - -HildonColorChooserDialog - - -A dialog to choose a color. Relies on pluggable widget framework, which means -the API won't guarantee whatkind of dialog will be shown as it depends on -theming. - -On proper installations the widget should provide platform look-and-feel -compatible dialog capable of choosing a color. - - - - - - - - - - - - - - -@Returns: - - - - - - - -@chooser: -@color: - - - - - - - -@chooser: -@color: - - diff --git a/doc/tmpl/hildon-color-chooser.sgml b/doc/tmpl/hildon-color-chooser.sgml deleted file mode 100644 index f8d251b..0000000 --- a/doc/tmpl/hildon-color-chooser.sgml +++ /dev/null @@ -1,45 +0,0 @@ - -HildonColorChooser - - -A widget to choose a color. Relies on pluggable widget framework, which means -the API won't guarantee whatkind of dialog will be shown as it depends on -theming. - -On proper installations the widget API should provide platform look-and-feel -compatible widget capable of choosing a color. - - - - - - - - - - - - - - -@Returns: - - - - - - - -@chooser: -@color: - - - - - - - -@chooser: -@color: - - diff --git a/doc/tmpl/hildon-controlbar.sgml b/doc/tmpl/hildon-controlbar.sgml deleted file mode 100644 index 483f1f1..0000000 --- a/doc/tmpl/hildon-controlbar.sgml +++ /dev/null @@ -1,100 +0,0 @@ - -HildonControlbar - - - - - - - - - - -Here is an example that creates a control bar and initializes it. - - - -GtkWidget *cbar = hildon_controlbar_new(); -hildon_controlbar_set_max( HILDON_CONTROLBAR(cbar), 12 ); -hildon_controlbar_set_value( HILDON_CONTROLBAR(cbar), 6 ); - - - - - - - - - - - - - - -@Returns: - - - - - - - -@self: -@value: - - - - - - - -@self: -@Returns: - - - - - - - -@self: -@Returns: - - - - - - - -@self: -@Returns: - - - - - - - -@self: -@max: - - - - - - - -@self: -@min: - - - - - - - -@self: -@min: -@max: - - diff --git a/doc/tmpl/hildon-date-editor.sgml b/doc/tmpl/hildon-date-editor.sgml deleted file mode 100644 index 500a46f..0000000 --- a/doc/tmpl/hildon-date-editor.sgml +++ /dev/null @@ -1,112 +0,0 @@ - -HildonDateEditor - - - - - - - - -gint y, m, d; -.. -date_editor = hildon_date_editor_new(); -.. -hildon_date_editor_get_date(date_editor, &y, &m, &d); -.. - - - - - - - - - - - - - - -@Returns: - - - - - - - -@date: -@year: -@month: -@day: - - - - - - - -@date: -@year: -@month: -@day: - - - - - - - -@editor: -@year: -@Returns: - - - - - - - -@editor: -@month: -@Returns: - - - - - - - -@editor: -@day: -@Returns: - - - - - - - -@editor: -@Returns: - - - - - - - -@editor: -@Returns: - - - - - - - -@editor: -@Returns: - - diff --git a/doc/tmpl/hildon-defines.sgml b/doc/tmpl/hildon-defines.sgml deleted file mode 100644 index c9edd9c..0000000 --- a/doc/tmpl/hildon-defines.sgml +++ /dev/null @@ -1,501 +0,0 @@ - -hildon-defines - - - - - - - - - - - - - - - - - - - -@icon_size_list: -@icon_size_small: -@icon_size_toolbar: -@icon_size_widg: -@icon_size_widg_wizard: -@icon_size_grid: -@icon_size_big_note: -@icon_size_note: -@icon_size_statusbar: -@icon_size_indi_video_player_pre_roll: -@icon_size_indi_key_pad_lock: -@icon_size_indi_copy: -@icon_size_indi_delete: -@icon_size_indi_process: -@icon_size_indi_progressball: -@icon_size_indi_send: -@icon_size_indi_offmode_charging: -@icon_size_indi_tap_and_hold: -@icon_size_indi_send_receive: -@icon_size_indi_wlan_strength: -@image_size_indi_nokia_logo: -@image_size_indi_startup_failed: -@image_size_indi_startup_nokia_logo: -@image_size_indi_nokia_hands: - - - - - - - - - - - - -@iconvar: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/doc/tmpl/hildon-find-toolbar.sgml b/doc/tmpl/hildon-find-toolbar.sgml deleted file mode 100644 index db2b22f..0000000 --- a/doc/tmpl/hildon-find-toolbar.sgml +++ /dev/null @@ -1,45 +0,0 @@ - -HildonFindToolbar - - - - - - - - - - - - - - - - -Create a HildonFindToolbar without any preset GtkListStore. - - -@label: -@Returns: - - - - -Creat a HildonFindToolbar with a preset GtkListStore. - - -@label: -@model: -@column: -@Returns: - - - - - - - -@ftb: -@get_focus: - - diff --git a/doc/tmpl/hildon-font-selection-dialog.sgml b/doc/tmpl/hildon-font-selection-dialog.sgml deleted file mode 100644 index 82a0190..0000000 --- a/doc/tmpl/hildon-font-selection-dialog.sgml +++ /dev/null @@ -1,43 +0,0 @@ - -HildonFontSelectionDialog - - - - - - - - - - - - - - - - - - -@parent: -@title: -@Returns: - - - - - - - -@fsd: -@Returns: - - - - - - - -@fsd: -@text: - - diff --git a/doc/tmpl/hildon-get-password-dialog.sgml b/doc/tmpl/hildon-get-password-dialog.sgml deleted file mode 100644 index 89da289..0000000 --- a/doc/tmpl/hildon-get-password-dialog.sgml +++ /dev/null @@ -1,107 +0,0 @@ - -HildonGetPasswordDialog - - - - - - - - - - get_dialog = HILDON_GET_PASSWORD_DIALOG( - hildon_get_password_dialog_new (parent, FALSE)); - - gtk_widget_show (GTK_WIDGET (get_dialog)); - - i = gtk_dialog_run (GTK_DIALOG (get_dialog)); - - pass = hildon_get_password_dialog_get_password (get_dialog); - - if (i == GTK_RESPONSE_OK && (strcmp (pass, dialog.current_password) != 0)) - { - gtk_infoprint (GTK_WINDOW (parent), STR_PASSWORD_INCORRECT); - gtk_widget_set_sensitive (GTK_WIDGET (dialog.button2), FALSE); - gtk_widget_set_sensitive (GTK_WIDGET (dialog.button3), FALSE); - gtk_widget_set_sensitive (GTK_WIDGET (dialog.button4), FALSE); - } - - else if (i == GTK_RESPONSE_OK) - { - gtk_widget_set_sensitive( GTK_WIDGET( dialog.button2 ), TRUE); - } - - else - { - gtk_widget_set_sensitive (GTK_WIDGET (dialog.button2), FALSE); - gtk_widget_set_sensitive (GTK_WIDGET (dialog.button3), FALSE); - gtk_widget_set_sensitive (GTK_WIDGET (dialog.button4), FALSE); - } - gtk_widget_destroy (GTK_WIDGET (get_dialog)); -} - - - - - - - - - - - - - - -@parent: -@get_old: -@Returns: - - - - - - - -@parent: -@password: -@get_old: -@Returns: - - - - - - - -@dialog: -@message: - - - - - - - -@dialog: -@new_caption: - - - - - - - -@dialog: -@max_characters: - - - - - - - -@dialog: -@Returns: - - diff --git a/doc/tmpl/hildon-hvolumebar.sgml b/doc/tmpl/hildon-hvolumebar.sgml deleted file mode 100644 index 7d8007b..0000000 --- a/doc/tmpl/hildon-hvolumebar.sgml +++ /dev/null @@ -1,37 +0,0 @@ - -HildonHVolumebar - - - - - - - - - - -Here is an example that creates a horizontal volume bar and connects -both its signals: - - - -GtkWidget *volbar = hildon_hvolumebar_new (); -g_signal_connect( G_OBJECT(volbar), "mute_toggled", G_CALLBACK(mute_toggle), NULL ); -g_signal_connect( G_OBJECT(volbar), "level_changed", G_CALLBACK(level_change), NULL ); - - - - - - -#HildonVVolumebar - - - - - - - -@Returns: - - diff --git a/doc/tmpl/hildon-input-mode-hint.sgml b/doc/tmpl/hildon-input-mode-hint.sgml deleted file mode 100644 index cf282dd..0000000 --- a/doc/tmpl/hildon-input-mode-hint.sgml +++ /dev/null @@ -1,60 +0,0 @@ - -hildon-input-mode-hint - - -Wrappers for setting GtkEntry and GtkTextView input modes and autocapitalization. - - - - - - - -g_object_set(G_OBJECT(entry), "input-mode", HILDON_INPUT_MODE_HINT_NUMERIC, NULL); - -g_object_set(G_OBJECT(entry), "autocap", FALSE, NULL); - - - - - - - - - - - - - - - -Use this to set the input mode in text widget. Note that this affects -only input methods layout. - - - - - - - - - - - - - - - - - -@HILDON_INPUT_MODE_HINT_ALPHANUMERICSPECIAL: -@HILDON_INPUT_MODE_HINT_NUMERIC: -@HILDON_INPUT_MODE_HINT_ALPHA: -@HILDON_INPUT_MODE_HINT_NUMERICSPECIAL: -@HILDON_INPUT_MODE_HINT_ALPHASPECIAL: -@HILDON_INPUT_MODE_HINT_ALPHANUMERIC: -@HILDON_INPUT_MODE_HINT_HEXA: -@HILDON_INPUT_MODE_HINT_HEXASPECIAL: -@HILDON_INPUT_MODE_HINT_TELE: -@HILDON_INPUT_MODE_HINT_TELESPECIAL: - diff --git a/doc/tmpl/hildon-libs-enum-types.sgml b/doc/tmpl/hildon-libs-enum-types.sgml deleted file mode 100644 index 01f3531..0000000 --- a/doc/tmpl/hildon-libs-enum-types.sgml +++ /dev/null @@ -1,109 +0,0 @@ - -hildon-libs-enum-types - - - - - - - - - - - - - - - - - - - - - - -@Returns: - - - - - - - - - - - - - - -@Returns: - - - - - - - - - - - - - - -@Returns: - - - - - - - - - - - - - - -@Returns: - - - - - - - - - - - - - - -@Returns: - - - - - - - - - - - - - - -@Returns: - - - - - - - - - diff --git a/doc/tmpl/hildon-libs-unused.sgml b/doc/tmpl/hildon-libs-unused.sgml deleted file mode 100644 index 9880a0e..0000000 --- a/doc/tmpl/hildon-libs-unused.sgml +++ /dev/null @@ -1,1412 +0,0 @@ - - -Here is an example that creates and opens a #HildonFileDetailsDialog. - - - - GtkWidget *hfdd; - gchar *filename = "/bogus/path/to/file"; - hfdd = hildon_file_details_dialog_new( NULL, filename ); - gtk_dialog_run(GTK_DIALOG(hfdd)); - gtk_widget_destroy(hfdd); - - - - - - - - - - - - - - - - - - - - -HildonFileDetailsDialog - - - - -#HildonFindObjectDialog is a widget to query a string from the user. -This string is ment to be searched from a selected content of text. -There's a two kind of dialogs, one with different search options and -another with only one field to enter the searched parameter. - - - - -FindDialog = hildon_find_object_dialog_new (grand_parent); -... -findDialogOptions = hildon_find_object_dialog_new_with_options ( - grand_parent,GTK_DIALOG(dialog)); - - - - - - - - - - - - - -#HildonFindObjectDialog is a widget to query a string from the user. -This string is ment to be searched from a selected content of text. - - - -HildonFindObjectDialog - - - - - - - - - - - - - - - - - - - - - - - -hildon-grid-item-private - - - - - - - - - - - - - - - - - - - -HildonHWRArea - - - - - - - - -HildonSearch is a widget to ask details to a comming search operation. -It's possible to set an image to inform ongoing search operation. - - - - GtkWidget *search = hildon_search_new( "hildon-search"); - hildon_search_set_image_stock( HILDON_SEARCH(search), ICON_NAME[counter] ); - - - - - - - - - - - - -HildonSearch is a widget to ask details to a comming search operation. - - - -HildonSearch - - - - - - - - - - - - - -@klass: - - - - - - - - - - - - -@hildonapp: the object which received the signal. -@arg1: - - - - - - -@hildonapp: the object which received the signal. -@arg1: - - - - - - -@hildonapp: the object which received the signal. -@arg1: - - - - - - -@hildonapp: the object which received the signal. - - - - - - -@hildonapp: the object which received the signal. -@arg1: - - - - - - -@hildonapp: the object which received the signal. - - - - - - -@hildonapp: the object which received the signal. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@hildonappview: the object which received the signal. -@arg1: the Gdk key state. - - - - - - -@hildonappview: the object which received the signal. -@arg1: - - - - - - -@hildonappview: the object which received the signal. -@arg1: the Gdk key state. - - - - - - -@hildonappview: the object which received the signal. - - - - - - -@hildonappview: the object which received the signal. - - - - - - -@hildonappview: the object which received the signal. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@hildoncaption: the object which received the signal. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@button: -@priv: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@hildondateeditor: the object which received the signal. -@Returns: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@HILDON_FILE_SELECTION_MODE_LIST: -@HILDON_FILE_SELECTION_MODE_THUMBNAILS: - - - - - - - - - - - - -@HILDON_FILE_SELECTION_SORT_NAME: -@HILDON_FILE_SELECTION_SORT_TYPE: -@HILDON_FILE_SELECTION_SORT_MODIFIED: -@HILDON_FILE_SELECTION_SORT_SIZE: - - - - - - -@HILDON_FILE_SYSTEM_MODEL_COLUMN_GTK_PATH: -@HILDON_FILE_SYSTEM_MODEL_COLUMN_LOCAL_PATH: -@HILDON_FILE_SYSTEM_MODEL_COLUMN_URI: -@HILDON_FILE_SYSTEM_MODEL_COLUMN_FILE_NAME: -@HILDON_FILE_SYSTEM_MODEL_COLUMN_DISPLAY_NAME: -@HILDON_FILE_SYSTEM_MODEL_COLUMN_MIME_TYPE: -@HILDON_FILE_SYSTEM_MODEL_COLUMN_FILE_SIZE: -@HILDON_FILE_SYSTEM_MODEL_COLUMN_FILE_TIME: -@HILDON_FILE_SYSTEM_MODEL_COLUMN_IS_FOLDER: -@HILDON_FILE_SYSTEM_MODEL_COLUMN_HAS_LOCAL_PATH: -@HILDON_FILE_SYSTEM_MODEL_COLUMN_TYPE: -@HILDON_FILE_SYSTEM_MODEL_COLUMN_ICON: -@HILDON_FILE_SYSTEM_MODEL_COLUMN_ICON_EXPANDED: -@HILDON_FILE_SYSTEM_MODEL_COLUMN_ICON_COLLAPSED: -@HILDON_FILE_SYSTEM_MODEL_COLUMN_THUMBNAIL: -@HILDON_FILE_SYSTEM_MODEL_NUM_COLUMNS: - - - - - - -@HILDON_FILE_SYSTEM_MODEL_UNKNOWN: -@HILDON_FILE_SYSTEM_MODEL_FILE: -@HILDON_FILE_SYSTEM_MODEL_FOLDER: -@HILDON_FILE_SYSTEM_MODEL_SAFE_FOLDER_IMAGES: -@HILDON_FILE_SYSTEM_MODEL_SAFE_FOLDER_VIDEOS: -@HILDON_FILE_SYSTEM_MODEL_SAFE_FOLDER_SOUNDS: -@HILDON_FILE_SYSTEM_MODEL_SAFE_FOLDER_DOCUMENTS: -@HILDON_FILE_SYSTEM_MODEL_MMC: -@HILDON_FILE_SYSTEM_MODEL_GATEWAY: -@HILDON_FILE_SYSTEM_MODEL_LOCAL_DEVICE: - - - - - - - - - - - - -@uri: -@path: -@thumbnail_file: -@Returns: - - - - - - - - - - - - - - - -It is emitted everytime the close button is clicked. Note that HildonFindToolbar -does not hide itself. It is programmer's responsibility to hide the HildonFindToolbar - on receiving this signal, or do whatever he thinks is appropreiate. - - -@hildonfindtoolbar: the object which received the signal. - - - -Every time the user presses search button, the search signal is first emitted, - then history-append signal is emitted. The default handler will add - the currect item to the search history list. In case that the programmer - does not want to have the item added to list, for instance, when the search - fails, he must write his own handler and return TRUE. - - - -@hildonfindtoolbar: the object which received the signal. -@Returns: - - - -This signal indicates that the user has reached the maximum allowed character in the - search field. The typical action is to kindly inform the user that he has - reached the limit of search field using info print. - - -@hildonfindtoolbar: the object which received the signal. - - - -It is emitted everytime the search button is clicked, even the GtkComboboxEntry is empty. - - -@hildonfindtoolbar: the object which received the signal. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@HILDON_HWR_AREA_MODE_NORMAL: -@HILDON_HWR_AREA_MODE_SECRET: -@HILDON_HWR_AREA_MODE_TRAINING: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@priv: - - - - - - -@hildonwizarddialog: the object which received the signal. -@arg1: -@Returns: - - - - - - - - - - - - - - - - - - -@parent: -@text: - - - - - - -@widget: -@icon_name: -@text: - - - - - - -@parent: -@action: -@Returns: - - - - - - -@parent: -@first_property: -@Varargs: -@Returns: - - - - - - -@self: -@iter: -@Returns: - - - - - - -@parent: -@filename: -@Returns: - - - - - - -@parent: -@model: -@Returns: - - - - - - -@self: -@iter: - - - - - - -@self: -@iter: -@Returns: - - - - - - -@self: -@Returns: - - - - - - -@self: -@iter: -@Returns: - - - - - - -@self: -@Returns: - - - - - - -@self: -@Returns: - - - - - - -@self: -@Returns: - - - - - - -@self: -@Returns: - - - - - - -@self: -@key: -@order: - - - - - - -@self: - - - - - - -@model: -@Returns: - - - - - - -@self: - - - - - - -@self: -@path: -@error: -@Returns: - - - - - - -@self: -@folder: -@error: -@Returns: - - - - - - -@self: -@filter: - - - - - - -@self: -@mode: - - - - - - -@self: -@select_multiple: - - - - - - -@self: -@key: -@order: - - - - - - -@self: - - - - - - -@self: - - - - - - -@self: -@path: - - - - - - -@model: -@path: -@iter: -@Returns: - - - - - - -@model: -@parent: -@stub_name: -@extension: -@Returns: - - - - - - -@model: -@path: -@iter: -@start_iter: -@recursive: -@Returns: - - - - - - -@model: -@path: -@iter: -@start_iter: -@recursive: -@Returns: - - - - - - -@model: -@uri: -@iter: -@start_iter: -@recursive: -@Returns: - - - - - - -@dialog: -@Returns: - - - - - - -@parent: -@Returns: - - - - - - -@parent: -@dialog: -@Returns: - - - - - - -@dialog: -@label: - - - - - - -@dialog: -@Returns: - - - - - - -@fsd: -@Returns: - - - - - - -@fsd: -@color: - - - - - - -@area: - - - - - - -@area: -@ch: -@Returns: - - - - - - -@area: -@Returns: - - - - - - -@Returns: - - - - - - -@area: -@data: -@position: -@replace: - - - - - - -@area: - - - - - - -@dialog: -@Returns: - - - - - - -@dialog: -@Returns: - - - - - - -@parent: -@description: -@Returns: - - - - - - -@image: -@Returns: - - - - - - -@search: -@stock_icon: - - - - - - -@dialog: -@Returns: - - - - - - -@format: -@country: -@area: -@number: -@Returns: - diff --git a/doc/tmpl/hildon-marshalers.sgml b/doc/tmpl/hildon-marshalers.sgml deleted file mode 100644 index 080fe3b..0000000 --- a/doc/tmpl/hildon-marshalers.sgml +++ /dev/null @@ -1,16 +0,0 @@ - -hildon-marshalers - - - - - - - - - - - - - - diff --git a/doc/tmpl/hildon-name-password-dialog.sgml b/doc/tmpl/hildon-name-password-dialog.sgml deleted file mode 100644 index 88bf655..0000000 --- a/doc/tmpl/hildon-name-password-dialog.sgml +++ /dev/null @@ -1,126 +0,0 @@ - -HildonNamePasswordDialog - - - - - - - -Example: - -void _new_name_password_dialog(GtkDialog *options) -{ - gtk_widget_destroy(GTK_WIDGET(nameDialog)); - nameDialog = HILDON_NAME_PASSWORD_DIALOG(hildon_name_password_dialog_new(grand_parent)); - gtk_dialog_run(GTK_DIALOG(nameDialog)); - gtk_widget_hide(GTK_WIDGET(nameDialog)); -} - -void _testNamePasswordDialog(GtkWidget *parent, gchar **help) -{ - GtkWidget *button; - GtkWidget *vbox = gtk_vbox_new(FALSE, 0); - grand_parent = GTK_WINDOW(gtk_widget_get_ancestor(parent,GTK_TYPE_WINDOW)); - normalDialog = gtk_dialog_new_with_buttons(``dialog'',grand_parent,GTK_DIALOG_MODAL, GTK_STOCK_OK, GTK_RESPONSE_OK,NULL); - nameDialog = HILDON_NAME_PASSWORD_DIALOG(hildon_name_password_dialog_new(grand_parent)); - gtk_container_add(GTK_CONTAINER(parent), vbox); - button = gtk_button_new_with_label(_(``Name and Password Dialog'')); - gtk_box_pack_start(GTK_BOX(vbox), button, FALSE, FALSE, 0); - g_signal_connect(G_OBJECT(button), ``clicked'', G_CALLBACK(_new_name_password_dialog), NULL); - gtk_widget_show_all(vbox); -} - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@parent: -@Returns: - - - - - - - -@parent: -@name: -@pass: -@Returns: - - - - - - - -@dialog: -@Returns: - - - - - - - -@dialog: -@Returns: - - - - - - - -@dialog: -@domain: - - diff --git a/doc/tmpl/hildon-note.sgml b/doc/tmpl/hildon-note.sgml deleted file mode 100644 index adde140..0000000 --- a/doc/tmpl/hildon-note.sgml +++ /dev/null @@ -1,127 +0,0 @@ - -HildonNote - - - - - - - - - -hildon_note_new_confirmation( window, "Confirmation message..." ); - -i = gtk_dialog_run (GTK_DIALOG (note)); -gtk_widget_destroy (GTK_WIDGET (note)); - -if (i == GTK_RESPONSE_OK) - gtk_infoprint( window, "User pressed 'OK' button'" ); -else - gtk_infoprint( window, "User pressed 'Cancel' button" ); - - - - - - - - - - - - - - - -@parent: -@description: -@Returns: - - - - - - - -@parent: -@description: -@Varargs: -@Returns: - - - - - - - -@parent: -@description: -@icon_name: -@Returns: - - - - - - - -@parent: -@description: -@progressbar: -@Returns: - - - - - - - -@parent: -@description: -@Returns: - - - - - - - -@parent: -@description: -@icon_name: -@Returns: - - - - - - - -@note: -@text: - - - - - - - -@note: -@text_ok: -@text_cancel: - -@textOk: -@textCancel: - - - - - - - -@HILDON_NOTE_CONFIRMATION_TYPE: -@HILDON_NOTE_CONFIRMATION_BUTTON_TYPE: -@HILDON_NOTE_INFORMATION_TYPE: -@HILDON_NOTE_INFORMATION_THEME_TYPE: -@HILDON_NOTE_PROGRESSBAR_TYPE: - diff --git a/doc/tmpl/hildon-number-editor.sgml b/doc/tmpl/hildon-number-editor.sgml deleted file mode 100644 index 4fa016c..0000000 --- a/doc/tmpl/hildon-number-editor.sgml +++ /dev/null @@ -1,68 +0,0 @@ - -HildonNumberEditor - - - - - - - - - number_editor = hildon_number_editor_new (-250, 500); - hildon_number_editor_set_range (number_editor, 0, 100); - - - - - - - - - - - - - - -@MAXIMUM_VALUE_EXCEED: -@MINIMUM_VALUE_EXCEED: -@ERRONEOUS_VALUE: - - - - - - -@min: -@max: -@Returns: - - - - - - - -@editor: -@min: -@max: - - - - - - - -@editor: -@Returns: - - - - - - - -@editor: -@value: - - diff --git a/doc/tmpl/hildon-program.sgml b/doc/tmpl/hildon-program.sgml deleted file mode 100644 index be57e0e..0000000 --- a/doc/tmpl/hildon-program.sgml +++ /dev/null @@ -1,159 +0,0 @@ - -HildonProgram - - -An object that represents an application running in the Hildon framework. - - - - - -The HildonProgram is an object used to represent an application running -in the Hildon framework. - -Such an application is thought to have one or more HildonWindow. These -shall be registered to the HildonProgram with hildon_program_add_window, -and can be unregistered similarly with hildon_program_remove_window. - -The HildonProgram provides the programmer with commodities such -as applying a common toolbar and menu to all the HildonWindow -registered to it. This is done with hildon_program_set_common_menu() -and hildon_program_set_common_toolbar(). - -The HildonProgram is also used to apply program-wide properties that -are specific to the Hildon framework. For instance -hildon_program_set_can_hibernate() sets whether or not an application -can be set to hibernate by the Hildon task navigator, in situations of -low memory. - - - -HildonProgram *program; -HildonWindow *first_window; -HildonWindow *second_window; -GtkToolbar *common_toolbar, *window_specific_toolbar; -GtkMenu *menu; - -program = HILDON_PROGRAM (hildon_program_new()); - -window1 = HILDON_WINDOW (hildon_window_new()); -window2 = HILDON_WINDOW (hildon_window_new()); - -common_toolbar = create_common_toolbar(); -window_specific_toolbar = create_window_specific_toolbar(); - -menu = create_menu(); - -hildon_program_add (program, window1); -hildon_program_add (program, window2); - -hildon_program_set_common_menu (program, menu); - -hildon_program_set_common_toolbar (program, common_toolbar); -hildon_window_add_toolbar (first_window, window_specific_toolbar); - -hildon_program_set_can_hibernate (program, TRUE); - - - - - - - - - - - - - - - - - - - - -@Returns: - - - - - - - -@self: -@window: - - - - - - - -@self: -@window: - - - - - - - -@self: -@killable: - - - - - - - -@self: -@Returns: - - - - - - - -@self: -@menu: - - - - - - - -@self: -@Returns: - - - - - - - -@self: -@toolbar: - - - - - - - -@self: -@Returns: - - - - - - - -@self: -@Returns: - - diff --git a/doc/tmpl/hildon-range-editor.sgml b/doc/tmpl/hildon-range-editor.sgml deleted file mode 100644 index a76ac0f..0000000 --- a/doc/tmpl/hildon-range-editor.sgml +++ /dev/null @@ -1,160 +0,0 @@ - -HildonRangeEditor - - - - - - - - - - range_editor = hildon_range_editor_new(); - hildon_range_editor_set_limits( editor, start, end ); - hildon_range_editor_get_range( editor, &start, &end ); - - - - - - - - - - - - - - -@separator: -@Returns: - - - - - - - -@Returns: - - - - - - - -@editor: -@start: -@end: - - - - - - - -@editor: -@start: -@end: - - - - - - - -@editor: -@start: -@end: - - - - - - - -@editor: -@value: - - - - - - - -@editor: -@value: - - - - - - - -@editor: -@Returns: - - - - - - - -@editor: -@Returns: - - - - - - - -@editor: -@value: - - - - - - - -@editor: -@value: - - - - - - - -@editor: -@Returns: - - - - - - - -@editor: -@Returns: - - - - - - - -@editor: -@separator: - - - - - - - -@editor: -@Returns: - - diff --git a/doc/tmpl/hildon-scroll-area.sgml b/doc/tmpl/hildon-scroll-area.sgml deleted file mode 100644 index 2dcbd79..0000000 --- a/doc/tmpl/hildon-scroll-area.sgml +++ /dev/null @@ -1,58 +0,0 @@ - -hildon-scroll-area - - - - - - - - - -/* -Following code is not a working copy, -it's only giving an example of possible situation -*/ - -window = gtk_window_new (); -box = gtk_box_new (); -buttonA = gtk_button_new (); -buttonB = gtk_button_new (); -treeview = gtk_tree_view_new (); -swindow = gtk_scrolled_window_new (); - -scrollarea = gtk_scroll_area_new (swindow, treeview); - -/* -Pack the buttons to the box, the box to the scrolled window -and the scrolled window to the window. -*/ - -gtk_box_pack (box, scrollarea); - -/* -You can trye following situation without scroll area and -notice that the treeview is not working as well as it should -*/ - - - - - - - - - - - - - - - - - -@sw: -@child: -@Returns: - - diff --git a/doc/tmpl/hildon-search.sgml b/doc/tmpl/hildon-search.sgml deleted file mode 100644 index f9204c3..0000000 --- a/doc/tmpl/hildon-search.sgml +++ /dev/null @@ -1,53 +0,0 @@ - -HildonSearch - - -HildonSearch is a widget to ask details to a comming search operation. - - - -HildonSearch is a widget to ask details to a comming search operation. -It's possible to set an image to inform ongoing search operation. - - - - GtkWidget *search = hildon_search_new( "hildon-search"); - hildon_search_set_image_stock( HILDON_SEARCH(search), ICON_NAME[counter] ); - - - - - - - - - - - - - - - - - - - - -@image: -@Returns: - - - - - - - -@search: -@stock_icon: - - - - - - - diff --git a/doc/tmpl/hildon-seekbar.sgml b/doc/tmpl/hildon-seekbar.sgml deleted file mode 100644 index 3e12cc3..0000000 --- a/doc/tmpl/hildon-seekbar.sgml +++ /dev/null @@ -1,104 +0,0 @@ - -HildonSeekbar - - - - - - - - - GtkWidget *seekbar = hildon_seekbar_new(); - hildon_seekbar_set_total_time (GTK_WIDGET(seekbar), 600); - hildon_seekbar_set_position (GTK_WIDGET(seekbar), 300); - - -static void seekbar_set_tot (GtkWidget *spin, GtkWidget *seek) -{ - hildon_seekbar_set_total_time (seek, - (gint)gtk_spin_button_get_value(GTK_SPIN_BUTTON(spin))); -} - -static void seekbar_set_pos (GtkWidget *spin, GtkWidget *seek) -{ - hildon_seekbar_set_position (seek, - (gint)gtk_spin_button_get_value(GTK_SPIN_BUTTON(spin))); -} - -static gint update_spin_button (GtkWidget *seek, GtkWidget *spin) -{ - gtk_spin_button_set_value (GTK_SPIN_BUTTON(spin), - hildon_seekbar_get_position(seek)); - return TRUE; -} - - - - - - - - - - - - - - -@Returns: - - - - - - - -@seekbar: -@Returns: - - - - - - - -@seekbar: -@time: - - - - - - - -@seekbar: -@Returns: - - - - - - - -@seekbar: -@time: - - - - - - - -@seekbar: -@fraction: - - - - - - - -@seekbar: -@Returns: - - diff --git a/doc/tmpl/hildon-set-password-dialog.sgml b/doc/tmpl/hildon-set-password-dialog.sgml deleted file mode 100644 index 84fc648..0000000 --- a/doc/tmpl/hildon-set-password-dialog.sgml +++ /dev/null @@ -1,97 +0,0 @@ - -HildonSetPasswordDialog - - - - - - - - -Example: - - HildonGetPasswordDialog *get_dialog = HILDON_GET_PASSWORD_DIALOG( - hildon_get_password_dialog_new (parent, FALSE)); - - gtk_widget_show (GTK_WIDGET (get_dialog)); - - i = gtk_dialog_run (GTK_DIALOG (get_dialog)); - - pass = hildon_get_password_dialog_get_password (get_dialog); - - if (i == GTK_RESPONSE_OK && (strcmp (pass, dialog.current_password) != 0)) - { - gtk_infoprint (GTK_WINDOW (parent), STR_PASSWORD_INCORRECT); - gtk_widget_set_sensitive (GTK_WIDGET (dialog.button2), FALSE); - gtk_widget_set_sensitive (GTK_WIDGET (dialog.button3), FALSE); - gtk_widget_set_sensitive (GTK_WIDGET (dialog.button4), FALSE); - } - - else if (i == GTK_RESPONSE_OK) - { - gtk_widget_set_sensitive( GTK_WIDGET( dialog.button2 ), TRUE); - } - - else - { - gtk_widget_set_sensitive (GTK_WIDGET (dialog.button2), FALSE); - gtk_widget_set_sensitive (GTK_WIDGET (dialog.button3), FALSE); - gtk_widget_set_sensitive (GTK_WIDGET (dialog.button4), FALSE); - } - - - - - - - - - - - - - - -@parent: -@modify_protection: -@Returns: - - - - - - - -@parent: -@password: -@modify_protection: -@Returns: - - - - - - - -@dialog: -@Returns: - - - - - - - -@dialog: -@Returns: - - - - - - - -@dialog: -@message: - - diff --git a/doc/tmpl/hildon-sort-dialog.sgml b/doc/tmpl/hildon-sort-dialog.sgml deleted file mode 100644 index 9a68849..0000000 --- a/doc/tmpl/hildon-sort-dialog.sgml +++ /dev/null @@ -1,140 +0,0 @@ - -HildonSortDialog - - - - - - - - - - - -Here is an example for using HildonSortDialog. - - HildonSortDialog *sort_dialog = HILDON_SORT_DIALOG( - hildon_sort_dialog_new( parent )); - - gint response_id, add_sort_index; - - sort_by[0] = STR_SORT_BY_DATE; - sort_by[1] = STR_SORT_BY_NAME; - sort_by[2] = STR_SORT_BY_SIZE; - sort_by[3] = NULL; - - sorting_order[0] = STR_SORTING_ORDER_ASCENDING; - sorting_order[1] = STR_SORTING_ORDER_DESCENDING; - sorting_order[2] = NULL; - - add_sort_index = hildon_sort_dialog_add_sort_key (sort_dialog, - STR_SORT_BY_DATE); - - hildon_sort_dialog_add_sort_key (sort_dialog, STR_SORT_BY_NAME); - - hildon_sort_dialog_add_sort_key (sort_dialog, STR_SORT_BY_SIZE); - - if (dialog.first_time_clicked == TRUE) - { - hildon_sort_dialog_set_sort_key (sort_dialog, add_sort_index); - } - - if (dialog.first_time_clicked == FALSE) - { - hildon_sort_dialog_set_sort_key (sort_dialog, dialog.sort_key); - hildon_sort_dialog_set_sort_order (sort_dialog, dialog.sort_order); - } - - gtk_widget_show (GTK_WIDGET (sort_dialog)); - - response_id = gtk_dialog_run (GTK_DIALOG (sort_dialog)); - - if (response_id == GTK_RESPONSE_OK) - { - dialog.sort_key = hildon_sort_dialog_get_sort_key (sort_dialog); - - gtk_label_set_text (GTK_LABEL ( dialog.label1), - sort_by [dialog.sort_key]); - - - dialog.sort_order = hildon_sort_dialog_get_sort_order (sort_dialog); - - gtk_label_set_text (GTK_LABEL (dialog.label2), - sorting_order [dialog.sort_order]); - - dialog.first_time_clicked = FALSE; - } - - - - - - - - - - - - - - -@parent: -@Returns: - - - - - - - -@dialog: -@Returns: - - - - - - - -@dialog: -@Returns: - - - - - - - -@dialog: -@key: - - - - - - - -@dialog: -@order: - - - - - - - -@dialog: -@sort_key: -@Returns: - - - - - - - -@dialog: -@sort_key: -@Returns: - - diff --git a/doc/tmpl/hildon-system-sound.sgml b/doc/tmpl/hildon-system-sound.sgml deleted file mode 100644 index 610598b..0000000 --- a/doc/tmpl/hildon-system-sound.sgml +++ /dev/null @@ -1,27 +0,0 @@ - -hildon-system-sound - - - - - - - - - - - - - - - - - - - - - - -@sample: - - diff --git a/doc/tmpl/hildon-telephone-editor.sgml b/doc/tmpl/hildon-telephone-editor.sgml deleted file mode 100644 index 94ea3d4..0000000 --- a/doc/tmpl/hildon-telephone-editor.sgml +++ /dev/null @@ -1,166 +0,0 @@ - -HildonTelephoneEditor - - - - - - - - - - - - - editor[0] = - hildon_telephone_editor_new( HILDON_TELEPHONE_EDITOR_FORMAT_COERCE ); - - - - - - - - - - - - - - - - - - - - - - - - -@HILDON_TELEPHONE_EDITOR_FORMAT_FREE: -@HILDON_TELEPHONE_EDITOR_FORMAT_COERCE: -@HILDON_TELEPHONE_EDITOR_FORMAT_COERCE_COUNTRY: -@HILDON_TELEPHONE_EDITOR_FORMAT_COERCE_AREA: - - - - - - -@format: -@Returns: - - - - - - - -@hte: -@country: -@area: -@number: - - - - - - - -@hte: -@show: - - - - - - - -@hte: -@Returns: - - - - - - - -@hte: -@show: - - - - - - - -@hte: -@Returns: - - - - - - - -@hte: -@country: -@area: -@number: - - - - - - - -@hte: -@Returns: - - - - - - - -@hte: -@country: - - - - - - - -@hte: -@Returns: - - - - - - - -@hte: -@area: - - - - - - - -@hte: -@Returns: - - - - - - - -@hte: -@number: - - diff --git a/doc/tmpl/hildon-time-editor.sgml b/doc/tmpl/hildon-time-editor.sgml deleted file mode 100644 index fa3cf5f..0000000 --- a/doc/tmpl/hildon-time-editor.sgml +++ /dev/null @@ -1,226 +0,0 @@ - -HildonTimeEditor - - - - - - - - - -... -editor = hildon_time_editor_new(); -hildon_time_editor_set_time( editor, h, m, s ); -... -gtk_box_pack_start ( ..., editor ) -... -hildon_time_editor_get_time( editor, &h, &m, &s ); -... - - - - - - - - - - - - - - - -@HILDON_DATE_TIME_ERROR_NO_ERROR: -@HILDON_DATE_TIME_ERROR_MAX_HOURS: -@HILDON_DATE_TIME_ERROR_MAX_MINS: -@HILDON_DATE_TIME_ERROR_MAX_SECS: -@HILDON_DATE_TIME_ERROR_MAX_DAY: -@HILDON_DATE_TIME_ERROR_MAX_MONTH: -@HILDON_DATE_TIME_ERROR_MAX_YEAR: -@HILDON_DATE_TIME_ERROR_MIN_HOURS: -@HILDON_DATE_TIME_ERROR_MIN_MINS: -@HILDON_DATE_TIME_ERROR_MIN_SECS: -@HILDON_DATE_TIME_ERROR_MIN_DAY: -@HILDON_DATE_TIME_ERROR_MIN_MONTH: -@HILDON_DATE_TIME_ERROR_MIN_YEAR: -@HILDON_DATE_TIME_ERROR_EMPTY_HOURS: -@HILDON_DATE_TIME_ERROR_EMPTY_MINS: -@HILDON_DATE_TIME_ERROR_EMPTY_SECS: -@HILDON_DATE_TIME_ERROR_EMPTY_DAY: -@HILDON_DATE_TIME_ERROR_EMPTY_MONTH: -@HILDON_DATE_TIME_ERROR_EMPTY_YEAR: -@HILDON_DATE_TIME_ERROR_MIN_DURATION: -@HILDON_DATE_TIME_ERROR_MAX_DURATION: -@HILDON_DATE_TIME_ERROR_INVALID_CHAR: -@HILDON_DATE_TIME_ERROR_INVALID_DATE: -@HILDON_DATE_TIME_ERROR_INVALID_TIME: - - - - - - -@Returns: - - - - - - - -@editor: -@hours: -@minutes: -@seconds: - - - - - - - -@editor: -@hours: -@minutes: -@seconds: - - - - - - - -@editor: -@min_seconds: -@max_seconds: - - - - - - - -@editor: -@min_seconds: -@max_seconds: - - - - - - - -@editor: -@ticks: - - - - - - - -@editor: -@Returns: - - - - - - - -@editor: -@show_seconds: - - - - - - - -@editor: -@Returns: - - - - - - - -@editor: -@show_hours: - - - - - - - -@editor: -@Returns: - - - - - - - -@editor: -@duration_mode: - - - - - - - -@editor: -@Returns: - - - - - - - -@editor: -@duration_min: - - - - - - - -@editor: -@Returns: - - - - - - - -@editor: -@duration_max: - - - - - - - -@editor: -@Returns: - - - - - - - -@hm_sep_label: -@ms_sep_label: - - diff --git a/doc/tmpl/hildon-time-picker.sgml b/doc/tmpl/hildon-time-picker.sgml deleted file mode 100644 index 75ce806..0000000 --- a/doc/tmpl/hildon-time-picker.sgml +++ /dev/null @@ -1,71 +0,0 @@ - -HildonTimePicker - - - - - - - - - -... -parent = gtk_widget_get_ancestor (GTK_WIDGET (editor), GTK_TYPE_WINDOW); -picker = hildon_time_picker_new (GTK_WINDOW (parent)); - -hildon_time_editor_get_time (editor, &h, &m, &s); -hildon_time_picker_set_time( HILDON_TIME_PICKER( picker ), h, m ); - -result = gtk_dialog_run( GTK_DIALOG ( picker ) ); -switch (result) -{ -case GTK_RESPONSE_OK: -case GTK_RESPONSE_ACCEPT: - hildon_time_picker_get_time(HILDON_TIME_PICKER( picker ), &h, &m ); - foo_set_time(h,m); -break; -default: -break; -} - -gtk_widget_destroy( picker ); -... - - - - - - - -#HildonTimeEditor - - - - - - - -@parent: -@Returns: - - - - - - - -@picker: -@hours: -@minutes: - - - - - - - -@picker: -@hours: -@minutes: - - diff --git a/doc/tmpl/hildon-volumebar.sgml b/doc/tmpl/hildon-volumebar.sgml deleted file mode 100644 index b68bf47..0000000 --- a/doc/tmpl/hildon-volumebar.sgml +++ /dev/null @@ -1,61 +0,0 @@ - -HildonVolumebar - - - - - - - - - - - -#HildonHVolumebar,#HildonVVolumebar - - - - - - - -@self: -@Returns: - - - - - - - -@self: -@level: - - - - - - - -@self: -@Returns: - - - - - - - -@self: -@mute: - - - - - - - -@self: -@Returns: - - diff --git a/doc/tmpl/hildon-vvolumebar.sgml b/doc/tmpl/hildon-vvolumebar.sgml deleted file mode 100644 index baa8097..0000000 --- a/doc/tmpl/hildon-vvolumebar.sgml +++ /dev/null @@ -1,37 +0,0 @@ - -HildonVVolumebar - - - - - - - - - - -Here is an example that creates a vertical volume bar and connects -both its signals. - - - -GtkWidget *volbar = hildon_vvolumebar_new (); -g_signal_connect( G_OBJECT(volbar), "mute_toggled", G_CALLBACK(mute_toggle), NULL ); -g_signal_connect( G_OBJECT(volbar), "level_changed", G_CALLBACK(level_change), NULL ); - - - - - - -#HildonHVolumebar - - - - - - - -@Returns: - - diff --git a/doc/tmpl/hildon-weekday-picker.sgml b/doc/tmpl/hildon-weekday-picker.sgml deleted file mode 100644 index 5ed1d43..0000000 --- a/doc/tmpl/hildon-weekday-picker.sgml +++ /dev/null @@ -1,92 +0,0 @@ - -HildonWeekdayPicker - - - - - - - - - - - -Example function calls: - - gint i; - HildonWeekdayPicker *picker = hildon_weekday_picker_new(); - - hildon_weekday_picker_set_day( picker, i ); - hildon_weekday_picker_unset_day( picker, i ); - hildon_weekday_picker_toggle_day( picker, i ); - hildon_weekday_picker_set_all( picker ); - hildon_weekday_picker_unset_all( picker ); - - - - - - - - - - - - - -@Returns: - - - - - - - -@picker: -@day: - - - - - - - -@picker: -@day: - - - - - - - -@picker: -@day: - - - - - - - -@picker: - - - - - - - -@picker: - - - - - - - -@picker: -@day: -@Returns: - - diff --git a/doc/tmpl/hildon-window.sgml b/doc/tmpl/hildon-window.sgml deleted file mode 100644 index bcd63dd..0000000 --- a/doc/tmpl/hildon-window.sgml +++ /dev/null @@ -1,142 +0,0 @@ - -HildonWindow - - - -Widget representing a top-level window in the Hildon framework. - - - - -The HildonWindow is a GTK widget which represents a top-level -window in the Hildon framework. It is derived from the GtkWindow -and provides additional commodities specific to the Hildon -framework. - -Among these windows in the Hildon framework can have a single menu -attached, which is toggled with a hardware key or by tapping -a custom button in the window frame. This menu can be set -by providing a GtkMenu to the hildon_window_set_menu() method. - -Similarly a window in the Hildon framework can have several toolbars -attached. These can be added to the HildonWindow with -hildon_window_add_toolbar(). - - - - -HildonWindow *window; -GtkToolbar *toolbar; -GtkMenu *menu; -GdkPixbuf *icon_pixbuf; - -window = HILDON_WINDOW (hildon_window_new()); - -toolbar = create_toolbar(); - -menu = create_menu(); - -icon_pixbuf = create_icon(); - -hildon_window_set_menu (window, menu); - -hildon_window_add_toolbar (window, toolbar); - -/* Can be used to set the window fullscreen */ -gtk_window_fullscreen (GTK_WINDOW (window)); - -/* Used to trigger the blinking of the window's icon in the task navigator */ -gtk_window_set_urgency_hint (GTK_WINDOW (window), TRUE); - -/* Change the window's icon in the task navigator */ -gtk_window_set_icon (GTK_WINDOW (window), icon_pixbuf); - - - - - - - - - - - - - - - - - - - - - - - - -@HILDON_WINDOW_CO_COPY: -@HILDON_WINDOW_CO_CUT: -@HILDON_WINDOW_CO_PASTE: - - - - - - -@Returns: - - - - - - - -@self: -@child: - - - - - - - -@self: -@Returns: - - - - - - - -@self: -@menu: - - - - - - - -@self: -@toolbar: - - - - - - - -@self: -@toolbar: - - - - - - - -@self: -@Returns: - - diff --git a/doc/tmpl/hildon-wizard-dialog.sgml b/doc/tmpl/hildon-wizard-dialog.sgml deleted file mode 100644 index f21019f..0000000 --- a/doc/tmpl/hildon-wizard-dialog.sgml +++ /dev/null @@ -1,51 +0,0 @@ - -HildonWizardDialog - - - - - - - - - - -hildon_wizard_dialog_new (parent, wizard_name, notebook); - - - - -Using of the API is very simple, it has only one function to create it -and the rest of it is handled by developers notebook. -Also the response is returned, either cancel or finnish. -Next and previous buttons are handled by the wizard dialog it self, by -switching the page either forward or backward in the notebook. - - - - - - - - - - - - - -@HILDON_WIZARD_DIALOG_CANCEL: -@HILDON_WIZARD_DIALOG_PREVIOUS: -@HILDON_WIZARD_DIALOG_NEXT: -@HILDON_WIZARD_DIALOG_FINISH: - - - - - - -@parent: -@wizard_name: -@notebook: -@Returns: - - diff --git a/src/hildon-helper.c b/src/hildon-helper.c index c188cf3..7904030 100644 --- a/src/hildon-helper.c +++ b/src/hildon-helper.c @@ -23,9 +23,13 @@ */ /** - * SECTION:hildon-helpers + * SECTION:hildon-helper * @short_description: A collection of usefull utilities and functions. * + * Hildon provides some helper functions that can be used for commonly + * performed tasks and functionality blocks. This includes operations + * on widget styles and probing functions for touch events. + * */ #ifdef HAVE_CONFIG_H -- 1.7.9.5