help.c File Reference

Generate the help-page and GUI display it. More...

#include "config.h"
#include <stdbool.h>
#include <stdio.h>
#include "mutt/lib.h"
#include "config/lib.h"
#include "core/lib.h"
#include "gui/lib.h"
#include "index/lib.h"
#include "key/lib.h"
#include "menu/lib.h"
#include "pager/lib.h"

Include dependency graph for help.c:

Go to the source code of this file.

Functions
static void	dump_message_flags (const struct MenuDefinition *md, FILE *fp)
	Write out all the message flags.
void	mutt_help (const struct MenuDefinition *md)
	Display the Help Page.

Variables
static const char *	FlagCharsDesc []
	Descriptions of the $flag_chars flags.
static const char *	CryptCharsDesc []
	Descriptions of the $crypt_chars flags.
static const char *	ToCharsDesc []
	Descriptions of the $to_chars flags.

Detailed Description

Generate the help-page and GUI display it.

Authors

• Michael R. Elkins
• Richard Russon
• Pietro Cerutti
• Yousef Akbar
• Ihor Antonov
• Tóth János

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

Function Documentation

dump_message_flags()

static void dump_message_flags ( const struct MenuDefinition * md, FILE * fp )

static

Write out all the message flags.

Parameters

md	Menu Definition
fp	File to write to

Display a quick reminder of all the flags in the config options:

• $crypt_chars
• $flag_chars
• $to_chars

Definition at line 103 of file help.c.

