init.h File Reference

Set up the key bindings. More...

#include "menu.h"

Include dependency graph for init.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
void	km_cleanup (struct KeyModuleData *mod_data)
	Free the key maps.
int	km_config_observer (struct NotifyCallback *nc)
	Notification that a Config Variable has changed - Implements observer_t -.
void	km_init (struct KeyModuleData *mod_data)
	Initialise all the menu keybindings.
void	km_menu_add_bindings (struct MenuDefinition *md, const struct MenuOpSeq bindings[])
	Add Keybindings to a Menu.
void	km_menu_add_submenu (struct MenuDefinition *md, struct SubMenu *sm)
	Add a SubMenu to a Menu Definition.
struct MenuDefinition *	km_register_menu (int menu, const char *name)
	Register a menu.
struct SubMenu *	km_register_submenu (const struct MenuFuncOp functions[])
	Register a submenu.
void	km_set_abort_key (keycode_t *abort_key)
	Parse the abort_key config string.
void	km_sort (void)
	Sort all the menu keybindings.

Detailed Description

Set up the key bindings.

Authors

• Richard Russon

Copyright

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Definition in file init.h.

Function Documentation

km_cleanup()

void km_cleanup

(

struct KeyModuleData *

mod_data

)

Free the key maps.

Parameters

mod_data

Key module data

Definition at line 203 of file init.c.

{
  if (NeoMutt && NeoMutt->sub)
    notify_observer_remove(NeoMutt->sub->notify, km_config_observer, NULL);
 
  struct MenuDefinition **mdp = NULL;
  ARRAY_FOREACH(mdp, &mod_data->menu_defs)
  {
    struct MenuDefinition *md = *mdp;
 
    FREE(&md->name);
    ARRAY_FREE(&md->submenus);
    FREE(&md);
  }
  ARRAY_FREE(&mod_data->menu_defs);
 
  struct SubMenu *sm = NULL;
  ARRAY_FOREACH(sm, &mod_data->sub_menus)
  {
    keymaplist_free(&sm->keymaps);
  }
  ARRAY_FREE(&mod_data->sub_menus);
 
  ARRAY_FREE(&mod_data->macro_events);
  ARRAY_FREE(&mod_data->unget_key_events);
}

Here is the call graph for this function:

Here is the caller graph for this function:

km_init()

void km_init

(

struct KeyModuleData *

mod_data

)

Initialise all the menu keybindings.

Parameters

mod_data

Key module data

Definition at line 170 of file init.c.

{
  ARRAY_INIT(&mod_data->menu_defs);
  ARRAY_INIT(&mod_data->sub_menus);
  mod_data->key_names = keymap_get_key_names();
 
  notify_observer_add(NeoMutt->sub->notify, NT_CONFIG, km_config_observer, NULL);
}

Here is the call graph for this function:

Here is the caller graph for this function:

km_menu_add_bindings()

void km_menu_add_bindings	(	struct MenuDefinition *	md,
		const struct MenuOpSeq	bindings[] )

Add Keybindings to a Menu.

Parameters

md	Menu Definition
bindings	Keybindings to add

Definition at line 134 of file init.c.

{
  for (int i = 0; bindings[i].op != OP_NULL; i++)
  {
    if (bindings[i].seq)
    {
      km_bind(md, bindings[i].seq, bindings[i].op, NULL, NULL, NULL);
    }
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

km_menu_add_submenu()

void km_menu_add_submenu	(	struct MenuDefinition *	md,
		struct SubMenu *	sm )

Add a SubMenu to a Menu Definition.

Parameters

md	Menu Definition
sm	SubMenu to add

Definition at line 121 of file init.c.

{
  if (!sm->parent)
    sm->parent = md;
 
  ARRAY_ADD(&md->submenus, sm);
}

Here is the caller graph for this function:

km_register_menu()

struct MenuDefinition * km_register_menu	(	int	menu,
		const char *	name )

Register a menu.

Parameters

menu	Menu Type, e.g. MENU_INDEX
name	Menu name, e.g. "index"

Return values

ptr	Menu Definition

Definition at line 104 of file init.c.

{
  struct KeyModuleData *mod_data = neomutt_get_module_data(NeoMutt, MODULE_ID_KEY);
  struct MenuDefinition *md = MUTT_MEM_CALLOC(1, struct MenuDefinition);
  md->id = menu;
  md->name = mutt_str_dup(name);
  ARRAY_INIT(&md->submenus);
 
  ARRAY_ADD(&mod_data->menu_defs, md);
  return *ARRAY_LAST(&mod_data->menu_defs);
}

Here is the call graph for this function:

Here is the caller graph for this function:

km_register_submenu()

struct SubMenu * km_register_submenu

(

const struct MenuFuncOp

functions[]

)

Register a submenu.

Parameters

functions

Function definitions

Return values

ptr

SubMenu

Register a set of functions. The result can be used in multiple Menus.

Definition at line 87 of file init.c.

{
  struct KeyModuleData *mod_data = neomutt_get_module_data(NeoMutt, MODULE_ID_KEY);
  struct SubMenu sm = { 0 };
  sm.functions = functions;
  ARRAY_INIT(&sm.keymaps);
 
  ARRAY_ADD(&mod_data->sub_menus, sm);
  return ARRAY_LAST(&mod_data->sub_menus);
}

Here is the call graph for this function:

Here is the caller graph for this function:

km_set_abort_key()

void km_set_abort_key

(

keycode_t *

abort_key

)

Parse the abort_key config string.

Parameters

abort_key

Pointer to the abort key variable to set

Parse the string into $abort_key and put the keycode into AbortKey.

Definition at line 236 of file init.c.

{
  keycode_t buf[4] = { 0 };
  const char *const c_abort_key = cs_subset_string(NeoMutt->sub, "abort_key");
 
  size_t len = parse_keys(c_abort_key, buf, countof(buf));
  if (len == 0)
  {
    mutt_error(_("Abort key is not set, defaulting to Ctrl-G"));
    *abort_key = ctrl('G');
    return;
  }
 
  if (len > 1)
  {
    mutt_warning(_("Specified abort key sequence (%s) will be truncated to first key"),
                 c_abort_key);
  }
  *abort_key = buf[0];
}

Here is the call graph for this function:

Here is the caller graph for this function:

km_sort()

void km_sort

(

void

)

Sort all the menu keybindings.

Definition at line 193 of file init.c.

{
  struct KeyModuleData *mod_data = neomutt_get_module_data(NeoMutt, MODULE_ID_KEY);
  ARRAY_SORT(&mod_data->menu_defs, menu_defs_sort, NULL);
}

Here is the call graph for this function:

Here is the caller graph for this function: