help.c File Reference

#include "common/darktable.h"
#include "gui/actions/menu.h"
#include "common/l10n.h"
#include "control/control.h"
#include "tools/darktable_authors.h"

Include dependency graph for help.c:

Go to the source code of this file.

Functions
static gboolean	show_about_dialog (GtkAccelGroup *group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)
static gboolean	open_doc_callback (GtkAccelGroup *group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)
static gboolean	open_chat_callback (GtkAccelGroup *group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)
static gboolean	open_search_callback (GtkAccelGroup *group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)
static gboolean	open_forum_callback (GtkAccelGroup *group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)
static char *	get_help_url (GtkWidget *widget)
static void	_restore_default_cursor ()
static void	_main_do_event_help (GdkEvent *event, gpointer data)
static gboolean	contextual_help_callback (GtkAccelGroup *group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)
static gboolean	search_accels_callback (GtkAccelGroup *group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)
void	append_help (GtkWidget **menus, GList **lists, const dt_menus_t index)

Function Documentation

_main_do_event_help()

static void _main_do_event_help ( GdkEvent *  event, gpointer  data  )

static

Todo:

: find a better way to tell the user that the hovered widget has a help link

Definition at line 109 of file help.c.

References _restore_default_cursor(), darktable, dt_control_allow_change_cursor(), dt_control_change_cursor, dt_control_forbid_change_cursor(), dt_control_log(), DT_DEBUG_CONTROL, dt_osx_disallow_fullscreen(), dt_print(), dt_ui_main_window(), error(), FALSE, get_help_url(), darktable_t::gui, IS_NULL_PTR, TRUE, and dt_gui_gtk_t::ui.

Referenced by contextual_help_callback().

_restore_default_cursor()

static void _restore_default_cursor ( )

static

Definition at line 102 of file help.c.

References dt_control_allow_change_cursor(), and dt_control_change_cursor.

Referenced by _main_do_event_help().

append_help()

void append_help	(	GtkWidget **	menus,
		GList **	lists,
		const dt_menus_t	index
	)

Definition at line 220 of file help.c.

References add_menu_separator(), add_sub_menu_entry(), contextual_help_callback(), open_chat_callback(), open_doc_callback(), open_forum_callback(), open_search_callback(), search_accels_callback(), and show_about_dialog().

Referenced by dt_ui_init_global_menu().

contextual_help_callback()

static gboolean contextual_help_callback ( GtkAccelGroup *  group, GObject *  acceleratable, guint  keyval, GdkModifierType  mods, gpointer  user_data  )

static

Definition at line 205 of file help.c.

References _main_do_event_help(), dt_control_change_cursor, dt_control_forbid_change_cursor(), and TRUE.

Referenced by append_help().

get_help_url()

static char * get_help_url ( GtkWidget *  widget )

static

Todo:

: this doesn't work for all widgets. the reason being that the GtkEventBox we put libs/iops into catches events.

Definition at line 89 of file help.c.

Referenced by _main_do_event_help().

open_chat_callback()

static gboolean open_chat_callback ( GtkAccelGroup *  group, GObject *  acceleratable, guint  keyval, GdkModifierType  mods, gpointer  user_data  )

static

Definition at line 67 of file help.c.

References darktable, dt_ui_main_window(), darktable_t::gui, TRUE, and dt_gui_gtk_t::ui.

Referenced by append_help().

open_doc_callback()

static gboolean open_doc_callback ( GtkAccelGroup *  group, GObject *  acceleratable, guint  keyval, GdkModifierType  mods, gpointer  user_data  )

static

Todo:

: use translated URL when doc gets translated

Definition at line 60 of file help.c.

References darktable, dt_ui_main_window(), darktable_t::gui, TRUE, and dt_gui_gtk_t::ui.

Referenced by append_help().

open_forum_callback()

static gboolean open_forum_callback ( GtkAccelGroup *  group, GObject *  acceleratable, guint  keyval, GdkModifierType  mods, gpointer  user_data  )

static

Definition at line 81 of file help.c.

References darktable, dt_ui_main_window(), darktable_t::gui, TRUE, and dt_gui_gtk_t::ui.

Referenced by append_help().

open_search_callback()

static gboolean open_search_callback ( GtkAccelGroup *  group, GObject *  acceleratable, guint  keyval, GdkModifierType  mods, gpointer  user_data  )

static

Definition at line 74 of file help.c.

References darktable, dt_ui_main_window(), darktable_t::gui, TRUE, and dt_gui_gtk_t::ui.

Referenced by append_help().

search_accels_callback()

static gboolean search_accels_callback ( GtkAccelGroup *  group, GObject *  acceleratable, guint  keyval, GdkModifierType  mods, gpointer  user_data  )

static

Definition at line 213 of file help.c.

References dt_gui_gtk_t::accels, darktable, dt_accels_search(), dt_ui_main_window(), darktable_t::gui, main(), TRUE, and dt_gui_gtk_t::ui.

Referenced by append_help().

show_about_dialog()

static gboolean show_about_dialog ( GtkAccelGroup *  group, GObject *  acceleratable, guint  keyval, GdkModifierType  mods, gpointer  user_data  )

static

Definition at line 25 of file help.c.

References darktable, darktable_last_commit_year, darktable_package_version, dt_free, dt_osx_disallow_fullscreen(), dt_ui_main_window(), darktable_t::gui, PACKAGE_NAME, TRUE, and dt_gui_gtk_t::ui.

Referenced by append_help().