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