From 6c124caa4d5e5b8793d5263b9ad90ef6f2c309ea Mon Sep 17 00:00:00 2001 From: Thomas Thurman Date: Sun, 30 Aug 2009 17:22:38 -0400 Subject: [PATCH 1/1] some comments --- belltower.c | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/belltower.c b/belltower.c index 920e5e8..b5ef2a3 100644 --- a/belltower.c +++ b/belltower.c @@ -834,8 +834,18 @@ free_tower_list (GSList *list) g_slist_free (list); } +/** + * Displays a list of towers for the user to choose from. + * When one is chosen, we go to the display page for that tower. + * If there are none, this will tell the user there were none. + * If there is only one, we go straight to its display page. + * + * \param list a GSList of FoundTower objects. + * \param list_name the title for the dialogue. + */ static void -show_towers_from_list (GSList *list) +show_towers_from_list (GSList *list, + gchar *list_name) { GtkWidget *dialog; GtkWidget *selector; @@ -867,6 +877,7 @@ show_towers_from_list (GSList *list) dialog = hildon_picker_dialog_new (GTK_WINDOW (window)); selector = hildon_touch_selector_new_text (); + gtk_window_set_title (GTK_WINDOW (dialog), list_name); for (cursor=list; cursor; cursor=cursor->next) { @@ -1030,6 +1041,14 @@ get_countries_with_many (GHashTable *source, #define COUNTRIES_WITH_MANY "Countries with many belltowers" #define COUNTRIES_WITH_FEW "Countries with few belltowers" +/** + * Displays a list of areas of the world with many (or few) + * belltowers. If you ask for the areas with many, it include + * a link to the areas with few. + * + * \param countries_with_many True to list countries with many; + * false to list countries with few. + */ static void towers_by_area_with_many (gboolean countries_with_many) { -- 1.7.9.5