{
  if (md != MdIndex)
    return;
 
  const char *flag = NULL;
  int cols;
 
  fprintf(fp, "\n%s\n\n", _("Message flags:"));
 
  const struct MbTable *c_flag_chars = cs_subset_mbtable(NeoMutt->sub, "flag_chars");
  fprintf(fp, "$flag_chars:\n");
  for (int i = FLAG_CHAR_TAGGED; i <= FLAG_CHAR_ZEMPTY; i++)
  {
    flag = mbtable_get_nth_wchar(c_flag_chars, i);
    cols = mutt_strwidth(flag);
    fprintf(fp, "    '%s'%*s  %s\n", flag, 4 - cols, "", _(FlagCharsDesc[i]));
  }
 
  const struct MbTable *c_crypt_chars = cs_subset_mbtable(NeoMutt->sub, "crypt_chars");
  fprintf(fp, "\n$crypt_chars:\n");
  for (int i = FLAG_CHAR_CRYPT_GOOD_SIGN; i <= FLAG_CHAR_CRYPT_NO_CRYPTO; i++)
  {
    flag = mbtable_get_nth_wchar(c_crypt_chars, i);
    cols = mutt_strwidth(flag);
    fprintf(fp, "    '%s'%*s  %s\n", flag, 4 - cols, "", _(CryptCharsDesc[i]));
  }
 
  const struct MbTable *c_to_chars = cs_subset_mbtable(NeoMutt->sub, "to_chars");
  fprintf(fp, "\n$to_chars:\n");
  for (int i = FLAG_CHAR_TO_NOT_IN_THE_LIST; i <= FLAG_CHAR_TO_REPLY_TO; i++)
  {
    flag = mbtable_get_nth_wchar(c_to_chars, i);
    cols = mutt_strwidth(flag);
    fprintf(fp, "    '%s'%*s  %s\n", flag, 4 - cols, "", _(ToCharsDesc[i]));
  }
 
  fprintf(fp, "\n");
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_help()

void mutt_help

(

const struct MenuDefinition *

md

)

Display the Help Page.

Parameters

md	Menu Definition

Definition at line 147 of file help.c.

{
  struct BindingInfoArray bia_bind = ARRAY_HEAD_INITIALIZER;
  struct BindingInfoArray bia_macro = ARRAY_HEAD_INITIALIZER;
  struct BindingInfoArray bia_unbound = ARRAY_HEAD_INITIALIZER;
  struct Buffer *banner = NULL;
  struct Buffer *tempfile = NULL;
  struct BindingInfo *bi = NULL;
 
  // ---------------------------------------------------------------------------
  // Gather the data
 
  gather_menu(md, &bia_bind, &bia_macro, false);
 
  ARRAY_SORT(&bia_bind, binding_sort, NULL);
  ARRAY_SORT(&bia_macro, binding_sort, NULL);
 
  int wb0 = measure_column(&bia_bind, 0);
  int wb1 = measure_column(&bia_bind, 1);
 
  const int wm0 = measure_column(&bia_macro, 0);
 
  gather_unbound(md, &bia_unbound);
 
  ARRAY_SORT(&bia_unbound, binding_sort, NULL);
  const int wu1 = measure_column(&bia_unbound, 1);
 
  // ---------------------------------------------------------------------------
  // Save the data to a file
 
  tempfile = buf_pool_get();
  buf_mktemp(tempfile);
  FILE *fp = mutt_file_fopen(buf_string(tempfile), "w");
  if (!fp)
  {
    mutt_perror("%s", buf_string(tempfile));
    goto cleanup;
  }
 
  const char *menu_name = NULL;
  ARRAY_FOREACH(bi, &bia_bind)
  {
    if (!bi->a[0])
    {
      menu_name = bi->a[2];
      continue;
    }
 
    if (menu_name)
    {
      if (ARRAY_FOREACH_IDX_bi > 0)
        fprintf(fp, "\n");
 
      fprintf(fp, "%s bindings\n", menu_name);
      fprintf(fp, "\n");
      menu_name = NULL;
    }
 
    // key text description
    fprintf(fp, "%*s  %*s  %s\n", -wb0, bi->a[0], -wb1, bi->a[1], bi->a[2]);
  }
 
  ARRAY_FOREACH(bi, &bia_macro)
  {
    if (!bi->a[0])
    {
      menu_name = bi->a[2];
      continue;
    }
 
    if (menu_name)
    {
      if (ARRAY_FOREACH_IDX_bi > 0)
        fprintf(fp, "\n");
 
      fprintf(fp, "%s macros\n", menu_name);
      fprintf(fp, "\n");
      menu_name = NULL;
    }
 
    if (bi->a[2]) // description
    {
      // key description, macro-text, blank line
      fprintf(fp, "%*s  %s\n", -wm0, bi->a[0], bi->a[2]);
      fprintf(fp, "%s\n", bi->a[1]);
      fprintf(fp, "\n");
    }
    else
    {
      // key macro-text
      fprintf(fp, "%*s  %s\n", -wm0, bi->a[0], bi->a[1]);
    }
  }
  fprintf(fp, "\n");
 
  fprintf(fp, "unbound functions\n");
  fprintf(fp, "\n");
  ARRAY_FOREACH(bi, &bia_unbound)
  {
    // function description
    fprintf(fp, "%*s  %s\n", -wu1, bi->a[1], bi->a[2]);
  }
 
  dump_message_flags(md, fp);
  mutt_file_fclose(&fp);
 
  // ---------------------------------------------------------------------------
  // Display data
 
  struct PagerData pdata = { 0 };
  struct PagerView pview = { &pdata };
 
  pview.mode = PAGER_MODE_HELP;
  pview.flags = MUTT_PAGER_MARKER | MUTT_PAGER_NOWRAP | MUTT_PAGER_STRIPES;
 
  banner = buf_pool_get();
  buf_printf(banner, _("Help for %s"), md->name);
  pdata.fname = buf_string(tempfile);
  pview.banner = buf_string(banner);
  mutt_do_pager(&pview, NULL);
 
cleanup:
 
  ARRAY_FOREACH(bi, &bia_bind)
  {
    FREE(&bi->a[0]);
  }
 
  ARRAY_FOREACH(bi, &bia_macro)
  {
    FREE(&bi->a[0]);
    FREE(&bi->a[1]);
  }
 
  buf_pool_release(&banner);
  buf_pool_release(&tempfile);
  ARRAY_FREE(&bia_bind);
  ARRAY_FREE(&bia_macro);
  ARRAY_FREE(&bia_unbound);
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

FlagCharsDesc

const char* FlagCharsDesc[]

static

Initial value:

= {
  N_("message is tagged"),
  N_("message is flagged"),
  N_("message is deleted"),
  N_("attachment is deleted"),
  N_("message has been replied to"),
  N_("message has been read"),
  N_("message is new"),
  N_("thread has been read"),
  N_("thread has at least one new message"),
  N_("message has been read (%S expando)"),
  N_("message has been read (%Z expando)"),
}

Descriptions of the $flag_chars flags.

This must be in the same order as FlagChars

Definition at line 51 of file help.c.

                                     {
  N_("message is tagged"),
  N_("message is flagged"),
  N_("message is deleted"),
  N_("attachment is deleted"),
  N_("message has been replied to"),
  N_("message has been read"),
  N_("message is new"),
  N_("thread has been read"),
  N_("thread has at least one new message"),
  N_("message has been read (%S expando)"),
  N_("message has been read (%Z expando)"),
};

CryptCharsDesc

const char* CryptCharsDesc[]

static

Initial value:

= {
  N_("message signed with a verified key"),
  N_("message is PGP-encrypted"),
  N_("message is signed"),
  N_("message contains a PGP key"),
  N_("message has no cryptography information"),
}

Descriptions of the $crypt_chars flags.

This must be in the same order as CryptChars

Definition at line 70 of file help.c.

                                      {
  N_("message signed with a verified key"),
  N_("message is PGP-encrypted"),
  N_("message is signed"),
  N_("message contains a PGP key"),
  N_("message has no cryptography information"),
};

ToCharsDesc

const char* ToCharsDesc[]

static

Initial value:

= {
  N_("message is not To: you"),
  N_("message is To: you and only you"),
  N_("message is To: you"),
  N_("message is Cc: to you"),
  N_("message is From: you"),
  N_("message is sent to a subscribed mailing list"),
  N_("you are in the Reply-To: list"),
}

Descriptions of the $to_chars flags.

This must be in the same order as ToChars

Definition at line 83 of file help.c.

                                   {
  N_("message is not To: you"),
  N_("message is To: you and only you"),
  N_("message is To: you"),
  N_("message is Cc: to you"),
  N_("message is From: you"),
  N_("message is sent to a subscribed mailing list"),
  N_("you are in the Reply-To: list"),
};