functions.c File Reference

Browser functions. More...

#include "config.h"
#include <stdbool.h>
#include <stdio.h>
#include <string.h>
#include <sys/stat.h>
#include "mutt/lib.h"
#include "config/lib.h"
#include "email/lib.h"
#include "core/lib.h"
#include "gui/lib.h"
#include "mutt.h"
#include "lib.h"
#include "attach/lib.h"
#include "editor/lib.h"
#include "history/lib.h"
#include "imap/lib.h"
#include "key/lib.h"
#include "menu/lib.h"
#include "nntp/lib.h"
#include "pattern/lib.h"
#include "question/lib.h"
#include "send/lib.h"
#include "functions.h"
#include "globals.h"
#include "mutt_mailbox.h"
#include "muttlib.h"
#include "mx.h"
#include "nntp/adata.h"
#include "nntp/mdata.h"
#include "private_data.h"
#include "sort.h"

Include dependency graph for functions.c:

Go to the source code of this file.

Functions
static int	op_subscribe_pattern (struct BrowserPrivateData *priv, int op)
	Subscribe to newsgroups matching a pattern - Implements browser_function_t -.
void	destroy_state (struct BrowserState *state)
	Free the BrowserState.
static int	op_browser_new_file (struct BrowserPrivateData *priv, int op)
	Select a new file in this directory - Implements browser_function_t -.
static int	op_browser_subscribe (struct BrowserPrivateData *priv, int op)
	Subscribe to current mbox (IMAP/NNTP only) - Implements browser_function_t -.
static int	op_browser_tell (struct BrowserPrivateData *priv, int op)
	Display the currently selected file's name - Implements browser_function_t -.
static int	op_browser_toggle_lsub (struct BrowserPrivateData *priv, int op)
	Toggle view all/subscribed mailboxes (IMAP only) - Implements browser_function_t -.
static int	op_browser_view_file (struct BrowserPrivateData *priv, int op)
	View file - Implements browser_function_t -.
static int	op_catchup (struct BrowserPrivateData *priv, int op)
	Mark all articles in newsgroup as read - Implements browser_function_t -.
static int	op_change_directory (struct BrowserPrivateData *priv, int op)
	Change directories - Implements browser_function_t -.
static int	op_create_mailbox (struct BrowserPrivateData *priv, int op)
	Create a new mailbox (IMAP only) - Implements browser_function_t -.
static int	op_delete_mailbox (struct BrowserPrivateData *priv, int op)
	Delete the current mailbox (IMAP only) - Implements browser_function_t -.
static int	op_enter_mask (struct BrowserPrivateData *priv, int op)
	Enter a file mask - Implements browser_function_t -.
static int	op_exit (struct BrowserPrivateData *priv, int op)
	Exit this menu - Implements browser_function_t -.
static int	op_generic_select_entry (struct BrowserPrivateData *priv, int op)
	Select the current entry - Implements browser_function_t -.
static int	op_load_active (struct BrowserPrivateData *priv, int op)
	Load list of all newsgroups from NNTP server - Implements browser_function_t -.
static int	op_mailbox_list (struct BrowserPrivateData *priv, int op)
	List mailboxes with new mail - Implements browser_function_t -.
static int	op_rename_mailbox (struct BrowserPrivateData *priv, int op)
	Rename the current mailbox (IMAP only) - Implements browser_function_t -.
static int	op_sort (struct BrowserPrivateData *priv, int op)
	Sort messages - Implements browser_function_t -.
static int	op_toggle_mailboxes (struct BrowserPrivateData *priv, int op)
	Toggle whether to browse mailboxes or all files - Implements browser_function_t -.
int	browser_function_dispatcher (struct MuttWindow *win, int op)
	Perform a Browser function.

Variables
const struct MenuFuncOp	OpBrowser []
	Functions for the file Browser Menu.
const struct MenuOpSeq	BrowserDefaultBindings []
	Key bindings for the file Browser Menu.
static const struct BrowserFunction	BrowserFunctions []
	All the NeoMutt functions that the Browser supports.

Detailed Description

Browser functions.

Authors

• Richard Russon
• Dennis Schön

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 functions.c.

Function Documentation

destroy_state()

void destroy_state

(

struct BrowserState *

state

)

Free the BrowserState.

Parameters

state

State to free

Frees up the memory allocated for the local-global variables.

Definition at line 135 of file functions.c.

{
  struct FolderFile *ff = NULL;
  ARRAY_FOREACH(ff, &state->entry)
  {
    FREE(&ff->name);
    FREE(&ff->desc);
  }
  ARRAY_FREE(&state->entry);
  FREE(&state->folder);
}

Here is the caller graph for this function:

browser_function_dispatcher()

