1 /* PSPPIRE - a graphical user interface for PSPP.
2 Copyright (C) 2006, 2007, 2010, 2011, 2012, 2013, 2015, 2016 Free Software Foundation
4 This program is free software: you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation, either version 3 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program. If not, see <http://www.gnu.org/licenses/>. */
22 #include <libpspp/copyleft.h>
23 #include <libpspp/version.h>
24 #include "help-menu.h"
25 #include <libpspp/message.h>
27 #include "gl/configmake.h"
28 #include "gl/relocatable.h"
31 #define _(msgid) gettext (msgid)
32 #define N_(msgid) msgid
34 /* Try to open html documentation uri via the default
35 browser on the operating system */
37 #define HTMLOPENARGV {"open", 0, 0, 0, 0}
38 #define HTMLOPENARGIDX 1
40 #define HTMLOPENARGV {"cmd","/C", "start", 0, 0}
41 #define HTMLOPENARGIDX 3
43 #define HTMLOPENARGV {"xdg-open", 0, 0, 0, 0}
44 #define HTMLOPENARGIDX 1
47 static const gchar *artists[] = { "Bastián Díaz", "Hugo Alejandro", NULL};
50 about_new (GtkMenuItem *mmm, GtkWindow *parent)
52 GtkWidget *about = gtk_about_dialog_new ();
54 gtk_about_dialog_set_logo_icon_name (GTK_ABOUT_DIALOG (about), "pspp");
56 gtk_window_set_icon_name (GTK_WINDOW (about), "pspp");
58 gtk_about_dialog_set_website (GTK_ABOUT_DIALOG (about), PACKAGE_URL);
60 gtk_about_dialog_set_version (GTK_ABOUT_DIALOG (about),
63 gtk_about_dialog_set_authors (GTK_ABOUT_DIALOG (about),
64 (const gchar **) authors);
66 gtk_about_dialog_set_artists (GTK_ABOUT_DIALOG (about),
69 gtk_about_dialog_set_license (GTK_ABOUT_DIALOG (about),
72 gtk_about_dialog_set_comments (GTK_ABOUT_DIALOG (about),
73 _("A program for the analysis of sampled data"));
75 gtk_about_dialog_set_copyright (GTK_ABOUT_DIALOG (about),
76 "Free Software Foundation");
78 gtk_about_dialog_set_translator_credits
80 GTK_ABOUT_DIALOG (about),
81 /* TRANSLATORS: Do not translate this string. Instead, put the names of the people
82 who have helped in the translation. */
83 _("translator-credits")
86 gtk_window_set_transient_for (GTK_WINDOW (about), parent);
88 gtk_window_set_modal (GTK_WINDOW (about), TRUE);
90 gtk_dialog_run (GTK_DIALOG (about));
92 gtk_widget_hide (about);
95 /* Open the manual at PAGE with the following priorities
96 First: local yelp help system
97 Second: browser with local html doc dir in path pspp.html/<helppage>.html
98 Third: browers with Internet html help at gnu.org */
100 online_help (const char *page)
103 GError *htmlerr = NULL;
104 gchar *argv[3] = { "yelp", 0, 0};
105 gchar *htmlargv[5] = HTMLOPENARGV;
106 gchar *htmlfilename = NULL;
107 gchar *htmlfullname = NULL;
111 argv[1] = g_strdup_printf ("file://%s", relocate (DOCDIR "/pspp.xml"));
112 htmlfilename = g_strdup ("index.html");
116 gchar **tokens = NULL;
117 const int maxtokens = 5;
119 argv[1] = g_strdup_printf ("file://%s#%s",
120 relocate (DOCDIR "/pspp.xml"), page);
121 /* The page will be translated to the htmlfilename
123 GRAPH#SCATTERPLOT SCATTERPLOT.html
124 QUICK-CLUSTER QUICK-CLUSTER.html
125 which is valid for the multiple page html doc*/
126 tokens = g_strsplit (page, "#", maxtokens);
127 for(;tokens[idx] && idx < maxtokens;idx++);
128 htmlfilename = g_strdup_printf ("%s.html", tokens[idx-1]);
131 /* Hint: pspp.html is a directory...*/
132 htmlfullname = g_strdup_printf ("%s/%s", relocate (DOCDIR "/pspp.html"),
134 if (g_file_test (relocate (DOCDIR "/pspp.html"), G_FILE_TEST_IS_DIR))
136 GError *urierr = NULL;
137 gchar *uriname = g_filename_to_uri (htmlfullname,NULL, &urierr);
139 htmlargv[HTMLOPENARGIDX] = uriname;
142 msg (ME, _("Help path conversion error: %s"), urierr->message);
143 htmlargv[HTMLOPENARGIDX] = htmlfullname;
145 g_clear_error (&urierr);
148 htmlargv[HTMLOPENARGIDX] = g_strdup_printf (PACKAGE_URL "manual/html_node/%s",
150 g_free (htmlfullname);
151 g_free (htmlfilename);
153 if (! (g_spawn_async (NULL, argv,
154 NULL, G_SPAWN_SEARCH_PATH,
155 NULL, NULL, NULL, &err) ||
156 g_spawn_async (NULL, htmlargv,
157 NULL, G_SPAWN_SEARCH_PATH,
158 NULL, NULL, NULL, &htmlerr))
161 msg (ME, _("Cannot open reference manual via yelp: %s. "
162 "Cannot open via html: %s "
164 "The PSSP manual is also available at %s"),
167 htmlargv[HTMLOPENARGIDX],
168 PACKAGE_URL "documentation.html");
172 g_free (htmlargv[HTMLOPENARGIDX]);
173 g_clear_error (&err);
174 g_clear_error (&htmlerr);
178 reference_manual (GtkMenuItem *menu, gpointer data)
184 create_help_menu (GtkWindow *toplevel)
186 GtkWidget *menuitem = gtk_menu_item_new_with_mnemonic (_("_Help"));
187 GtkWidget *menu = gtk_menu_new ();
189 GtkWidget *help_about = gtk_menu_item_new_with_mnemonic (_("_About"));
190 GtkWidget *help_ref = gtk_menu_item_new_with_mnemonic (_("_Reference Manual"));
192 GtkAccelGroup *accel_group = gtk_accel_group_new ();
194 gtk_window_add_accel_group (toplevel, accel_group);
196 gtk_widget_add_accelerator (help_ref,
197 "activate", accel_group,
201 gtk_menu_attach (GTK_MENU (menu), help_ref, 0, 1, 0, 1);
202 gtk_menu_attach (GTK_MENU (menu), help_about, 0, 1, 1, 2);
204 g_signal_connect (help_about, "activate", G_CALLBACK (about_new), toplevel);
205 g_signal_connect (help_ref, "activate", G_CALLBACK (reference_manual), NULL);
207 g_object_set (menuitem, "submenu", menu, NULL);
209 gtk_widget_show_all (menuitem);