2 * Copyright notice from original mutt:
3 * Copyright (C) 1996-2000 Michael R. Elkins <me@mutt.org>
5 * This file is part of mutt-ng, see http://www.muttng.org/.
6 * It's licensed under the GNU General Public License,
7 * please see the file GPL in the top level source directory.
12 #include <lib-lib/lib-lib.h>
14 #include <lib-ui/curses.h>
21 static struct binding_t *help_lookupFunction (int op, int menu)
24 struct binding_t *map;
26 if (menu != MENU_PAGER) {
27 /* first look in the generic map for the function */
28 for (i = 0; OpGeneric[i].name; i++)
29 if (OpGeneric[i].op == op)
30 return (&OpGeneric[i]);
33 if ((map = km_get_table (menu))) {
34 for (i = 0; map[i].name; i++)
42 void mutt_make_help (char *d, ssize_t dlen, const char *txt, int menu, int op)
46 if (km_expand_key (buf, sizeof (buf), km_find_func (menu, op)) ||
47 km_expand_key (buf, sizeof (buf), km_find_func (MENU_GENERIC, op)))
48 snprintf (d, dlen, "%s:%s", buf, txt);
53 static int print_macro (FILE * f, int maxwidth, const char **macro)
59 ssize_t len = m_strlen(*macro);
60 mbstate_t mbstate1, mbstate2;
62 p_clear(&mbstate1, 1);
63 p_clear(&mbstate2, 1);
64 for (; len && (k = mbrtowc (&wc, *macro, len, &mbstate1));
65 *macro += k, len -= k) {
66 if (k == -1 || k == -2) {
67 k = (k == -1) ? 1 : len;
68 wc = CharsetReplacement;
70 /* glibc-2.1.3's wcwidth() returns 1 for unprintable chars! */
71 if (iswprint(wc) && (w = wcwidth (wc)) >= 0) {
76 char buf[MB_LEN_MAX * 2];
79 if ((n1 = wcrtomb(buf, wc, &mbstate2)) != -1 &&
80 (n2 = wcrtomb(buf + n1, 0, &mbstate2)) != -1)
84 else if (wc < 0x20 || wc == 0x7f) {
97 fprintf (f, "^%c", (char) ((wc + '@') & 0x7f));
106 return (maxwidth - n);
109 static int pad (FILE * f, int col, int i)
114 snprintf (fmt, sizeof (fmt), "%%-%ds", i - col);
115 fprintf (f, fmt, "");
122 static void help_format_line (FILE * f, int ismacro,
123 const char *t1, const char *t2, const char *t3)
132 /* don't try to press string into one line with less than 40 characters.
133 The double paranthesis avoid a gcc warning, sigh ... */
134 if ((split = COLS < 40)) {
140 col_a = COLS > 83 ? (COLS - 32) >> 2 : 12;
141 col_b = COLS > 49 ? (COLS - 10) >> 1 : 19;
142 col = pad (f, m_strlen(t1), col_a);
146 fputs ("_\010M ", f);
150 col += print_macro (f, col_b - col - 4, &t2);
151 if (m_strlen(t2) > col_b - col)
156 col += print_macro (f, col_b - col - 1, &t2);
160 col = pad (f, col, col_b);
163 print_macro (f, LONG_STRING, &t3);
171 t3 = vskipspaces(t3);
173 /* FIXME: this is completely wrong */
174 if ((n = m_strlen(t3)) > COLS - col) {
176 for (col_a = n; col_a > 0 && t3[col_a] != ' '; col_a--);
182 print_macro (f, n, &t3);
186 if (option (OPTMARKERS))
188 col = pad (f, n, col_b);
196 static void dump_menu (FILE * f, int menu)
198 struct keymap_t *map;
202 /* browse through the keymap table */
203 for (map = Keymaps[menu]; map; map = map->next) {
204 if (map->op != OP_NULL) {
205 km_expand_key (buf, sizeof (buf), map);
207 if (map->op == OP_MACRO) {
208 if (map->descr == NULL)
209 help_format_line (f, -1, buf, "macro", map->macro);
211 help_format_line (f, 1, buf, map->macro, map->descr);
214 b = help_lookupFunction (map->op, menu);
215 help_format_line (f, 0, buf, b ? b->name : "UNKNOWN",
216 b ? _(HelpStrings[b->op]) :
217 _("ERROR: please report this bug"));
223 static int is_bound (struct keymap_t *map, int op)
225 for (; map; map = map->next)
231 static void dump_unbound (FILE * f,
232 struct binding_t *funcs,
233 struct keymap_t *map, struct keymap_t *aux)
237 for (i = 0; funcs[i].name; i++) {
238 if (!is_bound (map, funcs[i].op) &&
239 (!aux || !is_bound (aux, funcs[i].op)))
240 help_format_line (f, 0, funcs[i].name, "", _(HelpStrings[funcs[i].op]));
244 void mutt_help (int menu)
246 char tmp[_POSIX_PATH_MAX];
250 struct binding_t *funcs;
252 funcs = km_get_table (menu);
253 desc = mutt_getnamebyvalue (menu, Menus);
255 desc = _("<UNKNOWN>");
258 f = m_tempfile(tmp, sizeof(tmp), NONULL(mod_core.tmpdir), NULL);
265 if (menu != MENU_EDITOR && menu != MENU_PAGER) {
266 fputs(_("\nGeneric bindings:\n\n"), f);
267 dump_menu(f, MENU_GENERIC);
270 fputs(_("\nUnbound functions:\n\n"), f);
272 dump_unbound(f, funcs, Keymaps[menu], NULL);
274 if (menu != MENU_PAGER)
275 dump_unbound (f, OpGeneric, Keymaps[MENU_GENERIC], Keymaps[menu]);
279 snprintf(buf, sizeof (buf), _("Help for %s"), desc);
280 } while (mutt_pager(buf, tmp,
281 M_PAGER_RETWINCH | M_PAGER_MARKER | M_PAGER_NSKIP,
282 NULL) == OP_REFORMAT_WINCH);