int browser_function_dispatcher	(	struct MuttWindow *	win,
		int	op )

Perform a Browser function.

Parameters

win	Window for the Browser
op	Operation to perform, e.g. OP_GOTO_PARENT

Return values

num	FunctionRetval, e.g. FR_SUCCESS

Definition at line 1130 of file functions.c.

{
  // The Dispatcher may be called on any Window in the Dialog
  struct MuttWindow *dlg = dialog_find(win);
  if (!dlg || !dlg->wdata)
    return FR_ERROR;
 
  struct Menu *menu = dlg->wdata;
  struct BrowserPrivateData *priv = menu->mdata;
  if (!priv)
    return FR_ERROR;
 
  int rc = FR_UNKNOWN;
  for (size_t i = 0; BrowserFunctions[i].op != OP_NULL; i++)
  {
    const struct BrowserFunction *fn = &BrowserFunctions[i];
    if (fn->op == op)
    {
      rc = fn->function(priv, op);
      break;
    }
  }
 
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

OpBrowser

const struct MenuFuncOp OpBrowser[]

Initial value:

= { 
  { "catchup",                       OP_CATCHUP },
  { "change-dir",                    OP_CHANGE_DIRECTORY },
  { "check-new",                     OP_CHECK_NEW },
  { "create-mailbox",                OP_CREATE_MAILBOX },
  { "delete-mailbox",                OP_DELETE_MAILBOX },
  { "descend-directory",             OP_DESCEND_DIRECTORY },
  { "display-filename",              OP_BROWSER_TELL },
  { "enter-mask",                    OP_ENTER_MASK },
  { "exit",                          OP_EXIT },
  { "goto-folder",                   OP_BROWSER_GOTO_FOLDER },
  { "goto-parent",                   OP_GOTO_PARENT },
  { "mailbox-list",                  OP_MAILBOX_LIST },
  { "reload-active",                 OP_LOAD_ACTIVE },
  { "rename-mailbox",                OP_RENAME_MAILBOX },
  { "select-new",                    OP_BROWSER_NEW_FILE },
  { "sort",                          OP_SORT },
  { "sort-reverse",                  OP_SORT_REVERSE },
  { "subscribe",                     OP_BROWSER_SUBSCRIBE },
  { "subscribe-pattern",             OP_SUBSCRIBE_PATTERN },
  { "toggle-mailboxes",              OP_TOGGLE_MAILBOXES },
  { "toggle-subscribed",             OP_BROWSER_TOGGLE_LSUB },
  { "uncatchup",                     OP_UNCATCHUP },
  { "unsubscribe",                   OP_BROWSER_UNSUBSCRIBE },
  { "unsubscribe-pattern",           OP_UNSUBSCRIBE_PATTERN },
  { "view-file",                     OP_BROWSER_VIEW_FILE },
  
  { "buffy-list",                    OP_MAILBOX_LIST, OP_DEPRECATED },
  { NULL, 0 },
}

Functions for the file Browser Menu.

Definition at line 72 of file functions.c.

                                      { /* map: browser */
  { "catchup",                       OP_CATCHUP },
  { "change-dir",                    OP_CHANGE_DIRECTORY },
  { "check-new",                     OP_CHECK_NEW },
  { "create-mailbox",                OP_CREATE_MAILBOX },
  { "delete-mailbox",                OP_DELETE_MAILBOX },
  { "descend-directory",             OP_DESCEND_DIRECTORY },
  { "display-filename",              OP_BROWSER_TELL },
  { "enter-mask",                    OP_ENTER_MASK },
  { "exit",                          OP_EXIT },
  { "goto-folder",                   OP_BROWSER_GOTO_FOLDER },
  { "goto-parent",                   OP_GOTO_PARENT },
  { "mailbox-list",                  OP_MAILBOX_LIST },
  { "reload-active",                 OP_LOAD_ACTIVE },
  { "rename-mailbox",                OP_RENAME_MAILBOX },
  { "select-new",                    OP_BROWSER_NEW_FILE },
  { "sort",                          OP_SORT },
  { "sort-reverse",                  OP_SORT_REVERSE },
  { "subscribe",                     OP_BROWSER_SUBSCRIBE },
  { "subscribe-pattern",             OP_SUBSCRIBE_PATTERN },
  { "toggle-mailboxes",              OP_TOGGLE_MAILBOXES },
  { "toggle-subscribed",             OP_BROWSER_TOGGLE_LSUB },
  { "uncatchup",                     OP_UNCATCHUP },
  { "unsubscribe",                   OP_BROWSER_UNSUBSCRIBE },
  { "unsubscribe-pattern",           OP_UNSUBSCRIBE_PATTERN },
  { "view-file",                     OP_BROWSER_VIEW_FILE },
  // Deprecated
  { "buffy-list",                    OP_MAILBOX_LIST, OP_DEPRECATED },
  { NULL, 0 },
};

BrowserDefaultBindings

const struct MenuOpSeq BrowserDefaultBindings[]

Initial value:

= { 
  { OP_BROWSER_GOTO_FOLDER,                "=" },
  { OP_BROWSER_NEW_FILE,                   "N" },
  { OP_BROWSER_SUBSCRIBE,                  "s" },
  { OP_BROWSER_TELL,                       "@" },
  { OP_BROWSER_TOGGLE_LSUB,                "T" },
  { OP_BROWSER_UNSUBSCRIBE,                "u" },
  { OP_BROWSER_VIEW_FILE,                  " " },              
  { OP_CHANGE_DIRECTORY,                   "c" },
  { OP_CREATE_MAILBOX,                     "C" },
  { OP_DELETE_MAILBOX,                     "d" },
  { OP_ENTER_MASK,                         "m" },
  { OP_EXIT,                               "q" },
  { OP_GOTO_PARENT,                        "p" },
  { OP_MAILBOX_LIST,                       "." },
  { OP_RENAME_MAILBOX,                     "r" },
  { OP_SORT,                               "o" },
  { OP_SORT_REVERSE,                       "O" },
  { OP_TOGGLE_MAILBOXES,                   "\t" },             
  { 0, NULL },
}

Key bindings for the file Browser Menu.

Definition at line 106 of file functions.c.

                                                  { /* map: browser */
  { OP_BROWSER_GOTO_FOLDER,                "=" },
  { OP_BROWSER_NEW_FILE,                   "N" },
  { OP_BROWSER_SUBSCRIBE,                  "s" },
  { OP_BROWSER_TELL,                       "@" },
  { OP_BROWSER_TOGGLE_LSUB,                "T" },
  { OP_BROWSER_UNSUBSCRIBE,                "u" },
  { OP_BROWSER_VIEW_FILE,                  " " },              // <Space>
  { OP_CHANGE_DIRECTORY,                   "c" },
  { OP_CREATE_MAILBOX,                     "C" },
  { OP_DELETE_MAILBOX,                     "d" },
  { OP_ENTER_MASK,                         "m" },
  { OP_EXIT,                               "q" },
  { OP_GOTO_PARENT,                        "p" },
  { OP_MAILBOX_LIST,                       "." },
  { OP_RENAME_MAILBOX,                     "r" },
  { OP_SORT,                               "o" },
  { OP_SORT_REVERSE,                       "O" },
  { OP_TOGGLE_MAILBOXES,                   "\t" },             // <Tab>
  { 0, NULL },
};

BrowserFunctions

const struct BrowserFunction BrowserFunctions[]

static

All the NeoMutt functions that the Browser supports.

Definition at line 1092 of file functions.c.

                                                         {
  // clang-format off
  { OP_BROWSER_GOTO_FOLDER,  op_toggle_mailboxes },
  { OP_BROWSER_NEW_FILE,     op_browser_new_file },
  { OP_BROWSER_SUBSCRIBE,    op_browser_subscribe },
  { OP_BROWSER_TELL,         op_browser_tell },
  { OP_BROWSER_TOGGLE_LSUB,  op_browser_toggle_lsub },
  { OP_BROWSER_UNSUBSCRIBE,  op_browser_subscribe },
  { OP_BROWSER_VIEW_FILE,    op_browser_view_file },
  { OP_CATCHUP,              op_catchup },
  { OP_CHANGE_DIRECTORY,     op_change_directory },
  { OP_CHECK_NEW,            op_toggle_mailboxes },
  { OP_CREATE_MAILBOX,       op_create_mailbox },
  { OP_DELETE_MAILBOX,       op_delete_mailbox },
  { OP_DESCEND_DIRECTORY,    op_generic_select_entry },
  { OP_ENTER_MASK,           op_enter_mask },
  { OP_EXIT,                 op_exit },
  { OP_GENERIC_SELECT_ENTRY, op_generic_select_entry },
  { OP_GOTO_PARENT,          op_change_directory },
  { OP_LOAD_ACTIVE,          op_load_active },
  { OP_MAILBOX_LIST,         op_mailbox_list },
  { OP_RENAME_MAILBOX,       op_rename_mailbox },
  { OP_SORT,                 op_sort },
  { OP_SORT_REVERSE,         op_sort },
  { OP_SUBSCRIBE_PATTERN,    op_subscribe_pattern },
  { OP_TOGGLE_MAILBOXES,     op_toggle_mailboxes },
  { OP_UNCATCHUP,            op_catchup },
  { OP_UNSUBSCRIBE_PATTERN,  op_subscribe_pattern },
  { 0, NULL },
  // clang-format on
};