src/ui/gui/help-menu.c

   1 /* PSPPIRE - a graphical user interface for PSPP.
   2    Copyright (C) 2006, 2007, 2010  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   if (page == NULL)
  96     cmd = g_strdup_printf ("yelp file://%s", relocate (DOCDIR "/pspp.xml"));
  97   else
  98     cmd = g_strdup_printf ("yelp file://%s\\#%s", relocate (DOCDIR "/pspp.xml"), page);
  99
 100   if ( ! g_spawn_command_line_async (cmd, &err) )
 101     {
 102       msg (ME, _("Cannot open reference manual: %s.  The PSPP user manual is "
 103                  "also available at %s"),
 104                   err->message,
 105                   PACKAGE_URL "documentation.html");
 106     }
 107
 108   g_free (cmd);
 109   g_clear_error (&err);
 110 }
 111
 112 static void
 113 reference_manual (GtkMenuItem *menu, gpointer data)
 114 {
 115   online_help (NULL);
 116 }
 117
 118
 119
 120 void
 121 merge_help_menu (GtkUIManager *uim)
 122 {
 123   GtkActionGroup *action_group = gtk_action_group_new ("help");
 124
 125   static const GtkActionEntry entries[] =
 126     {
 127       {
 128         "help", NULL,                               /* name, stock id */
 129         N_("_Help"), NULL,                          /* label, accelerator */
 130         NULL,
 131         NULL,
 132       },
 133
 134       {
 135         "help_reference", GTK_STOCK_HELP,            /* name, stock id */
 136         N_("_Reference Manual"), NULL,               /* label, accelerator */
 137         NULL,                                        /* tooltip */
 138         G_CALLBACK (reference_manual)
 139       },
 140
 141       {
 142         "help_about", GTK_STOCK_ABOUT,
 143         NULL, NULL, NULL,
 144         G_CALLBACK (about_new)
 145       },
 146     };
 147
 148   gtk_action_group_set_translation_domain (action_group, PACKAGE);
 149
 150   gtk_ui_manager_add_ui_from_string   (uim, "\
 151       <menubar name=\"menubar\">\
 152         <menu action=\"help\">\
 153           <menuitem action=\"help_reference\"/>\
 154           <menuitem action=\"help_about\"/>\
 155         </menu>\
 156        </menubar>\
 157        ", -1, 0);
 158
 159   gtk_action_group_add_actions (action_group, entries, G_N_ELEMENTS (entries), NULL);
 160
 161   gtk_ui_manager_insert_action_group  (uim, action_group, 0);
 162 }