From 5a1ff8cee9b02ce525565515fc30a5df15bffbc9 Mon Sep 17 00:00:00 2001
From: "Gergely POLONKAI (W00d5t0ck)" <gergely@polonkai.eu>
Date: Sun, 22 Sep 2013 13:51:21 +0200
Subject: [PATCH] Added Help on pressing F1

This still has many things to do. The help files must be improved,
and the help function must be made context-aware (the current show_help()
function is already context-aware).
---
 src/ag-app.c | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/src/ag-app.c b/src/ag-app.c
index e050c5b..d7299f2 100644
--- a/src/ag-app.c
+++ b/src/ag-app.c
@@ -176,6 +176,38 @@ raise_cb(GSimpleAction *action, GVariant *parameter, gpointer user_data)
     gtk_window_present(window);
 }
 
+static void
+show_help(const gchar *topic, GtkWindow *parent)
+{
+    gchar     *uri;
+    GdkScreen *screen;
+    GError    *err = NULL;
+
+    if (topic) {
+        uri = g_strdup_printf("help:astrognome/%s", topic);
+    } else {
+        uri = g_strdup("help:astrognome");
+    }
+
+    if (parent) {
+        screen = gtk_widget_get_screen(GTK_WIDGET(parent));
+    } else {
+        screen = gdk_screen_get_default();
+    }
+
+    if (!gtk_show_uri(screen, uri, gtk_get_current_event_time(), &err)) {
+        g_warning("Unable to display help: %s", err->message);
+    }
+
+    g_free(uri);
+}
+
+static void
+help_cb(GSimpleAction *action, GVariant *parameter, gpointer user_data)
+{
+    show_help(NULL, NULL);
+}
+
 static GActionEntry app_entries[] = {
     { "new-window",  new_window_cb,  NULL, NULL, NULL },
     { "preferences", preferences_cb, NULL, NULL, NULL },
@@ -183,6 +215,7 @@ static GActionEntry app_entries[] = {
     { "quit",        quit_cb,        NULL, NULL, NULL },
     { "raise",       raise_cb,       NULL, NULL, NULL },
     { "open",        open_cb,        NULL, NULL, NULL },
+    { "help",        help_cb,        NULL, NULL, NULL },
 };
 
 static void
@@ -198,6 +231,7 @@ setup_accelerators(AgApp *app)
     gtk_application_add_accelerator(GTK_APPLICATION(app), "<Primary>s",        "win.save",       NULL);
     gtk_application_add_accelerator(GTK_APPLICATION(app), "<Primary><Shift>s", "win.save-as",    NULL);
     gtk_application_add_accelerator(GTK_APPLICATION(app), "F10",               "win.gear-menu",  NULL);
+    gtk_application_add_accelerator(GTK_APPLICATION(app), "F1",                "app.help",       NULL);
     gtk_application_add_accelerator(GTK_APPLICATION(app), "F5",                "win.change-tab", g_variant_new_string("chart"));
     gtk_application_add_accelerator(GTK_APPLICATION(app), "F9",                "win.change-tab", g_variant_new_string("aspects"));
 }