NeoMutt  2025-12-11-435-g4ac674
Teaching an old dog new tricks
DOXYGEN
Loading...
Searching...
No Matches
dlg_index.c
Go to the documentation of this file.
1
28
59
60#include "config.h"
61#include <stdbool.h>
62#include <string.h>
63#include "private.h"
64#include "mutt/lib.h"
65#include "config/lib.h"
66#include "email/lib.h"
67#include "core/lib.h"
68#include "conn/lib.h"
69#include "gui/lib.h"
70#include "mutt.h"
71#include "lib.h"
72#include "color/lib.h"
73#include "expando/lib.h"
74#include "hooks/lib.h"
75#include "key/lib.h"
76#include "menu/lib.h"
77#include "nntp/lib.h"
78#include "pager/lib.h"
79#include "pattern/lib.h"
80#include "sidebar/lib.h"
81#include "expando_index.h"
82#include "functions.h"
83#include "globals.h"
84#include "mutt_logging.h"
85#include "mutt_mailbox.h"
86#include "mx.h"
87#include "nntp/adata.h"
88#include "private_data.h"
89#include "shared_data.h"
90#include "status.h"
91#ifdef USE_NOTMUCH
92#include "notmuch/lib.h"
93#endif
94#ifdef USE_INOTIFY
95#include "monitor.h"
96#endif
97
99static const struct Mapping IndexHelp[] = {
100 // clang-format off
101 { N_("Quit"), OP_QUIT },
102 { N_("Del"), OP_DELETE },
103 { N_("Undel"), OP_UNDELETE },
104 { N_("Save"), OP_SAVE },
105 { N_("Mail"), OP_MAIL },
106 { N_("Reply"), OP_REPLY },
107 { N_("Group"), OP_GROUP_REPLY },
108 { N_("Help"), OP_HELP },
109 { NULL, 0 },
110 // clang-format on
111};
112
114const struct Mapping IndexNewsHelp[] = {
115 // clang-format off
116 { N_("Quit"), OP_QUIT },
117 { N_("Del"), OP_DELETE },
118 { N_("Undel"), OP_UNDELETE },
119 { N_("Save"), OP_SAVE },
120 { N_("Post"), OP_POST },
121 { N_("Followup"), OP_FOLLOWUP },
122 { N_("Catchup"), OP_CATCHUP },
123 { N_("Help"), OP_HELP },
124 { NULL, 0 },
125 // clang-format on
126};
127
135bool check_acl(struct Mailbox *m, AclFlags acl, const char *msg)
136{
137 if (!m)
138 return false;
139
140 if (!(m->rights & acl))
141 {
142 /* L10N: %s is one of the CHECK_ACL entries below. */
143 mutt_error(_("%s: Operation not permitted by ACL"), msg);
144 return false;
145 }
146
147 return true;
148}
149
162void collapse_all(struct MailboxView *mv, struct Menu *menu, int toggle)
163{
164 if (!mv || !mv->mailbox || (mv->mailbox->msg_count == 0) || !menu)
165 return;
166
167 struct Email *e_cur = mutt_get_virt_email(mv->mailbox, menu_get_index(menu));
168 if (!e_cur)
169 return;
170
171 int final;
172
173 /* Figure out what the current message would be after folding / unfolding,
174 * so that we can restore the cursor in a sane way afterwards. */
175 if (e_cur->collapsed && toggle)
176 final = mutt_uncollapse_thread(e_cur);
177 else if (mutt_thread_can_collapse(e_cur))
178 final = mutt_collapse_thread(e_cur);
179 else
180 final = e_cur->vnum;
181
182 if (final == -1)
183 return;
184
185 struct Email *base = mutt_get_virt_email(mv->mailbox, final);
186 if (!base)
187 return;
188
189 /* Iterate all threads, perform collapse/uncollapse as needed */
190 mv->collapsed = toggle ? !mv->collapsed : true;
192
193 /* Restore the cursor */
195 menu->max = mv->mailbox->vcount;
196 for (int i = 0; i < mv->mailbox->vcount; i++)
197 {
198 struct Email *e = mutt_get_virt_email(mv->mailbox, i);
199 if (!e)
200 break;
201 if (e->index == base->index)
202 {
203 menu_set_index(menu, i);
204 break;
205 }
206 }
207
209}
210
216static void uncollapse_thread(struct MailboxView *mv, int index)
217{
218 if (!mv || !mv->mailbox)
219 return;
220
221 struct Mailbox *m = mv->mailbox;
222 struct Email *e = mutt_get_virt_email(m, index);
223 if (e && e->collapsed)
224 {
226 mutt_set_vnum(m);
227 }
228}
229
238int find_next_undeleted(struct MailboxView *mv, int msgno, bool uncollapse)
239{
240 if (!mv || !mv->mailbox)
241 return -1;
242
243 struct Mailbox *m = mv->mailbox;
244
245 int index = -1;
246 for (int i = msgno + 1; i < m->vcount; i++)
247 {
248 struct Email *e = mutt_get_virt_email(m, i);
249 if (!e)
250 continue;
251 if (!e->deleted)
252 {
253 index = i;
254 break;
255 }
256 }
257
258 if (uncollapse)
260
261 return index;
262}
263
272int find_previous_undeleted(struct MailboxView *mv, int msgno, bool uncollapse)
273{
274 if (!mv || !mv->mailbox)
275 return -1;
276
277 struct Mailbox *m = mv->mailbox;
278
279 int index = -1;
280 for (int i = msgno - 1; i >= 0; i--)
281 {
282 struct Email *e = mutt_get_virt_email(m, i);
283 if (!e)
284 continue;
285 if (!e->deleted)
286 {
287 index = i;
288 break;
289 }
290 }
291
292 if (uncollapse)
294
295 return index;
296}
297
307{
308 if (!mv)
309 return 0;
310
311 struct Mailbox *m = mv->mailbox;
312 if (!m || (m->msg_count == 0))
313 return 0;
314
315 int old = -1;
316 for (int i = 0; i < m->vcount; i++)
317 {
318 struct Email *e = mutt_get_virt_email(m, i);
319 if (!e)
320 continue;
321 if (!e->read && !e->deleted)
322 {
323 if (!e->old)
324 return i;
325 if (old == -1)
326 old = i;
327 }
328 }
329 if (old != -1)
330 return old;
331
332 /* If `$use_threads` is not threaded and `$sort` is reverse, the latest
333 * message is first. Otherwise, the latest message is first if exactly
334 * one of `$use_threads` and `$sort` are reverse.
335 */
336 enum EmailSortType c_sort = cs_subset_sort(m->sub, "sort");
337 if ((c_sort & SORT_MASK) == EMAIL_SORT_THREADS)
338 c_sort = cs_subset_sort(m->sub, "sort_aux");
339 bool reverse = false;
340 switch (mutt_thread_style())
341 {
342 case UT_FLAT:
343 reverse = c_sort & SORT_REVERSE;
344 break;
345 case UT_THREADS:
346 reverse = c_sort & SORT_REVERSE;
347 break;
348 case UT_REVERSE:
349 reverse = !(c_sort & SORT_REVERSE);
350 break;
351 default:
352 ASSERT(false);
353 }
354
355 if (reverse || (m->vcount == 0))
356 return 0;
357
358 return m->vcount - 1;
359}
360
366void resort_index(struct MailboxView *mv, struct Menu *menu)
367{
368 if (!mv || !mv->mailbox || !menu)
369 return;
370
371 struct Mailbox *m = mv->mailbox;
372 const int old_index = menu_get_index(menu);
373 struct Email *e_cur = mutt_get_virt_email(m, old_index);
374
375 int new_index = -1;
376 mutt_sort_headers(mv, false);
377
378 /* Restore the current message */
379 for (int i = 0; i < m->vcount; i++)
380 {
381 struct Email *e = mutt_get_virt_email(m, i);
382 if (!e)
383 continue;
384 if (e == e_cur)
385 {
386 new_index = i;
387 break;
388 }
389 }
390
391 if (mutt_using_threads() && (old_index < 0))
392 new_index = mutt_parent_message(e_cur, false);
393
394 if (old_index < 0)
395 new_index = find_first_message(mv);
396
397 menu->max = m->vcount;
398 menu_set_index(menu, new_index);
400}
401
408static void update_index_threaded(struct MailboxView *mv, enum MxStatus check, int oldcount)
409{
410 struct Email **save_new = NULL;
411 const bool lmt = mview_has_limit(mv);
412
413 struct Mailbox *m = mv->mailbox;
414 int num_new = MAX(0, m->msg_count - oldcount);
415
416 const bool c_uncollapse_new = cs_subset_bool(m->sub, "uncollapse_new");
417 /* save the list of new messages */
418 if ((check != MX_STATUS_REOPENED) && (oldcount > 0) &&
419 (lmt || c_uncollapse_new) && (num_new > 0))
420 {
421 save_new = MUTT_MEM_MALLOC(num_new, struct Email *);
422 for (int i = oldcount; i < m->msg_count; i++)
423 save_new[i - oldcount] = m->emails[i];
424 }
425
426 /* Sort first to thread the new messages, because some patterns
427 * require the threading information.
428 *
429 * If the mailbox was reopened, need to rethread from scratch. */
431
432 if (lmt)
433 {
434 for (int i = 0; i < m->msg_count; i++)
435 {
436 struct Email *e = m->emails[i];
437 if (!e)
438 continue;
439
440 if ((e->limit_visited && e->visible) ||
442 MUTT_MATCH_FULL_ADDRESS, m, e, NULL))
443 {
444 /* vnum will get properly set by mutt_set_vnum(), which
445 * is called by mutt_sort_headers() just below. */
446 e->vnum = 1;
447 e->visible = true;
448 }
449 else
450 {
451 e->vnum = -1;
452 e->visible = false;
453 }
454
455 // mark email as visited so we don't re-apply the pattern next time
456 e->limit_visited = true;
457 }
458 /* Need a second sort to set virtual numbers and redraw the tree */
459 mutt_sort_headers(mv, false);
460 }
461
462 /* uncollapse threads with new mail */
463 if (c_uncollapse_new)
464 {
465 if (check == MX_STATUS_REOPENED)
466 {
467 mv->collapsed = false;
469 mutt_set_vnum(m);
470 }
471 else if (oldcount > 0)
472 {
473 for (int j = 0; j < num_new; j++)
474 {
475 if (save_new[j]->visible)
476 {
477 mutt_uncollapse_thread(save_new[j]);
478 }
479 }
480 mutt_set_vnum(m);
481 }
482 }
483
484 FREE(&save_new);
485}
486
492static void update_index_unthreaded(struct MailboxView *mv, enum MxStatus check)
493{
494 /* We are in a limited view. Check if the new message(s) satisfy
495 * the limit criteria. If they do, set their virtual msgno so that
496 * they will be visible in the limited view */
497 if (mview_has_limit(mv))
498 {
499 int padding = mx_msg_padding_size(mv->mailbox);
500 mv->mailbox->vcount = mv->vsize = 0;
501 for (int i = 0; i < mv->mailbox->msg_count; i++)
502 {
503 struct Email *e = mv->mailbox->emails[i];
504 if (!e)
505 break;
506
507 if ((e->limit_visited && e->visible) ||
509 MUTT_MATCH_FULL_ADDRESS, mv->mailbox, e, NULL))
510 {
512 e->vnum = mv->mailbox->vcount;
513 mv->mailbox->v2r[mv->mailbox->vcount] = i;
514 e->visible = true;
515 mv->mailbox->vcount++;
516 struct Body *b = e->body;
517 mv->vsize += b->length + b->offset - b->hdr_offset + padding;
518 }
519 else
520 {
521 e->visible = false;
522 }
523
524 // mark email as visited so we don't re-apply the pattern next time
525 e->limit_visited = true;
526 }
527 }
528
529 /* if the mailbox was reopened, need to rethread from scratch */
531}
532
541void update_index(struct Menu *menu, struct MailboxView *mv, enum MxStatus check,
542 int oldcount, const struct IndexSharedData *shared)
543{
544 if (!menu || !mv)
545 return;
546
547 struct Mailbox *m = mv->mailbox;
548 if (mutt_using_threads())
549 update_index_threaded(mv, check, oldcount);
550 else
551 update_index_unthreaded(mv, check);
552
553 menu->max = m->vcount;
554 const int old_index = menu_get_index(menu);
555 int index = -1;
556 if (oldcount)
557 {
558 /* restore the current message to the message it was pointing to */
559 for (int i = 0; i < m->vcount; i++)
560 {
561 struct Email *e = mutt_get_virt_email(m, i);
562 if (!e)
563 continue;
564 if (index_shared_data_is_cur_email(shared, e))
565 {
566 index = i;
567 break;
568 }
569 }
570 }
571
572 if (index < 0)
573 {
574 index = (old_index < m->vcount) ? old_index : find_first_message(mv);
575 }
576 menu_set_index(menu, index);
577}
578
585{
586 if (nc->event_type != NT_MAILBOX)
587 return 0;
588 if (!nc->global_data)
589 return -1;
591 return 0;
592
593 struct Mailbox **ptr = nc->global_data;
594 if (!*ptr)
595 return 0;
596
597 *ptr = NULL;
598 mutt_debug(LL_DEBUG5, "mailbox done\n");
599 return 0;
600}
601
610void change_folder_mailbox(struct Menu *menu, struct Mailbox *m, int *oldcount,
611 struct IndexSharedData *shared, bool read_only)
612{
613 if (!m)
614 return;
615
616 /* keepalive failure in mutt_enter_fname may kill connection. */
617 if (shared->mailbox && (buf_is_empty(&shared->mailbox->pathbuf)))
618 {
619 mview_free(&shared->mailbox_view);
620 mailbox_free(&shared->mailbox);
621 }
622
623 if (shared->mailbox)
624 {
625 char *new_last_folder = NULL;
626#ifdef USE_INOTIFY
627 int monitor_remove_rc = mutt_monitor_remove(NULL);
628#endif
629 if (shared->mailbox->compress_info && (shared->mailbox->realpath[0] != '\0'))
630 new_last_folder = mutt_str_dup(shared->mailbox->realpath);
631 else
632 new_last_folder = mutt_str_dup(mailbox_path(shared->mailbox));
633 *oldcount = shared->mailbox->msg_count;
634
635 const enum MxStatus check = mx_mbox_close(shared->mailbox);
636 if (check == MX_STATUS_OK)
637 {
638 mview_free(&shared->mailbox_view);
639 if (shared->mailbox != m)
640 {
641 mailbox_free(&shared->mailbox);
642 }
643 }
644 else
645 {
646#ifdef USE_INOTIFY
647 if (monitor_remove_rc == 0)
648 mutt_monitor_add(NULL);
649#endif
650 if ((check == MX_STATUS_NEW_MAIL) || (check == MX_STATUS_REOPENED))
651 update_index(menu, shared->mailbox_view, check, *oldcount, shared);
652
653 FREE(&new_last_folder);
656 return;
657 }
659 LastFolder = new_last_folder;
660 }
662
663 /* If the `folder-hook` were to call `unmailboxes`, then the Mailbox (`m`)
664 * could be deleted, leaving `m` dangling. */
665 // TODO: Refactor this function to avoid the need for an observer
667 char *dup_path = mutt_str_dup(mailbox_path(m));
668 char *dup_name = mutt_str_dup(m->name);
669
670 exec_folder_hook(dup_path, dup_name);
671 if (m)
672 {
673 /* `m` is still valid, but we won't need the observer again before the end
674 * of the function. */
676 }
677 else
678 {
679 // Recreate the Mailbox as the folder-hook might have invoked `mailboxes`
680 // and/or `unmailboxes`.
681 m = mx_path_resolve(dup_path);
682 }
683
684 FREE(&dup_path);
685 FREE(&dup_name);
686
687 if (!m)
688 return;
689
690 const OpenMailboxFlags flags = read_only ? MUTT_READONLY : MUTT_OPEN_NO_FLAGS;
691 if (mx_mbox_open(m, flags))
692 {
693 struct MailboxView *mv = mview_new(m, NeoMutt->notify);
694 index_shared_data_set_mview(shared, mv);
695
696 menu->max = m->msg_count;
698#ifdef USE_INOTIFY
699 mutt_monitor_add(NULL);
700#endif
701 }
702 else
703 {
704 index_shared_data_set_mview(shared, NULL);
706 }
707
708 const bool c_collapse_all = cs_subset_bool(shared->sub, "collapse_all");
709 if (mutt_using_threads() && c_collapse_all)
710 collapse_all(shared->mailbox_view, menu, 0);
711
713 /* force the mailbox check after we have changed the folder */
714 struct EventMailbox ev_m = { shared->mailbox };
718}
719
720#ifdef USE_NOTMUCH
731struct Mailbox *change_folder_notmuch(struct Menu *menu, char *buf, int buflen, int *oldcount,
732 struct IndexSharedData *shared, bool read_only)
733{
734 if (!nm_url_from_query(NULL, buf, buflen))
735 {
736 mutt_message(_("Failed to create query, aborting"));
737 return NULL;
738 }
739
740 struct Mailbox *m_query = mx_path_resolve(buf);
741 change_folder_mailbox(menu, m_query, oldcount, shared, read_only);
742 if (!shared->mailbox_view)
743 mailbox_free(&m_query);
744 return m_query;
745}
746#endif
747
756void change_folder_string(struct Menu *menu, struct Buffer *buf, int *oldcount,
757 struct IndexSharedData *shared, bool read_only)
758{
759 if (OptNews)
760 {
761 OptNews = false;
762 nntp_expand_path(buf->data, buf->dsize, &CurrentNewsSrv->conn->account);
763 }
764 else
765 {
766 const char *const c_folder = cs_subset_string(shared->sub, "folder");
767 mx_path_canon(buf, c_folder, NULL);
768 }
769
771 if ((type == MUTT_MAILBOX_ERROR) || (type == MUTT_UNKNOWN))
772 {
773 // Look for a Mailbox by its description, before failing
774 struct Mailbox *m = mailbox_find_name(buf_string(buf));
775 if (m)
776 {
777 change_folder_mailbox(menu, m, oldcount, shared, read_only);
778 }
779 else
780 {
781 mutt_error(_("%s is not a mailbox"), buf_string(buf));
782 }
783 return;
784 }
785
786 struct Mailbox *m = mx_path_resolve(buf_string(buf));
787 change_folder_mailbox(menu, m, oldcount, shared, read_only);
788}
789
802int mutt_make_string(struct Buffer *buf, size_t max_cols,
803 const struct Expando *exp, struct Mailbox *m, int inpgr,
804 struct Email *e, MuttFormatFlags flags, const char *progress)
805{
806 if (!exp)
807 return 0;
808
809 struct EmailFormatInfo efi = { 0 };
810
811 efi.email = e;
812 efi.mailbox = m;
813 efi.msg_in_pager = inpgr;
814 efi.pager_progress = progress;
815
816 return expando_filter(exp, IndexRenderCallbacks, &efi, flags, max_cols,
817 NeoMutt->env, buf);
818}
819
825int index_make_entry(struct Menu *menu, int line, int max_cols, struct Buffer *buf)
826{
827 if (!menu || !menu->mdata)
828 return 0;
829
830 struct IndexPrivateData *priv = menu->mdata;
831 struct IndexSharedData *shared = priv->shared;
832 struct Mailbox *m = shared->mailbox;
833 if (!shared->mailbox_view)
834 menu->current = -1;
835
836 if (!m || (line < 0) || (line >= m->email_max))
837 return 0;
838
839 struct Email *e = mutt_get_virt_email(m, line);
840 if (!e)
841 return 0;
842
844 struct MuttThread *tmp = NULL;
845
846 const enum UseThreads c_threads = mutt_thread_style();
847 if ((c_threads > UT_FLAT) && e->tree && e->thread)
848 {
849 flags |= MUTT_FORMAT_TREE; /* display the thread tree */
850 if (e->display_subject)
851 {
852 flags |= MUTT_FORMAT_FORCESUBJ;
853 }
854 else
855 {
856 const bool reverse = c_threads == UT_REVERSE;
857 int edgemsgno;
858 if (reverse)
859 {
860 if (menu->top + menu->page_len > menu->max)
861 edgemsgno = m->v2r[menu->max - 1];
862 else
863 edgemsgno = m->v2r[menu->top + menu->page_len - 1];
864 }
865 else
866 {
867 edgemsgno = m->v2r[menu->top];
868 }
869
870 for (tmp = e->thread->parent; tmp; tmp = tmp->parent)
871 {
872 if (!tmp->message)
873 continue;
874
875 /* if no ancestor is visible on current screen, provisionally force
876 * subject... */
877 if (reverse ? (tmp->message->msgno > edgemsgno) : (tmp->message->msgno < edgemsgno))
878 {
879 flags |= MUTT_FORMAT_FORCESUBJ;
880 break;
881 }
882 else if (tmp->message->vnum >= 0)
883 {
884 break;
885 }
886 }
887 if (flags & MUTT_FORMAT_FORCESUBJ)
888 {
889 for (tmp = e->thread->prev; tmp; tmp = tmp->prev)
890 {
891 if (!tmp->message)
892 continue;
893
894 /* ...but if a previous sibling is available, don't force it */
895 if (reverse ? (tmp->message->msgno > edgemsgno) : (tmp->message->msgno < edgemsgno))
896 {
897 break;
898 }
899 else if (tmp->message->vnum >= 0)
900 {
901 flags &= ~MUTT_FORMAT_FORCESUBJ;
902 break;
903 }
904 }
905 }
906 }
907 }
908
909 const struct Expando *c_index_format = cs_subset_expando(shared->sub, "index_format");
910 int msg_in_pager = shared->mailbox_view ? shared->mailbox_view->msg_in_pager : 0;
911
912 const bool c_arrow_cursor = cs_subset_bool(menu->sub, "arrow_cursor");
913 if (c_arrow_cursor)
914 {
915 const char *const c_arrow_string = cs_subset_string(menu->sub, "arrow_string");
916 if (max_cols > 0)
917 max_cols -= (mutt_strwidth(c_arrow_string) + 1);
918 }
919
920 return mutt_make_string(buf, max_cols, c_index_format, m, msg_in_pager, e, flags, NULL);
921}
922
926const struct AttrColor *index_color(struct Menu *menu, int line)
927{
928 struct IndexPrivateData *priv = menu->mdata;
929 struct IndexSharedData *shared = priv->shared;
930 struct Mailbox *m = shared->mailbox;
931 if (!m || (line < 0))
932 return NULL;
933
934 struct Email *e = mutt_get_virt_email(m, line);
935 if (!e)
936 return NULL;
937
938 if (e->attr_color)
939 return e->attr_color;
940
941 email_set_color(m, e);
942 return e->attr_color;
943}
944
958void mutt_draw_statusline(struct MuttWindow *win, int max_cols, const char *buf, size_t buflen)
959{
960 if (!buf || !stdscr)
961 return;
962
963 size_t i = 0;
964 size_t offset = 0;
965 bool found = false;
966 size_t chunks = 0;
967 size_t len = 0;
968
972 struct StatusSyntax
973 {
974 const struct AttrColor *attr_color;
975 int first;
976 int last;
977 } *syntax = NULL;
978
981 do
982 {
983 struct RegexColor *cl = NULL;
984 found = false;
985
986 if (!buf[offset])
987 break;
988
989 /* loop through each "color status regex" */
991 {
992 regmatch_t pmatch[cl->match + 1];
993 memset(pmatch, 0, (cl->match + 1) * sizeof(regmatch_t));
994
995 if (regexec(&cl->regex, buf + offset, cl->match + 1, pmatch, 0) != 0)
996 continue; /* regex doesn't match the status bar */
997
998 int first = pmatch[cl->match].rm_so + offset;
999 int last = pmatch[cl->match].rm_eo + offset;
1000
1001 if (first == last)
1002 continue; /* ignore an empty regex */
1003
1004 if (!found)
1005 {
1006 chunks++;
1007 MUTT_MEM_REALLOC(&syntax, chunks, struct StatusSyntax);
1008 }
1009
1010 i = chunks - 1;
1011 if (!found || (first < syntax[i].first) ||
1012 ((first == syntax[i].first) && (last > syntax[i].last)))
1013 {
1014 const struct AttrColor *ac_merge = merged_color_overlay(ac_base, &cl->attr_color);
1015
1016 syntax[i].attr_color = ac_merge;
1017 syntax[i].first = first;
1018 syntax[i].last = last;
1019 }
1020 found = true;
1021 }
1022
1023 if (syntax)
1024 {
1025 offset = syntax[i].last;
1026 }
1027 } while (found);
1028
1029 /* Only 'len' bytes will fit into 'max_cols' screen columns */
1030 len = mutt_wstr_trunc(buf, buflen, max_cols, NULL);
1031
1032 offset = 0;
1033
1034 if ((chunks > 0) && (syntax[0].first > 0))
1035 {
1036 /* Text before the first highlight */
1037 mutt_window_addnstr(win, buf, MIN(len, syntax[0].first));
1038 mutt_curses_set_color(ac_base);
1039 if (len <= syntax[0].first)
1040 goto dsl_finish; /* no more room */
1041
1042 offset = syntax[0].first;
1043 }
1044
1045 for (i = 0; i < chunks; i++)
1046 {
1047 /* Highlighted text */
1048 mutt_curses_set_color(syntax[i].attr_color);
1049 mutt_window_addnstr(win, buf + offset, MIN(len, syntax[i].last) - offset);
1050 if (len <= syntax[i].last)
1051 goto dsl_finish; /* no more room */
1052
1053 size_t next;
1054 if ((i + 1) == chunks)
1055 {
1056 next = len;
1057 }
1058 else
1059 {
1060 next = MIN(len, syntax[i + 1].first);
1061 }
1062
1063 mutt_curses_set_color(ac_base);
1064 offset = syntax[i].last;
1065 mutt_window_addnstr(win, buf + offset, next - offset);
1066
1067 offset = next;
1068 if (offset >= len)
1069 goto dsl_finish; /* no more room */
1070 }
1071
1072 mutt_curses_set_color(ac_base);
1073 if (offset < len)
1074 {
1075 /* Text after the last highlight */
1076 mutt_window_addnstr(win, buf + offset, len - offset);
1077 }
1078
1079 int width = mutt_strwidth(buf);
1080 if (width < max_cols)
1081 {
1082 /* Pad the rest of the line with whitespace */
1083 mutt_paddstr(win, max_cols - width, "");
1084 }
1085dsl_finish:
1086 FREE(&syntax);
1087}
1088
1099struct Mailbox *dlg_index(struct MuttWindow *dlg, struct Mailbox *m_init)
1100{
1101 /* Make sure use_threads/sort/sort_aux are coherent */
1103
1104 struct IndexSharedData *shared = dlg->wdata;
1106
1107 struct MuttWindow *panel_index = window_find_child(dlg, WT_INDEX);
1108
1109 struct IndexPrivateData *priv = panel_index->wdata;
1110 priv->win_index = window_find_child(panel_index, WT_MENU);
1111
1112 int op = OP_NULL;
1113
1114 if (shared->mailbox && (shared->mailbox->type == MUTT_NNTP))
1115 dlg->help_data = IndexNewsHelp;
1116 else
1117 dlg->help_data = IndexHelp;
1118 dlg->help_md = MdIndex;
1119
1120 priv->menu = priv->win_index->wdata;
1122 priv->menu->color = index_color;
1123 priv->menu->max = shared->mailbox ? shared->mailbox->vcount : 0;
1125
1126 struct MuttWindow *old_focus = window_set_focus(priv->menu->win);
1127 mutt_window_reflow(NULL);
1128
1129 if (!shared->attach_msg)
1130 {
1131 /* force the mailbox check after we enter the folder */
1133 }
1134#ifdef USE_INOTIFY
1135 mutt_monitor_add(NULL);
1136#endif
1137
1138 const bool c_collapse_all = cs_subset_bool(shared->sub, "collapse_all");
1139 if (mutt_using_threads() && c_collapse_all)
1140 {
1141 collapse_all(shared->mailbox_view, priv->menu, 0);
1143 }
1144
1145 int rc = 0;
1146 do
1147 {
1148 /* Clear the tag prefix unless we just started it.
1149 * Don't clear the prefix on a timeout, but do clear on an abort */
1150 if (priv->tag_prefix && (op != OP_TAG_PREFIX) &&
1151 (op != OP_TAG_PREFIX_COND) && (op != OP_TIMEOUT))
1152 {
1153 priv->tag_prefix = false;
1154 }
1155
1156 /* check if we need to resort the index because just about
1157 * any 'op' below could do mutt_enter_command(), either here or
1158 * from any new priv->menu launched, and change $sort/$sort_aux */
1159 if (OptNeedResort && shared->mailbox && (shared->mailbox->msg_count != 0) &&
1160 (menu_get_index(priv->menu) >= 0))
1161 {
1162 resort_index(shared->mailbox_view, priv->menu);
1163 }
1164
1165 priv->menu->max = shared->mailbox ? shared->mailbox->vcount : 0;
1166 priv->oldcount = shared->mailbox ? shared->mailbox->msg_count : 0;
1167
1168 if (shared->mailbox && shared->mailbox_view)
1169 {
1171
1172 shared->mailbox_view->menu = priv->menu;
1173 /* check for new mail in the mailbox. If nonzero, then something has
1174 * changed about the file (either we got new mail or the file was
1175 * modified underneath us.) */
1176 enum MxStatus check = mx_mbox_check(shared->mailbox);
1177
1178 if (check == MX_STATUS_ERROR)
1179 {
1180 if (buf_is_empty(&shared->mailbox->pathbuf))
1181 {
1182 /* fatal error occurred */
1183 mview_free(&shared->mailbox_view);
1185 }
1186
1188 }
1189 else if ((check == MX_STATUS_NEW_MAIL) || (check == MX_STATUS_REOPENED) ||
1190 (check == MX_STATUS_FLAGS))
1191 {
1192 /* notify the user of new mail */
1193 if (check == MX_STATUS_REOPENED)
1194 {
1195 mutt_error(_("Mailbox was externally modified. Flags may be wrong."));
1196 }
1197 else if (check == MX_STATUS_NEW_MAIL)
1198 {
1199 for (size_t i = 0; i < shared->mailbox->msg_count; i++)
1200 {
1201 const struct Email *e = shared->mailbox->emails[i];
1202 if (e && !e->read && !e->old)
1203 {
1204 mutt_message(_("New mail in this mailbox"));
1205 const bool c_beep_new = cs_subset_bool(shared->sub, "beep_new");
1206 if (c_beep_new)
1207 mutt_beep(true);
1208 const struct Expando *c_new_mail_command =
1209 cs_subset_expando(shared->sub, "new_mail_command");
1210 if (c_new_mail_command)
1211 {
1212 struct Buffer *cmd = buf_pool_get();
1213 menu_status_line(cmd, shared, NULL, -1, c_new_mail_command);
1214 if (mutt_system(buf_string(cmd)) != 0)
1215 mutt_error(_("Error running \"%s\""), buf_string(cmd));
1216 buf_pool_release(&cmd);
1217 }
1218 break;
1219 }
1220 }
1221 }
1222 else if (check == MX_STATUS_FLAGS)
1223 {
1224 mutt_message(_("Mailbox was externally modified"));
1225 }
1226
1227 /* avoid the message being overwritten by mailbox */
1228 priv->do_mailbox_notify = false;
1229
1230 bool verbose = shared->mailbox->verbose;
1231 shared->mailbox->verbose = false;
1232 update_index(priv->menu, shared->mailbox_view, check, priv->oldcount, shared);
1233 shared->mailbox->verbose = verbose;
1234 priv->menu->max = shared->mailbox->vcount;
1237 }
1238
1240 menu_get_index(priv->menu)));
1241 }
1242
1243 if (!shared->attach_msg)
1244 {
1245 /* check for new mail in the incoming folders */
1247 if (priv->do_mailbox_notify)
1248 {
1249 if (mutt_mailbox_notify(shared->mailbox))
1250 {
1251 const bool c_beep_new = cs_subset_bool(shared->sub, "beep_new");
1252 if (c_beep_new)
1253 mutt_beep(true);
1254 const struct Expando *c_new_mail_command = cs_subset_expando(shared->sub, "new_mail_command");
1255 if (c_new_mail_command)
1256 {
1257 struct Buffer *cmd = buf_pool_get();
1258 menu_status_line(cmd, shared, priv->menu, -1, c_new_mail_command);
1259 if (mutt_system(buf_string(cmd)) != 0)
1260 mutt_error(_("Error running \"%s\""), buf_string(cmd));
1261 buf_pool_release(&cmd);
1262 }
1263 }
1264 }
1265 else
1266 {
1267 priv->do_mailbox_notify = true;
1268 }
1269 }
1270
1271 window_redraw(NULL);
1272
1273 /* give visual indication that the next command is a tag- command */
1274 if (priv->tag_prefix)
1275 {
1276 msgwin_set_text(NULL, "tag-", MT_COLOR_NORMAL);
1277 }
1278
1279 const bool c_arrow_cursor = cs_subset_bool(shared->sub, "arrow_cursor");
1280 const bool c_braille_friendly = cs_subset_bool(shared->sub, "braille_friendly");
1281 const int index = menu_get_index(priv->menu);
1282 if (c_arrow_cursor)
1283 {
1284 const char *const c_arrow_string = cs_subset_string(shared->sub, "arrow_string");
1285 const int arrow_width = mutt_strwidth(c_arrow_string);
1286 mutt_window_move(priv->menu->win, index - priv->menu->top, arrow_width);
1287 }
1288 else if (c_braille_friendly)
1289 {
1290 mutt_window_move(priv->menu->win, index - priv->menu->top, 0);
1291 }
1292 else
1293 {
1294 mutt_window_move(priv->menu->win, index - priv->menu->top,
1295 priv->menu->win->state.cols - 1);
1296 }
1297 mutt_refresh();
1298
1299 window_redraw(NULL);
1300 struct KeyEvent event = km_dokey(MdIndex, GETCH_NO_FLAGS);
1301 op = event.op;
1302
1303 if (op == OP_REPAINT)
1304 {
1305 /* force a real complete redraw. clrtobot() doesn't seem to be able
1306 * to handle every case without this. */
1307 msgwin_clear_text(NULL);
1308 mutt_refresh();
1309 continue;
1310 }
1311
1312 /* either user abort or timeout */
1313 if (op < OP_NULL)
1314 {
1315 if (priv->tag_prefix)
1316 msgwin_clear_text(NULL);
1317 continue;
1318 }
1319
1320 mutt_debug(LL_DEBUG1, "Got op %s (%d)\n", opcodes_get_name(op), op);
1321
1322 /* special handling for the priv->tag-prefix function */
1323 const bool c_auto_tag = cs_subset_bool(shared->sub, "auto_tag");
1324 if ((op == OP_TAG_PREFIX) || (op == OP_TAG_PREFIX_COND))
1325 {
1326 /* A second priv->tag-prefix command aborts */
1327 if (priv->tag_prefix)
1328 {
1329 priv->tag_prefix = false;
1330 msgwin_clear_text(NULL);
1331 continue;
1332 }
1333
1334 if (!shared->mailbox)
1335 {
1336 mutt_error(_("No mailbox is open"));
1337 continue;
1338 }
1339
1340 if (shared->mailbox->msg_tagged == 0)
1341 {
1342 if (op == OP_TAG_PREFIX)
1343 {
1344 mutt_error(_("No tagged messages"));
1345 }
1346 else if (op == OP_TAG_PREFIX_COND)
1347 {
1349 mutt_message(_("Nothing to do"));
1350 }
1351 continue;
1352 }
1353
1354 /* get the real command */
1355 priv->tag_prefix = true;
1356 continue;
1357 }
1358 else if (c_auto_tag && shared->mailbox && (shared->mailbox->msg_tagged != 0))
1359 {
1360 priv->tag_prefix = true;
1361 }
1362
1364
1365 OptNews = false; /* for any case */
1366
1367#ifdef USE_NOTMUCH
1368 nm_db_debug_check(shared->mailbox);
1369#endif
1370
1371 rc = index_function_dispatcher(priv->win_index, &event);
1372
1373 if (rc == FR_UNKNOWN)
1374 rc = menu_function_dispatcher(priv->win_index, &event);
1375
1376 if (rc == FR_UNKNOWN)
1377 {
1378 struct MuttWindow *win_sidebar = window_find_child(dlg, WT_SIDEBAR);
1379 rc = sb_function_dispatcher(win_sidebar, &event);
1380 }
1381 if (rc == FR_UNKNOWN)
1382 rc = global_function_dispatcher(priv->menu->win, &event);
1383
1384 if (rc == FR_UNKNOWN)
1386
1387#ifdef USE_NOTMUCH
1388 nm_db_debug_check(shared->mailbox);
1389#endif
1390 } while (rc != FR_DONE);
1391
1392 mview_free(&shared->mailbox_view);
1393 window_set_focus(old_focus);
1394
1395 return shared->mailbox;
1396}
1397
1406void email_set_color(struct Mailbox *m, struct Email *e)
1407{
1408 if (!e)
1409 return;
1410
1411 struct RegexColor *color = NULL;
1412 struct PatternCache cache = { 0 };
1413
1414 const struct AttrColor *ac_merge = NULL;
1416 {
1418 MUTT_MATCH_FULL_ADDRESS, m, e, &cache))
1419 {
1420 ac_merge = merged_color_overlay(ac_merge, &color->attr_color);
1421 }
1422 }
1423
1424 struct AttrColor *ac_normal = simple_color_get(MT_COLOR_NORMAL);
1425 if (ac_merge)
1426 ac_merge = merged_color_overlay(ac_normal, ac_merge);
1427 else
1428 ac_merge = ac_normal;
1429
1430 e->attr_color = ac_merge;
1431}
1432
1438{
1442
1443 struct IndexSharedData *shared = index_shared_data_new();
1444 notify_set_parent(shared->notify, dlg->notify);
1445
1446 dlg->wdata = shared;
1448
1449 const bool c_status_on_top = cs_subset_bool(NeoMutt->sub, "status_on_top");
1450
1451 struct MuttWindow *panel_index = ipanel_new(c_status_on_top, shared);
1452 struct MuttWindow *panel_pager = ppanel_new(c_status_on_top, shared);
1453
1454 mutt_window_add_child(dlg, panel_index);
1455 mutt_window_add_child(dlg, panel_pager);
1456
1457 return dlg;
1458}
1459
1465void index_change_folder(struct MuttWindow *dlg, struct Mailbox *m)
1466{
1467 if (!dlg || !m)
1468 return;
1469
1470 struct IndexSharedData *shared = dlg->wdata;
1471 if (!shared)
1472 return;
1473
1474 struct MuttWindow *panel_index = window_find_child(dlg, WT_INDEX);
1475 if (!panel_index)
1476 return;
1477
1478 struct IndexPrivateData *priv = panel_index->wdata;
1479 if (!priv)
1480 return;
1481
1482 change_folder_mailbox(priv->menu, m, &priv->oldcount, shared, false);
1483}
bool buf_is_empty(const struct Buffer *buf)
Is the Buffer empty?
Definition buffer.c:291
static const char * buf_string(const struct Buffer *buf)
Convert a buffer to a const char * "string".
Definition buffer.h:96
Color and attribute parsing.
struct RegexColorList * regex_colors_get_list(enum ColorId cid)
Return the RegexColorList for a Colour ID.
Definition regex.c:205
struct AttrColor * simple_color_get(enum ColorId cid)
Get the colour of an object by its ID.
Definition simple.c:95
@ MT_COLOR_STATUS
Status bar (takes a pattern)
Definition color.h:78
@ MT_COLOR_NORMAL
Plain text.
Definition color.h:53
@ MT_COLOR_INDEX
Index: default colour.
Definition color.h:86
void mutt_pattern_free(struct PatternList **pat)
Free a Pattern.
Definition compile.c:826
const char * cs_subset_string(const struct ConfigSubset *sub, const char *name)
Get a string config item by name.
Definition helpers.c:291
bool cs_subset_bool(const struct ConfigSubset *sub, const char *name)
Get a boolean config item by name.
Definition helpers.c:47
short cs_subset_sort(const struct ConfigSubset *sub, const char *name)
Get a sort config item by name.
Definition helpers.c:266
const struct Expando * cs_subset_expando(const struct ConfigSubset *sub, const char *name)
Get an Expando config item by name.
Convenience wrapper for the config headers.
#define SORT_MASK
Mask for the sort id.
Definition sort.h:39
#define SORT_REVERSE
Reverse the order of the sort.
Definition sort.h:40
Connection Library.
Convenience wrapper for the core headers.
void mailbox_gc_run(void)
Run the garbage-collection.
Definition mailbox.c:311
void mailbox_free(struct Mailbox **ptr)
Free a Mailbox.
Definition mailbox.c:90
struct Mailbox * mailbox_find_name(const char *name)
Find the mailbox with a given name.
Definition mailbox.c:187
@ NT_MAILBOX_DELETE
Mailbox is about to be deleted.
Definition mailbox.h:173
static const char * mailbox_path(const struct Mailbox *m)
Get the Mailbox's path string.
Definition mailbox.h:213
uint16_t AclFlags
ACL Rights - These show permission to...
Definition mailbox.h:58
MailboxType
Supported mailbox formats.
Definition mailbox.h:40
@ MUTT_MAILBOX_ERROR
Error occurred examining Mailbox.
Definition mailbox.h:42
@ MUTT_NNTP
'NNTP' (Usenet) Mailbox type
Definition mailbox.h:48
@ MUTT_UNKNOWN
Mailbox wasn't recognised.
Definition mailbox.h:43
size_t mutt_wstr_trunc(const char *src, size_t maxlen, size_t maxwid, size_t *width)
Work out how to truncate a widechar string.
Definition curs_lib.c:384
void mutt_paddstr(struct MuttWindow *win, int n, const char *s)
Display a string on screen, padded if necessary.
Definition curs_lib.c:342
void mutt_refresh(void)
Force a refresh of the screen.
Definition curs_lib.c:78
void mutt_beep(bool force)
Irritate the user.
Definition curs_lib.c:68
size_t mutt_strwidth(const char *s)
Measure a string's width in screen cells.
Definition curs_lib.c:444
@ FR_DONE
Exit the Dialog.
Definition dispatcher.h:36
@ FR_UNKNOWN
Unknown function.
Definition dispatcher.h:34
bool check_acl(struct Mailbox *m, AclFlags acl, const char *msg)
Check the ACLs for a function.
Definition dlg_index.c:135
const struct Mapping IndexNewsHelp[]
Help Bar for the News Index dialog.
Definition dlg_index.c:114
void change_folder_mailbox(struct Menu *menu, struct Mailbox *m, int *oldcount, struct IndexSharedData *shared, bool read_only)
Change to a different Mailbox by pointer.
Definition dlg_index.c:610
struct Mailbox * change_folder_notmuch(struct Menu *menu, char *buf, int buflen, int *oldcount, struct IndexSharedData *shared, bool read_only)
Change to a different Notmuch Mailbox by string.
Definition dlg_index.c:731
void mutt_draw_statusline(struct MuttWindow *win, int max_cols, const char *buf, size_t buflen)
Draw a highlighted status bar.
Definition dlg_index.c:958
void email_set_color(struct Mailbox *m, struct Email *e)
Select an Index colour for an Email.
Definition dlg_index.c:1406
void update_index(struct Menu *menu, struct MailboxView *mv, enum MxStatus check, int oldcount, const struct IndexSharedData *shared)
Update the index.
Definition dlg_index.c:541
void index_change_folder(struct MuttWindow *dlg, struct Mailbox *m)
Change the current folder, cautiously.
Definition dlg_index.c:1465
int find_first_message(struct MailboxView *mv)
Get index of first new message.
Definition dlg_index.c:306
static const struct Mapping IndexHelp[]
Help Bar for the Index dialog.
Definition dlg_index.c:99
static void update_index_threaded(struct MailboxView *mv, enum MxStatus check, int oldcount)
Update the index (if threaded)
Definition dlg_index.c:408
void resort_index(struct MailboxView *mv, struct Menu *menu)
Resort the index.
Definition dlg_index.c:366
int find_next_undeleted(struct MailboxView *mv, int msgno, bool uncollapse)
Find the next undeleted email.
Definition dlg_index.c:238
static void update_index_unthreaded(struct MailboxView *mv, enum MxStatus check)
Update the index (if unthreaded)
Definition dlg_index.c:492
void collapse_all(struct MailboxView *mv, struct Menu *menu, int toggle)
Collapse/uncollapse all threads.
Definition dlg_index.c:162
void change_folder_string(struct Menu *menu, struct Buffer *buf, int *oldcount, struct IndexSharedData *shared, bool read_only)
Change to a different Mailbox by string.
Definition dlg_index.c:756
int mutt_make_string(struct Buffer *buf, size_t max_cols, const struct Expando *exp, struct Mailbox *m, int inpgr, struct Email *e, MuttFormatFlags flags, const char *progress)
Create formatted strings using mailbox expandos.
Definition dlg_index.c:802
int find_previous_undeleted(struct MailboxView *mv, int msgno, bool uncollapse)
Find the previous undeleted email.
Definition dlg_index.c:272
struct MuttWindow * index_pager_init(void)
Allocate the Windows for the Index/Pager.
Definition dlg_index.c:1437
static void uncollapse_thread(struct MailboxView *mv, int index)
Open a collapsed thread.
Definition dlg_index.c:216
Structs that make up an email.
void mutt_sort_headers(struct MailboxView *mv, bool init)
Sort emails by their headers.
Definition sort.c:354
bool OptNeedResort
(pseudo) used to force a re-sort
Definition globals.c:52
EmailSortType
Methods for sorting Emails.
Definition sort.h:53
@ EMAIL_SORT_THREADS
Sort by email threads.
Definition sort.h:62
int expando_filter(const struct Expando *exp, const struct ExpandoRenderCallback *erc, void *data, MuttFormatFlags flags, int max_cols, char **env_list, struct Buffer *buf)
Render an Expando and run the result through a filter.
Definition filter.c:139
Parse Expando string.
const struct ExpandoRenderCallback IndexRenderCallbacks[]
Callbacks for Index Expandos.
String processing routines to generate the mail index.
struct KeyEvent km_dokey(const struct MenuDefinition *md, GetChFlags flags)
Determine what a keypress should do.
Definition get.c:434
void km_error_key(const struct MenuDefinition *md)
Handle an unbound key sequence.
Definition get.c:285
void mutt_flush_macro_to_endcond(void)
Drop a macro from the input buffer.
Definition get.c:157
#define GETCH_NO_FLAGS
No flags are set.
Definition get.h:34
bool OptNews
(pseudo) used to change reader mode
Definition globals.c:53
char * LastFolder
Previously selected mailbox.
Definition globals.c:39
char * CurrentFolder
Currently selected mailbox.
Definition globals.c:38
Global variables.
int sb_function_dispatcher(struct MuttWindow *win, const struct KeyEvent *event)
Perform a Sidebar function - Implements function_dispatcher_t -.
Definition functions.c:430
int index_function_dispatcher(struct MuttWindow *win, const struct KeyEvent *event)
Perform an Index function - Implements function_dispatcher_t -.
Definition functions.c:3334
int global_function_dispatcher(struct MuttWindow *win, const struct KeyEvent *event)
Perform a Global function - Implements function_dispatcher_t -.
Definition global.c:182
int menu_function_dispatcher(struct MuttWindow *win, const struct KeyEvent *event)
Perform a Menu function - Implements function_dispatcher_t -.
Definition functions.c:320
struct Mailbox * dlg_index(struct MuttWindow *dlg, struct Mailbox *m_init)
Display a list of emails -.
Definition dlg_index.c:1099
#define mutt_error(...)
Definition logging2.h:94
#define mutt_message(...)
Definition logging2.h:93
#define mutt_debug(LEVEL,...)
Definition logging2.h:91
const struct AttrColor * index_color(struct Menu *menu, int line)
Calculate the colour for a line of the index - Implements Menu::color() -.
Definition dlg_index.c:926
int index_make_entry(struct Menu *menu, int line, int max_cols, struct Buffer *buf)
Format an Email for the Menu - Implements Menu::make_entry() -.
Definition dlg_index.c:825
static int index_mailbox_observer(struct NotifyCallback *nc)
Notification that a Mailbox has changed - Implements observer_t -.
Definition dlg_index.c:584
void index_shared_data_free(struct MuttWindow *win, void **ptr)
Free Shared Index Data - Implements MuttWindow::wdata_free() -.
Convenience wrapper for the gui headers.
void mutt_thread_collapse(struct ThreadsContext *tctx, bool collapse)
Toggle collapse.
Definition thread.c:1787
enum UseThreads mutt_thread_style(void)
Which threading style is active?
Definition thread.c:79
off_t mutt_set_vnum(struct Mailbox *m)
Set the virtual index number of all the messages in a mailbox.
Definition thread.c:1402
bool mutt_thread_can_collapse(struct Email *e)
Check whether a thread can be collapsed.
Definition thread.c:1815
int mutt_parent_message(struct Email *e, bool find_root)
Find the parent of a message.
Definition thread.c:1352
UseThreads
Which threading style is active, $use_threads.
Definition thread.h:96
@ UT_FLAT
Unthreaded.
Definition thread.h:98
@ UT_THREADS
Normal threading (root above subthreads)
Definition thread.h:99
@ UT_REVERSE
Reverse threading (subthreads above root)
Definition thread.h:100
#define mutt_using_threads()
Definition thread.h:113
#define mutt_uncollapse_thread(e)
Definition thread.h:107
#define mutt_collapse_thread(e)
Definition thread.h:106
void exec_folder_hook(const char *path, const char *desc)
Perform a folder hook.
Definition exec.c:64
Hook Commands.
struct MenuDefinition * MdIndex
Index Menu Definition.
Definition functions.c:80
Index functions.
GUI manage the main index (list of emails)
Private Index Functions.
Private state data for the Index.
void index_shared_data_set_email(struct IndexSharedData *shared, struct Email *e)
Set the current Email for the Index and friends.
bool index_shared_data_is_cur_email(const struct IndexSharedData *shared, const struct Email *e)
Check whether an email is the currently selected Email.
struct IndexSharedData * index_shared_data_new(void)
Create new Index Data.
void index_shared_data_set_mview(struct IndexSharedData *shared, struct MailboxView *mv)
Set the MailboxView for the Index and friends.
Data shared between Index, Pager and Sidebar.
void index_adjust_sort_threads(const struct ConfigSubset *sub)
Adjust use_threads/sort/sort_aux.
Definition index.c:184
struct MuttWindow * ipanel_new(bool status_on_top, struct IndexSharedData *shared)
Create the Windows for the Index panel.
Definition ipanel.c:121
Manage keymappings.
@ LL_DEBUG5
Log at debug level 5.
Definition logging2.h:49
@ LL_DEBUG1
Log at debug level 1.
Definition logging2.h:45
#define FREE(x)
Free memory and set the pointer to NULL.
Definition memory.h:68
#define MIN(a, b)
Return the minimum of two values.
Definition memory.h:40
#define MUTT_MEM_REALLOC(pptr, n, type)
Definition memory.h:55
#define MUTT_MEM_MALLOC(n, type)
Definition memory.h:53
#define MAX(a, b)
Return the maximum of two values.
Definition memory.h:38
GUI present the user with a selectable list.
#define MENU_REDRAW_FULL
Redraw everything.
Definition lib.h:60
#define MENU_REDRAW_INDEX
Redraw the index.
Definition lib.h:57
void menu_queue_redraw(struct Menu *menu, MenuRedrawFlags redraw)
Queue a request for a redraw.
Definition menu.c:188
int menu_get_index(struct Menu *menu)
Get the current selection in the Menu.
Definition menu.c:164
MenuRedrawFlags menu_set_index(struct Menu *menu, int index)
Set the current selection in the Menu.
Definition menu.c:178
const struct AttrColor * merged_color_overlay(const struct AttrColor *base, const struct AttrColor *over)
Combine two colours.
Definition merged.c:107
int mutt_monitor_add(struct Mailbox *m)
Add a watch for a mailbox.
Definition monitor.c:484
int mutt_monitor_remove(struct Mailbox *m)
Remove a watch for a mailbox.
Definition monitor.c:528
Monitor files for changes.
void msgwin_clear_text(struct MuttWindow *win)
Clear the text in the Message Window.
Definition msgwin.c:518
void msgwin_set_text(struct MuttWindow *win, const char *text, enum ColorId color)
Set the text for the Message Window.
Definition msgwin.c:483
Convenience wrapper for the library headers.
#define N_(a)
Definition message.h:32
#define _(a)
Definition message.h:28
bool notify_observer_remove(struct Notify *notify, const observer_t callback, const void *global_data)
Remove an observer from an object.
Definition notify.c:230
bool notify_observer_add(struct Notify *notify, enum NotifyType type, observer_t callback, void *global_data)
Add an observer to an object.
Definition notify.c:191
void notify_set_parent(struct Notify *notify, struct Notify *parent)
Set the parent notification handler.
Definition notify.c:95
char * mutt_str_dup(const char *str)
Copy a string, safely.
Definition string.c:257
char * mutt_str_replace(char **p, const char *s)
Replace one string with another.
Definition string.c:284
Many unsorted constants and some structs.
int mutt_system(const char *cmd)
Run an external command.
Definition system.c:51
void mutt_curses_set_color(const struct AttrColor *ac)
Set the colour and attributes for text.
Definition mutt_curses.c:38
void mutt_clear_error(void)
Clear the message line (bottom line of screen)
NeoMutt Logging.
int mutt_mailbox_check(struct Mailbox *m_cur, CheckStatsFlags flags)
Check all all Mailboxes for new mail.
bool mutt_mailbox_notify(struct Mailbox *m_cur)
Notify the user if there's new mail.
Mailbox helper functions.
void window_redraw(struct MuttWindow *win)
Reflow, recalc and repaint a tree of Windows.
void mutt_window_reflow(struct MuttWindow *win)
Resize a Window and its children.
void mutt_window_add_child(struct MuttWindow *parent, struct MuttWindow *child)
Add a child to Window.
struct MuttWindow * mutt_window_new(enum WindowType type, enum MuttWindowOrientation orient, enum MuttWindowSize size, int cols, int rows)
Create a new Window.
struct MuttWindow * window_set_focus(struct MuttWindow *win)
Set the Window focus.
int mutt_window_move(struct MuttWindow *win, int row, int col)
Move the cursor in a Window.
struct MuttWindow * window_find_child(struct MuttWindow *win, enum WindowType type)
Recursively find a child Window of a given type.
int mutt_window_addnstr(struct MuttWindow *win, const char *str, int num)
Write a partial string to a Window.
@ WT_DLG_INDEX
Index Dialog, dlg_index()
Definition mutt_window.h:86
@ WT_INDEX
A panel containing the Index Window.
Definition mutt_window.h:96
@ WT_SIDEBAR
Side panel containing Accounts or groups of data.
@ WT_MENU
An Window containing a Menu.
Definition mutt_window.h:97
@ MUTT_WIN_ORIENT_HORIZONTAL
Window uses all available horizontal space.
Definition mutt_window.h:39
#define MUTT_WIN_SIZE_UNLIMITED
Use as much space as possible.
Definition mutt_window.h:52
@ MUTT_WIN_SIZE_MAXIMISE
Window wants as much space as possible.
Definition mutt_window.h:48
struct Email * mutt_get_virt_email(struct Mailbox *m, int vnum)
Get a virtual Email.
Definition mview.c:415
void mview_free(struct MailboxView **ptr)
Free a MailboxView.
Definition mview.c:47
bool mview_has_limit(const struct MailboxView *mv)
Is a limit active?
Definition mview.c:436
struct MailboxView * mview_new(struct Mailbox *m, struct Notify *parent)
Create a new MailboxView.
Definition mview.c:88
int mx_msg_padding_size(struct Mailbox *m)
Bytes of padding between messages - Wrapper for MxOps::msg_padding_size()
Definition mx.c:1507
int mx_path_canon(struct Buffer *path, const char *folder, enum MailboxType *type)
Canonicalise a mailbox path - Wrapper for MxOps::path_canon()
Definition mx.c:1369
bool mx_mbox_open(struct Mailbox *m, OpenMailboxFlags flags)
Open a mailbox and parse it.
Definition mx.c:285
enum MailboxType mx_path_probe(const char *path)
Find a mailbox that understands a path.
Definition mx.c:1323
struct Mailbox * mx_path_resolve(const char *path)
Get a Mailbox for a path.
Definition mx.c:1647
enum MxStatus mx_mbox_check(struct Mailbox *m)
Check for new mail - Wrapper for MxOps::mbox_check()
Definition mx.c:1107
enum MxStatus mx_mbox_close(struct Mailbox *m)
Save changes and close mailbox.
Definition mx.c:595
API for mailboxes.
#define MUTT_READONLY
Open in read-only mode.
Definition mxapi.h:42
uint8_t OpenMailboxFlags
Flags for mutt_open_mailbox(), e.g. MUTT_NOSORT.
Definition mxapi.h:38
#define MUTT_MAILBOX_CHECK_NO_FLAGS
No flags are set.
Definition mxapi.h:49
#define MUTT_OPEN_NO_FLAGS
No flags are set.
Definition mxapi.h:39
#define MUTT_MAILBOX_CHECK_POSTPONED
Make sure the number of postponed messages is updated.
Definition mxapi.h:50
MxStatus
Return values from mbox_check(), mbox_check_stats(), mbox_sync(), and mbox_close()
Definition mxapi.h:59
@ MX_STATUS_ERROR
An error occurred.
Definition mxapi.h:60
@ MX_STATUS_OK
No changes.
Definition mxapi.h:61
@ MX_STATUS_FLAGS
Nondestructive flags change (IMAP)
Definition mxapi.h:65
@ MX_STATUS_REOPENED
Mailbox was reopened.
Definition mxapi.h:64
@ MX_STATUS_NEW_MAIL
New mail received in Mailbox.
Definition mxapi.h:62
Nntp-specific Account data.
Usenet network mailbox type; talk to an NNTP server.
void nntp_expand_path(char *buf, size_t buflen, struct ConnAccount *acct)
Make fully qualified url from newsgroup name.
Definition newsrc.c:555
struct NntpAccountData * CurrentNewsSrv
Current NNTP news server.
Definition nntp.c:74
@ NT_MAILBOX
Mailbox has changed, NotifyMailbox, EventMailbox.
Definition notify_type.h:49
void nm_db_debug_check(struct Mailbox *m)
Check if the database is open.
Definition db.c:397
Notmuch virtual mailbox type.
char * nm_url_from_query(struct Mailbox *m, char *buf, size_t buflen)
Turn a query into a URL.
Definition notmuch.c:1615
const char * opcodes_get_name(int op)
Get the name of an opcode.
Definition opcodes.c:48
#define OP_TIMEOUT
1 second with no events
Definition opcodes.h:35
#define OP_REPAINT
Repaint is needed.
Definition opcodes.h:34
GUI display a file/email/help in a viewport with paging.
struct MuttWindow * ppanel_new(bool status_on_top, struct IndexSharedData *shared)
Create the Windows for the Pager panel.
Definition ppanel.c:133
bool mutt_pattern_exec(struct Pattern *pat, PatternExecFlags flags, struct Mailbox *m, struct Email *e, struct PatternCache *cache)
Match a pattern against an email header.
Definition exec.c:1146
Match patterns to emails.
#define MUTT_MATCH_FULL_ADDRESS
Match the full address.
Definition lib.h:107
struct Buffer * buf_pool_get(void)
Get a Buffer from the pool.
Definition pool.c:91
void buf_pool_release(struct Buffer **ptr)
Return a Buffer to the pool.
Definition pool.c:111
#define STAILQ_FOREACH(var, head, field)
Definition queue.h:390
#define SLIST_FIRST(head)
Definition queue.h:227
#define MUTT_FORMAT_FORCESUBJ
Print the subject even if unchanged.
Definition render.h:34
#define MUTT_FORMAT_INDEX
This is a main index entry.
Definition render.h:38
#define MUTT_FORMAT_TREE
Draw the thread tree.
Definition render.h:35
#define MUTT_FORMAT_ARROWCURSOR
Reserve space for arrow_cursor.
Definition render.h:37
uint8_t MuttFormatFlags
Flags for expando_render(), e.g. MUTT_FORMAT_FORCESUBJ.
Definition render.h:32
GUI display the mailboxes in a side panel.
#define ASSERT(COND)
Definition signal2.h:59
void menu_status_line(struct Buffer *buf, struct IndexSharedData *shared, struct Menu *menu, int max_cols, const struct Expando *exp)
Create the status line.
Definition status.c:51
GUI display a user-configurable status line.
A curses colour and its attributes.
Definition attr.h:65
The body of an email.
Definition body.h:36
LOFF_T offset
offset where the actual data begins
Definition body.h:52
LOFF_T length
length (in bytes) of attachment
Definition body.h:53
long hdr_offset
Offset in stream where the headers begin.
Definition body.h:81
String manipulation buffer.
Definition buffer.h:36
size_t dsize
Length of data.
Definition buffer.h:39
char * data
Pointer to data.
Definition buffer.h:37
Data passed to index_format_str()
Definition private.h:37
struct Email * email
Current Email.
Definition private.h:40
struct Mailbox * mailbox
Current Mailbox.
Definition private.h:38
int msg_in_pager
Index of Email displayed in the Pager.
Definition private.h:39
const char * pager_progress
String representing Pager position through Email.
Definition private.h:41
The envelope/body of an email.
Definition email.h:39
bool read
Email is read.
Definition email.h:50
bool display_subject
Used for threading.
Definition email.h:101
bool visible
Is this message part of the view?
Definition email.h:121
bool limit_visited
Has the limit pattern been applied to this message?
Definition email.h:122
bool collapsed
Is this message part of a collapsed thread?
Definition email.h:120
struct Body * body
List of MIME parts.
Definition email.h:69
char * tree
Character string to print thread tree.
Definition email.h:125
bool old
Email is seen, but unread.
Definition email.h:49
LOFF_T offset
Where in the stream does this message begin?
Definition email.h:71
const struct AttrColor * attr_color
Color-pair to use when displaying in the index.
Definition email.h:112
int vnum
Virtual message number.
Definition email.h:114
int msgno
Number displayed to the user.
Definition email.h:111
bool deleted
Email is deleted.
Definition email.h:78
int index
The absolute (unsorted) message number.
Definition email.h:110
struct MuttThread * thread
Thread of Emails.
Definition email.h:119
An Event that happened to a Mailbox.
Definition mailbox.h:189
struct Mailbox * mailbox
The Mailbox this Event relates to.
Definition mailbox.h:190
Parsed Expando trees.
Definition expando.h:41
Private state data for the Index.
struct MuttWindow * win_index
Window for the Index.
struct IndexSharedData * shared
Shared Index data.
bool tag_prefix
tag-prefix has been pressed
bool do_mailbox_notify
Do we need to notify the user of new mail?
struct Menu * menu
Menu controlling the index.
int oldcount
Old count of mails in the mailbox.
Data shared between Index, Pager and Sidebar.
Definition shared_data.h:37
struct Mailbox * mailbox
Current Mailbox.
Definition shared_data.h:41
bool attach_msg
Are we in "attach message" mode?
Definition shared_data.h:46
struct ConfigSubset * sub
Config set to use.
Definition shared_data.h:38
struct MailboxView * mailbox_view
Current Mailbox view.
Definition shared_data.h:40
struct SearchState * search_state
State of the current search.
Definition shared_data.h:45
struct Notify * notify
Notifications: NotifyIndex, IndexSharedData.
Definition shared_data.h:44
An event such as a keypress.
Definition get.h:50
int op
Function opcode, e.g. OP_HELP.
Definition get.h:52
View of a Mailbox.
Definition mview.h:40
bool collapsed
Are all threads collapsed?
Definition mview.h:49
struct Menu * menu
Needed for pattern compilation.
Definition mview.h:47
off_t vsize
Size (in bytes) of the messages shown.
Definition mview.h:41
struct PatternList * limit_pattern
Compiled limit pattern.
Definition mview.h:43
struct ThreadsContext * threads
Threads context.
Definition mview.h:44
int msg_in_pager
Message currently shown in the pager.
Definition mview.h:45
struct Mailbox * mailbox
Current Mailbox.
Definition mview.h:51
A mailbox.
Definition mailbox.h:78
int vcount
The number of virtual messages.
Definition mailbox.h:98
char * realpath
Used for duplicate detection, context comparison, and the sidebar.
Definition mailbox.h:80
int * v2r
Mapping from virtual to real msgno.
Definition mailbox.h:97
int msg_count
Total number of messages.
Definition mailbox.h:87
AclFlags rights
ACL bits, see AclFlags.
Definition mailbox.h:118
int email_max
Size of emails array.
Definition mailbox.h:96
enum MailboxType type
Mailbox type.
Definition mailbox.h:101
struct Email ** emails
Array of Emails.
Definition mailbox.h:95
char * name
A short name for the Mailbox.
Definition mailbox.h:81
struct Notify * notify
Notifications: NotifyMailbox, EventMailbox.
Definition mailbox.h:144
struct Buffer pathbuf
Path of the Mailbox.
Definition mailbox.h:79
void * compress_info
Compressed mbox module private data.
Definition mailbox.h:120
int msg_tagged
How many messages are tagged?
Definition mailbox.h:93
bool verbose
Display status messages?
Definition mailbox.h:116
struct ConfigSubset * sub
Inherited config items.
Definition mailbox.h:82
Mapping between user-readable string and a constant.
Definition mapping.h:33
Definition lib.h:80
struct MuttWindow * win
Window holding the Menu.
Definition lib.h:88
int current
Current entry.
Definition lib.h:81
const struct AttrColor *(* color)(struct Menu *menu, int line)
Definition lib.h:145
int top
Entry that is the top of the current page.
Definition lib.h:92
int(* make_entry)(struct Menu *menu, int line, int max_cols, struct Buffer *buf)
Definition lib.h:108
struct ConfigSubset * sub
Inherited config items.
Definition lib.h:89
void * mdata
Private data.
Definition lib.h:149
int max
Number of entries in the menu.
Definition lib.h:82
int page_len
Number of entries per screen.
Definition lib.h:85
An Email conversation.
Definition thread.h:34
struct MuttThread * parent
Parent of this Thread.
Definition thread.h:44
struct MuttThread * prev
Previous sibling Thread.
Definition thread.h:47
struct Email * message
Email this Thread refers to.
Definition thread.h:49
const struct Mapping * help_data
Data for the Help Bar.
const struct MenuDefinition * help_md
Menu Definition for key bindings.
struct WindowState state
Current state of the Window.
void * wdata
Private data.
struct Notify * notify
Notifications: NotifyWindow, EventWindow.
void(* wdata_free)(struct MuttWindow *win, void **ptr)
Container for Accounts, Notifications.
Definition neomutt.h:41
char ** env
Private copy of the environment variables.
Definition neomutt.h:58
struct Notify * notify
Notifications handler.
Definition neomutt.h:45
struct ConfigSubset * sub
Inherited config items.
Definition neomutt.h:49
Data passed to a notification function.
Definition observer.h:34
enum NotifyType event_type
Send: Event type, e.g. NT_ACCOUNT.
Definition observer.h:36
int event_subtype
Send: Event subtype, e.g. NT_ACCOUNT_ADD.
Definition observer.h:37
void * global_data
Data from notify_observer_add()
Definition observer.h:39
Cache commonly-used patterns.
Definition lib.h:118
A regular expression and a color to highlight a line.
Definition regex4.h:35
regex_t regex
Compiled regex.
Definition regex4.h:38
struct PatternList * color_pattern
Compiled pattern to speed up index color calculation.
Definition regex4.h:40
struct AttrColor attr_color
Colour and attributes to apply.
Definition regex4.h:36
int match
Substring to match, 0 for old behaviour.
Definition regex4.h:39
struct PatternList * pattern
compiled search pattern
short cols
Number of columns, can be MUTT_WIN_SIZE_UNLIMITED.
Definition mutt_window.h:60