src/ui/gui/help-menu.c

   1 /* PSPPIRE - a graphical user interface for PSPP.
   2    Copyright (C) 2006, 2007, 2010, 2011, 2012  Free Software Foundation
   3
   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.
   8
   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.
  13
  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/>. */
  16
  17
  18 #include <config.h>
  19
  20 #include <gtk/gtk.h>
  21
  22 #include <libpspp/copyleft.h>
  23 #include <libpspp/version.h>
  24 #include "help-menu.h"
  25 #include <libpspp/message.h>
  26
  27 #include "gl/configmake.h"
  28 #include "gl/relocatable.h"
  29
  30 #include <gettext.h>
  31 #define _(msgid) gettext (msgid)
  32 #define N_(msgid) msgid
  33
  34
  35 static const gchar *artists[] = { "Patrick Brunier", "Dondi Bogusky", NULL};
  36
  37 static void
  38 about_new (GtkMenuItem *m, GtkWindow *parent)
  39 {
  40   GtkWidget *about =  gtk_about_dialog_new ();
  41
  42   GdkPixbuf *pb =
  43     gdk_pixbuf_new_from_file_at_size (relocate (PKGDATADIR "/pspplogo.png"),
  44                                       64, 64, 0);
  45
  46   gtk_about_dialog_set_logo (GTK_ABOUT_DIALOG (about), pb);
  47
  48
  49   gtk_window_set_icon_name (GTK_WINDOW (about), "pspp");
  50
  51   gtk_about_dialog_set_website (GTK_ABOUT_DIALOG (about), PACKAGE_URL);
  52
  53   gtk_about_dialog_set_version (GTK_ABOUT_DIALOG (about),
  54                                 bare_version);
  55
  56   gtk_about_dialog_set_authors (GTK_ABOUT_DIALOG (about),
  57                                 (const gchar **) authors);
  58
  59   gtk_about_dialog_set_artists (GTK_ABOUT_DIALOG (about),
  60                                 artists);
  61
  62   gtk_about_dialog_set_license (GTK_ABOUT_DIALOG (about),
  63                                 copyleft);
  64
  65   gtk_about_dialog_set_comments (GTK_ABOUT_DIALOG (about),
  66                                  _("A program for the analysis of sampled data"));
  67
  68   gtk_about_dialog_set_copyright (GTK_ABOUT_DIALOG (about),
  69                                   "Free Software Foundation");
  70
  71   gtk_about_dialog_set_translator_credits
  72     (
  73      GTK_ABOUT_DIALOG (about),
  74      /* TRANSLATORS: Use this string to list the people who have helped with
  75         translation to your language. */
  76      _("translator-credits")
  77      );
  78
  79   gtk_window_set_transient_for (GTK_WINDOW (about), parent);
  80
  81   gtk_window_set_modal (GTK_WINDOW (about), TRUE);
  82
  83   gtk_dialog_run (GTK_DIALOG (about));
  84
  85   gtk_widget_hide (about);
  86 }
  87
  88 /* Open the manual at PAGE */
  89 void
  90 online_help (const char *page)
  91 {
  92   GError *err = NULL;
  93   gchar *cmd = NULL;
  94
  95   gchar *argv[3] = { "yelp", 0, 0};
  96
  97   if (page == NULL)
  98     argv[1] = g_strdup_printf ("file://%s", relocate (DOCDIR "/pspp.xml"));
  99   else
 100     argv[1] = g_strdup_printf ("file://%s#%s", relocate (DOCDIR "/pspp.xml"), page);
 101
 102   if (! g_spawn_async (NULL, argv,
 103                        NULL, G_SPAWN_SEARCH_PATH,
 104                        NULL, NULL,   NULL,   &err))
 105     {
 106       msg (ME, _("Cannot open reference manual: %s.  The PSPP user manual is "
 107                  "also available at %s"),
 108                   err->message,
 109                   PACKAGE_URL "documentation.html");
 110     }
 111
 112   g_free (cmd);
 113   g_clear_error (&err);
 114 }
 115
 116 static void
 117 reference_manual (GtkMenuItem *menu, gpointer data)
 118 {
 119   online_help (NULL);
 120 }
 121
 122
 123
 124 void
 125 merge_help_menu (GtkUIManager *uim)
 126 {
 127   GtkActionGroup *action_group = gtk_action_group_new ("help");
 128
 129   static const GtkActionEntry entries[] =
 130     {
 131       {
 132         "help", NULL,                               /* name, stock id */
 133         N_("_Help"), NULL,                          /* label, accelerator */
 134         NULL,
 135         NULL,
 136       },
 137
 138       {
 139         "help_reference", GTK_STOCK_HELP,            /* name, stock id */
 140         N_("_Reference Manual"), NULL,               /* label, accelerator */
 141         NULL,                                        /* tooltip */
 142         G_CALLBACK (reference_manual)
 143       },
 144
 145       {
 146         "help_about", GTK_STOCK_ABOUT,
 147         NULL, NULL, NULL,
 148         G_CALLBACK (about_new)
 149       },
 150     };
 151
 152   gtk_action_group_set_translation_domain (action_group, PACKAGE);
 153
 154   gtk_ui_manager_add_ui_from_string   (uim, "\
 155       <menubar name=\"menubar\">\
 156         <menu action=\"help\">\
 157           <menuitem action=\"help_reference\"/>\
 158           <menuitem action=\"help_about\"/>\
 159         </menu>\
 160        </menubar>\
 161        ", -1, 0);
 162
 163   gtk_action_group_add_actions (action_group, entries, G_N_ELEMENTS (entries), NULL);
 164
 165   gtk_ui_manager_insert_action_group  (uim, action_group, 0);
 166 }