NeoMutt  2025-12-11-177-g48e272
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
438 if ((e->limit_visited && e->visible) ||
440 MUTT_MATCH_FULL_ADDRESS, m, e, NULL))
441 {
442 /* vnum will get properly set by mutt_set_vnum(), which
443 * is called by mutt_sort_headers() just below. */
444 e->vnum = 1;
445 e->visible = true;
446 }
447 else
448 {
449 e->vnum = -1;
450 e->visible = false;
451 }
452
453 // mark email as visited so we don't re-apply the pattern next time
454 e->limit_visited = true;
455 }
456 /* Need a second sort to set virtual numbers and redraw the tree */
457 mutt_sort_headers(mv, false);
458 }
459
460 /* uncollapse threads with new mail */
461 if (c_uncollapse_new)
462 {
463 if (check == MX_STATUS_REOPENED)
464 {
465 mv->collapsed = false;
467 mutt_set_vnum(m);
468 }
469 else if (oldcount > 0)
470 {
471 for (int j = 0; j < num_new; j++)
472 {
473 if (save_new[j]->visible)
474 {
475 mutt_uncollapse_thread(save_new[j]);
476 }
477 }
478 mutt_set_vnum(m);
479 }
480 }
481
482 FREE(&save_new);
483}
484
490static void update_index_unthreaded(struct MailboxView *mv, enum MxStatus check)
491{
492 /* We are in a limited view. Check if the new message(s) satisfy
493 * the limit criteria. If they do, set their virtual msgno so that
494 * they will be visible in the limited view */
495 if (mview_has_limit(mv))
496 {
497 int padding = mx_msg_padding_size(mv->mailbox);
498 mv->mailbox->vcount = mv->vsize = 0;
499 for (int i = 0; i < mv->mailbox->msg_count; i++)
500 {
501 struct Email *e = mv->mailbox->emails[i];
502 if (!e)
503 break;
504
505 if ((e->limit_visited && e->visible) ||
507 MUTT_MATCH_FULL_ADDRESS, mv->mailbox, e, NULL))
508 {
510 e->vnum = mv->mailbox->vcount;
511 mv->mailbox->v2r[mv->mailbox->vcount] = i;
512 e->visible = true;
513 mv->mailbox->vcount++;
514 struct Body *b = e->body;
515 mv->vsize += b->length + b->offset - b->hdr_offset + padding;
516 }
517 else
518 {
519 e->visible = false;
520 }
521
522 // mark email as visited so we don't re-apply the pattern next time
523 e->limit_visited = true;
524 }
525 }
526
527 /* if the mailbox was reopened, need to rethread from scratch */
529}
530
539void update_index(struct Menu *menu, struct MailboxView *mv, enum MxStatus check,
540 int oldcount, const struct IndexSharedData *shared)
541{
542 if (!menu || !mv)
543 return;
544
545 struct Mailbox *m = mv->mailbox;
546 if (mutt_using_threads())
547 update_index_threaded(mv, check, oldcount);
548 else
549 update_index_unthreaded(mv, check);
550
551 menu->max = m->vcount;
552 const int old_index = menu_get_index(menu);
553 int index = -1;
554 if (oldcount)
555 {
556 /* restore the current message to the message it was pointing to */
557 for (int i = 0; i < m->vcount; i++)
558 {
559 struct Email *e = mutt_get_virt_email(m, i);
560 if (!e)
561 continue;
562 if (index_shared_data_is_cur_email(shared, e))
563 {
564 index = i;
565 break;
566 }
567 }
568 }
569
570 if (index < 0)
571 {
572 index = (old_index < m->vcount) ? old_index : find_first_message(mv);
573 }
574 menu_set_index(menu, index);
575}
576
583{
584 if (nc->event_type != NT_MAILBOX)
585 return 0;
586 if (!nc->global_data)
587 return -1;
589 return 0;
590
591 struct Mailbox **ptr = nc->global_data;
592 if (!*ptr)
593 return 0;
594
595 *ptr = NULL;
596 mutt_debug(LL_DEBUG5, "mailbox done\n");
597 return 0;
598}
599
608void change_folder_mailbox(struct Menu *menu, struct Mailbox *m, int *oldcount,
609 struct IndexSharedData *shared, bool read_only)
610{
611 if (!m)
612 return;
613
614 /* keepalive failure in mutt_enter_fname may kill connection. */
615 if (shared->mailbox && (buf_is_empty(&shared->mailbox->pathbuf)))
616 {
617 mview_free(&shared->mailbox_view);
618 mailbox_free(&shared->mailbox);
619 }
620
621 if (shared->mailbox)
622 {
623 char *new_last_folder = NULL;
624#ifdef USE_INOTIFY
625 int monitor_remove_rc = mutt_monitor_remove(NULL);
626#endif
627 if (shared->mailbox->compress_info && (shared->mailbox->realpath[0] != '\0'))
628 new_last_folder = mutt_str_dup(shared->mailbox->realpath);
629 else
630 new_last_folder = mutt_str_dup(mailbox_path(shared->mailbox));
631 *oldcount = shared->mailbox->msg_count;
632
633 const enum MxStatus check = mx_mbox_close(shared->mailbox);
634 if (check == MX_STATUS_OK)
635 {
636 mview_free(&shared->mailbox_view);
637 if (shared->mailbox != m)
638 {
639 mailbox_free(&shared->mailbox);
640 }
641 }
642 else
643 {
644#ifdef USE_INOTIFY
645 if (monitor_remove_rc == 0)
646 mutt_monitor_add(NULL);
647#endif
648 if ((check == MX_STATUS_NEW_MAIL) || (check == MX_STATUS_REOPENED))
649 update_index(menu, shared->mailbox_view, check, *oldcount, shared);
650
651 FREE(&new_last_folder);
654 return;
655 }
657 LastFolder = new_last_folder;
658 }
660
661 /* If the `folder-hook` were to call `unmailboxes`, then the Mailbox (`m`)
662 * could be deleted, leaving `m` dangling. */
663 // TODO: Refactor this function to avoid the need for an observer
665 char *dup_path = mutt_str_dup(mailbox_path(m));
666 char *dup_name = mutt_str_dup(m->name);
667
668 mutt_folder_hook(dup_path, dup_name);
669 if (m)
670 {
671 /* `m` is still valid, but we won't need the observer again before the end
672 * of the function. */
674 }
675 else
676 {
677 // Recreate the Mailbox as the folder-hook might have invoked `mailboxes`
678 // and/or `unmailboxes`.
679 m = mx_path_resolve(dup_path);
680 }
681
682 FREE(&dup_path);
683 FREE(&dup_name);
684
685 if (!m)
686 return;
687
688 const OpenMailboxFlags flags = read_only ? MUTT_READONLY : MUTT_OPEN_NO_FLAGS;
689 if (mx_mbox_open(m, flags))
690 {
691 struct MailboxView *mv = mview_new(m, NeoMutt->notify);
692 index_shared_data_set_mview(shared, mv);
693
694 menu->max = m->msg_count;
696#ifdef USE_INOTIFY
697 mutt_monitor_add(NULL);
698#endif
699 }
700 else
701 {
702 index_shared_data_set_mview(shared, NULL);
704 }
705
706 const bool c_collapse_all = cs_subset_bool(shared->sub, "collapse_all");
707 if (mutt_using_threads() && c_collapse_all)
708 collapse_all(shared->mailbox_view, menu, 0);
709
711 /* force the mailbox check after we have changed the folder */
712 struct EventMailbox ev_m = { shared->mailbox };
716}
717
718#ifdef USE_NOTMUCH
729struct Mailbox *change_folder_notmuch(struct Menu *menu, char *buf, int buflen, int *oldcount,
730 struct IndexSharedData *shared, bool read_only)
731{
732 if (!nm_url_from_query(NULL, buf, buflen))
733 {
734 mutt_message(_("Failed to create query, aborting"));
735 return NULL;
736 }
737
738 struct Mailbox *m_query = mx_path_resolve(buf);
739 change_folder_mailbox(menu, m_query, oldcount, shared, read_only);
740 if (!shared->mailbox_view)
741 mailbox_free(&m_query);
742 return m_query;
743}
744#endif
745
754void change_folder_string(struct Menu *menu, struct Buffer *buf, int *oldcount,
755 struct IndexSharedData *shared, bool read_only)
756{
757 if (OptNews)
758 {
759 OptNews = false;
760 nntp_expand_path(buf->data, buf->dsize, &CurrentNewsSrv->conn->account);
761 }
762 else
763 {
764 const char *const c_folder = cs_subset_string(shared->sub, "folder");
765 mx_path_canon(buf, c_folder, NULL);
766 }
767
769 if ((type == MUTT_MAILBOX_ERROR) || (type == MUTT_UNKNOWN))
770 {
771 // Look for a Mailbox by its description, before failing
772 struct Mailbox *m = mailbox_find_name(buf_string(buf));
773 if (m)
774 {
775 change_folder_mailbox(menu, m, oldcount, shared, read_only);
776 }
777 else
778 {
779 mutt_error(_("%s is not a mailbox"), buf_string(buf));
780 }
781 return;
782 }
783
784 struct Mailbox *m = mx_path_resolve(buf_string(buf));
785 change_folder_mailbox(menu, m, oldcount, shared, read_only);
786}
787
800int mutt_make_string(struct Buffer *buf, size_t max_cols,
801 const struct Expando *exp, struct Mailbox *m, int inpgr,
802 struct Email *e, MuttFormatFlags flags, const char *progress)
803{
804 if (!exp)
805 return 0;
806
807 struct EmailFormatInfo efi = { 0 };
808
809 efi.email = e;
810 efi.mailbox = m;
811 efi.msg_in_pager = inpgr;
812 efi.pager_progress = progress;
813
814 return expando_filter(exp, IndexRenderCallbacks, &efi, flags, max_cols,
815 NeoMutt->env, buf);
816}
817
823int index_make_entry(struct Menu *menu, int line, int max_cols, struct Buffer *buf)
824{
825 if (!menu || !menu->mdata)
826 return 0;
827
828 struct IndexPrivateData *priv = menu->mdata;
829 struct IndexSharedData *shared = priv->shared;
830 struct Mailbox *m = shared->mailbox;
831 if (!shared->mailbox_view)
832 menu->current = -1;
833
834 if (!m || (line < 0) || (line >= m->email_max))
835 return 0;
836
837 struct Email *e = mutt_get_virt_email(m, line);
838 if (!e)
839 return 0;
840
842 struct MuttThread *tmp = NULL;
843
844 const enum UseThreads c_threads = mutt_thread_style();
845 if ((c_threads > UT_FLAT) && e->tree && e->thread)
846 {
847 flags |= MUTT_FORMAT_TREE; /* display the thread tree */
848 if (e->display_subject)
849 {
850 flags |= MUTT_FORMAT_FORCESUBJ;
851 }
852 else
853 {
854 const bool reverse = c_threads == UT_REVERSE;
855 int edgemsgno;
856 if (reverse)
857 {
858 if (menu->top + menu->page_len > menu->max)
859 edgemsgno = m->v2r[menu->max - 1];
860 else
861 edgemsgno = m->v2r[menu->top + menu->page_len - 1];
862 }
863 else
864 {
865 edgemsgno = m->v2r[menu->top];
866 }
867
868 for (tmp = e->thread->parent; tmp; tmp = tmp->parent)
869 {
870 if (!tmp->message)
871 continue;
872
873 /* if no ancestor is visible on current screen, provisionally force
874 * subject... */
875 if (reverse ? (tmp->message->msgno > edgemsgno) : (tmp->message->msgno < edgemsgno))
876 {
877 flags |= MUTT_FORMAT_FORCESUBJ;
878 break;
879 }
880 else if (tmp->message->vnum >= 0)
881 {
882 break;
883 }
884 }
885 if (flags & MUTT_FORMAT_FORCESUBJ)
886 {
887 for (tmp = e->thread->prev; tmp; tmp = tmp->prev)
888 {
889 if (!tmp->message)
890 continue;
891
892 /* ...but if a previous sibling is available, don't force it */
893 if (reverse ? (tmp->message->msgno > edgemsgno) : (tmp->message->msgno < edgemsgno))
894 {
895 break;
896 }
897 else if (tmp->message->vnum >= 0)
898 {
899 flags &= ~MUTT_FORMAT_FORCESUBJ;
900 break;
901 }
902 }
903 }
904 }
905 }
906
907 const struct Expando *c_index_format = cs_subset_expando(shared->sub, "index_format");
908 int msg_in_pager = shared->mailbox_view ? shared->mailbox_view->msg_in_pager : 0;
909
910 const bool c_arrow_cursor = cs_subset_bool(menu->sub, "arrow_cursor");
911 if (c_arrow_cursor)
912 {
913 const char *const c_arrow_string = cs_subset_string(menu->sub, "arrow_string");
914 if (max_cols > 0)
915 max_cols -= (mutt_strwidth(c_arrow_string) + 1);
916 }
917
918 return mutt_make_string(buf, max_cols, c_index_format, m, msg_in_pager, e, flags, NULL);
919}
920
924const struct AttrColor *index_color(struct Menu *menu, int line)
925{
926 struct IndexPrivateData *priv = menu->mdata;
927 struct IndexSharedData *shared = priv->shared;
928 struct Mailbox *m = shared->mailbox;
929 if (!m || (line < 0))
930 return NULL;
931
932 struct Email *e = mutt_get_virt_email(m, line);
933 if (!e)
934 return NULL;
935
936 if (e->attr_color)
937 return e->attr_color;
938
939 email_set_color(m, e);
940 return e->attr_color;
941}
942
956void mutt_draw_statusline(struct MuttWindow *win, int max_cols, const char *buf, size_t buflen)
957{
958 if (!buf || !stdscr)
959 return;
960
961 size_t i = 0;
962 size_t offset = 0;
963 bool found = false;
964 size_t chunks = 0;
965 size_t len = 0;
966
970 struct StatusSyntax
971 {
972 const struct AttrColor *attr_color;
973 int first;
974 int last;
975 } *syntax = NULL;
976
979 do
980 {
981 struct RegexColor *cl = NULL;
982 found = false;
983
984 if (!buf[offset])
985 break;
986
987 /* loop through each "color status regex" */
989 {
990 regmatch_t pmatch[cl->match + 1];
991 memset(pmatch, 0, (cl->match + 1) * sizeof(regmatch_t));
992
993 if (regexec(&cl->regex, buf + offset, cl->match + 1, pmatch, 0) != 0)
994 continue; /* regex doesn't match the status bar */
995
996 int first = pmatch[cl->match].rm_so + offset;
997 int last = pmatch[cl->match].rm_eo + offset;
998
999 if (first == last)
1000 continue; /* ignore an empty regex */
1001
1002 if (!found)
1003 {
1004 chunks++;
1005 MUTT_MEM_REALLOC(&syntax, chunks, struct StatusSyntax);
1006 }
1007
1008 i = chunks - 1;
1009 if (!found || (first < syntax[i].first) ||
1010 ((first == syntax[i].first) && (last > syntax[i].last)))
1011 {
1012 const struct AttrColor *ac_merge = merged_color_overlay(ac_base, &cl->attr_color);
1013
1014 syntax[i].attr_color = ac_merge;
1015 syntax[i].first = first;
1016 syntax[i].last = last;
1017 }
1018 found = true;
1019 }
1020
1021 if (syntax)
1022 {
1023 offset = syntax[i].last;
1024 }
1025 } while (found);
1026
1027 /* Only 'len' bytes will fit into 'max_cols' screen columns */
1028 len = mutt_wstr_trunc(buf, buflen, max_cols, NULL);
1029
1030 offset = 0;
1031
1032 if ((chunks > 0) && (syntax[0].first > 0))
1033 {
1034 /* Text before the first highlight */
1035 mutt_window_addnstr(win, buf, MIN(len, syntax[0].first));
1036 mutt_curses_set_color(ac_base);
1037 if (len <= syntax[0].first)
1038 goto dsl_finish; /* no more room */
1039
1040 offset = syntax[0].first;
1041 }
1042
1043 for (i = 0; i < chunks; i++)
1044 {
1045 /* Highlighted text */
1046 mutt_curses_set_color(syntax[i].attr_color);
1047 mutt_window_addnstr(win, buf + offset, MIN(len, syntax[i].last) - offset);
1048 if (len <= syntax[i].last)
1049 goto dsl_finish; /* no more room */
1050
1051 size_t next;
1052 if ((i + 1) == chunks)
1053 {
1054 next = len;
1055 }
1056 else
1057 {
1058 next = MIN(len, syntax[i + 1].first);
1059 }
1060
1061 mutt_curses_set_color(ac_base);
1062 offset = syntax[i].last;
1063 mutt_window_addnstr(win, buf + offset, next - offset);
1064
1065 offset = next;
1066 if (offset >= len)
1067 goto dsl_finish; /* no more room */
1068 }
1069
1070 mutt_curses_set_color(ac_base);
1071 if (offset < len)
1072 {
1073 /* Text after the last highlight */
1074 mutt_window_addnstr(win, buf + offset, len - offset);
1075 }
1076
1077 int width = mutt_strwidth(buf);
1078 if (width < max_cols)
1079 {
1080 /* Pad the rest of the line with whitespace */
1081 mutt_paddstr(win, max_cols - width, "");
1082 }
1083dsl_finish:
1084 FREE(&syntax);
1085}
1086
1097struct Mailbox *dlg_index(struct MuttWindow *dlg, struct Mailbox *m_init)
1098{
1099 /* Make sure use_threads/sort/sort_aux are coherent */
1101
1102 struct IndexSharedData *shared = dlg->wdata;
1104
1105 struct MuttWindow *panel_index = window_find_child(dlg, WT_INDEX);
1106
1107 struct IndexPrivateData *priv = panel_index->wdata;
1108 priv->win_index = window_find_child(panel_index, WT_MENU);
1109
1110 int op = OP_NULL;
1111
1112 if (shared->mailbox && (shared->mailbox->type == MUTT_NNTP))
1113 dlg->help_data = IndexNewsHelp;
1114 else
1115 dlg->help_data = IndexHelp;
1116 dlg->help_menu = MENU_INDEX;
1117
1118 priv->menu = priv->win_index->wdata;
1120 priv->menu->color = index_color;
1121 priv->menu->max = shared->mailbox ? shared->mailbox->vcount : 0;
1123
1124 struct MuttWindow *old_focus = window_set_focus(priv->menu->win);
1125 mutt_window_reflow(NULL);
1126
1127 if (!shared->attach_msg)
1128 {
1129 /* force the mailbox check after we enter the folder */
1131 }
1132#ifdef USE_INOTIFY
1133 mutt_monitor_add(NULL);
1134#endif
1135
1136 const bool c_collapse_all = cs_subset_bool(shared->sub, "collapse_all");
1137 if (mutt_using_threads() && c_collapse_all)
1138 {
1139 collapse_all(shared->mailbox_view, priv->menu, 0);
1141 }
1142
1143 int rc = 0;
1144 do
1145 {
1146 /* Clear the tag prefix unless we just started it.
1147 * Don't clear the prefix on a timeout, but do clear on an abort */
1148 if (priv->tag_prefix && (op != OP_TAG_PREFIX) &&
1149 (op != OP_TAG_PREFIX_COND) && (op != OP_TIMEOUT))
1150 {
1151 priv->tag_prefix = false;
1152 }
1153
1154 /* check if we need to resort the index because just about
1155 * any 'op' below could do mutt_enter_command(), either here or
1156 * from any new priv->menu launched, and change $sort/$sort_aux */
1157 if (OptNeedResort && shared->mailbox && (shared->mailbox->msg_count != 0) &&
1158 (menu_get_index(priv->menu) >= 0))
1159 {
1160 resort_index(shared->mailbox_view, priv->menu);
1161 }
1162
1163 priv->menu->max = shared->mailbox ? shared->mailbox->vcount : 0;
1164 priv->oldcount = shared->mailbox ? shared->mailbox->msg_count : 0;
1165
1166 if (shared->mailbox && shared->mailbox_view)
1167 {
1169
1170 shared->mailbox_view->menu = priv->menu;
1171 /* check for new mail in the mailbox. If nonzero, then something has
1172 * changed about the file (either we got new mail or the file was
1173 * modified underneath us.) */
1174 enum MxStatus check = mx_mbox_check(shared->mailbox);
1175
1176 if (check == MX_STATUS_ERROR)
1177 {
1178 if (buf_is_empty(&shared->mailbox->pathbuf))
1179 {
1180 /* fatal error occurred */
1181 mview_free(&shared->mailbox_view);
1183 }
1184
1186 }
1187 else if ((check == MX_STATUS_NEW_MAIL) || (check == MX_STATUS_REOPENED) ||
1188 (check == MX_STATUS_FLAGS))
1189 {
1190 /* notify the user of new mail */
1191 if (check == MX_STATUS_REOPENED)
1192 {
1193 mutt_error(_("Mailbox was externally modified. Flags may be wrong."));
1194 }
1195 else if (check == MX_STATUS_NEW_MAIL)
1196 {
1197 for (size_t i = 0; i < shared->mailbox->msg_count; i++)
1198 {
1199 const struct Email *e = shared->mailbox->emails[i];
1200 if (e && !e->read && !e->old)
1201 {
1202 mutt_message(_("New mail in this mailbox"));
1203 const bool c_beep_new = cs_subset_bool(shared->sub, "beep_new");
1204 if (c_beep_new)
1205 mutt_beep(true);
1206 const struct Expando *c_new_mail_command =
1207 cs_subset_expando(shared->sub, "new_mail_command");
1208 if (c_new_mail_command)
1209 {
1210 struct Buffer *cmd = buf_pool_get();
1211 menu_status_line(cmd, shared, NULL, -1, c_new_mail_command);
1212 if (mutt_system(buf_string(cmd)) != 0)
1213 mutt_error(_("Error running \"%s\""), buf_string(cmd));
1214 buf_pool_release(&cmd);
1215 }
1216 break;
1217 }
1218 }
1219 }
1220 else if (check == MX_STATUS_FLAGS)
1221 {
1222 mutt_message(_("Mailbox was externally modified"));
1223 }
1224
1225 /* avoid the message being overwritten by mailbox */
1226 priv->do_mailbox_notify = false;
1227
1228 bool verbose = shared->mailbox->verbose;
1229 shared->mailbox->verbose = false;
1230 update_index(priv->menu, shared->mailbox_view, check, priv->oldcount, shared);
1231 shared->mailbox->verbose = verbose;
1232 priv->menu->max = shared->mailbox->vcount;
1235 }
1236
1238 menu_get_index(priv->menu)));
1239 }
1240
1241 if (!shared->attach_msg)
1242 {
1243 /* check for new mail in the incoming folders */
1245 if (priv->do_mailbox_notify)
1246 {
1247 if (mutt_mailbox_notify(shared->mailbox))
1248 {
1249 const bool c_beep_new = cs_subset_bool(shared->sub, "beep_new");
1250 if (c_beep_new)
1251 mutt_beep(true);
1252 const struct Expando *c_new_mail_command = cs_subset_expando(shared->sub, "new_mail_command");
1253 if (c_new_mail_command)
1254 {
1255 struct Buffer *cmd = buf_pool_get();
1256 menu_status_line(cmd, shared, priv->menu, -1, c_new_mail_command);
1257 if (mutt_system(buf_string(cmd)) != 0)
1258 mutt_error(_("Error running \"%s\""), buf_string(cmd));
1259 buf_pool_release(&cmd);
1260 }
1261 }
1262 }
1263 else
1264 {
1265 priv->do_mailbox_notify = true;
1266 }
1267 }
1268
1269 window_redraw(NULL);
1270
1271 /* give visual indication that the next command is a tag- command */
1272 if (priv->tag_prefix)
1273 {
1274 msgwin_set_text(NULL, "tag-", MT_COLOR_NORMAL);
1275 }
1276
1277 const bool c_arrow_cursor = cs_subset_bool(shared->sub, "arrow_cursor");
1278 const bool c_braille_friendly = cs_subset_bool(shared->sub, "braille_friendly");
1279 const int index = menu_get_index(priv->menu);
1280 if (c_arrow_cursor)
1281 {
1282 const char *const c_arrow_string = cs_subset_string(shared->sub, "arrow_string");
1283 const int arrow_width = mutt_strwidth(c_arrow_string);
1284 mutt_window_move(priv->menu->win, index - priv->menu->top, arrow_width);
1285 }
1286 else if (c_braille_friendly)
1287 {
1288 mutt_window_move(priv->menu->win, index - priv->menu->top, 0);
1289 }
1290 else
1291 {
1292 mutt_window_move(priv->menu->win, index - priv->menu->top,
1293 priv->menu->win->state.cols - 1);
1294 }
1295 mutt_refresh();
1296
1297 window_redraw(NULL);
1298 struct KeyEvent event = km_dokey(MENU_INDEX, GETCH_NO_FLAGS);
1299 op = event.op;
1300
1301 if (op == OP_REPAINT)
1302 {
1303 /* force a real complete redraw. clrtobot() doesn't seem to be able
1304 * to handle every case without this. */
1305 msgwin_clear_text(NULL);
1306 mutt_refresh();
1307 continue;
1308 }
1309
1310 /* either user abort or timeout */
1311 if (op < OP_NULL)
1312 {
1313 if (priv->tag_prefix)
1314 msgwin_clear_text(NULL);
1315 continue;
1316 }
1317
1318 mutt_debug(LL_DEBUG1, "Got op %s (%d)\n", opcodes_get_name(op), op);
1319
1320 /* special handling for the priv->tag-prefix function */
1321 const bool c_auto_tag = cs_subset_bool(shared->sub, "auto_tag");
1322 if ((op == OP_TAG_PREFIX) || (op == OP_TAG_PREFIX_COND))
1323 {
1324 /* A second priv->tag-prefix command aborts */
1325 if (priv->tag_prefix)
1326 {
1327 priv->tag_prefix = false;
1328 msgwin_clear_text(NULL);
1329 continue;
1330 }
1331
1332 if (!shared->mailbox)
1333 {
1334 mutt_error(_("No mailbox is open"));
1335 continue;
1336 }
1337
1338 if (shared->mailbox->msg_tagged == 0)
1339 {
1340 if (op == OP_TAG_PREFIX)
1341 {
1342 mutt_error(_("No tagged messages"));
1343 }
1344 else if (op == OP_TAG_PREFIX_COND)
1345 {
1347 mutt_message(_("Nothing to do"));
1348 }
1349 continue;
1350 }
1351
1352 /* get the real command */
1353 priv->tag_prefix = true;
1354 continue;
1355 }
1356 else if (c_auto_tag && shared->mailbox && (shared->mailbox->msg_tagged != 0))
1357 {
1358 priv->tag_prefix = true;
1359 }
1360
1362
1363 OptNews = false; /* for any case */
1364
1365#ifdef USE_NOTMUCH
1366 nm_db_debug_check(shared->mailbox);
1367#endif
1368
1369 rc = index_function_dispatcher(priv->win_index, &event);
1370
1371 if (rc == FR_UNKNOWN)
1372 rc = menu_function_dispatcher(priv->win_index, &event);
1373
1374 if (rc == FR_UNKNOWN)
1375 {
1376 struct MuttWindow *win_sidebar = window_find_child(dlg, WT_SIDEBAR);
1377 rc = sb_function_dispatcher(win_sidebar, &event);
1378 }
1379 if (rc == FR_UNKNOWN)
1380 rc = global_function_dispatcher(priv->menu->win, &event);
1381
1382 if (rc == FR_UNKNOWN)
1384
1385#ifdef USE_NOTMUCH
1386 nm_db_debug_check(shared->mailbox);
1387#endif
1388 } while (rc != FR_DONE);
1389
1390 mview_free(&shared->mailbox_view);
1391 window_set_focus(old_focus);
1392
1393 return shared->mailbox;
1394}
1395
1404void email_set_color(struct Mailbox *m, struct Email *e)
1405{
1406 if (!e)
1407 return;
1408
1409 struct RegexColor *color = NULL;
1410 struct PatternCache cache = { 0 };
1411
1412 const struct AttrColor *ac_merge = NULL;
1414 {
1416 MUTT_MATCH_FULL_ADDRESS, m, e, &cache))
1417 {
1418 ac_merge = merged_color_overlay(ac_merge, &color->attr_color);
1419 }
1420 }
1421
1422 struct AttrColor *ac_normal = simple_color_get(MT_COLOR_NORMAL);
1423 if (ac_merge)
1424 ac_merge = merged_color_overlay(ac_normal, ac_merge);
1425 else
1426 ac_merge = ac_normal;
1427
1428 e->attr_color = ac_merge;
1429}
1430
1436{
1440
1441 struct IndexSharedData *shared = index_shared_data_new();
1442 notify_set_parent(shared->notify, dlg->notify);
1443
1444 dlg->wdata = shared;
1446
1447 const bool c_status_on_top = cs_subset_bool(NeoMutt->sub, "status_on_top");
1448
1449 struct MuttWindow *panel_index = ipanel_new(c_status_on_top, shared);
1450 struct MuttWindow *panel_pager = ppanel_new(c_status_on_top, shared);
1451
1452 mutt_window_add_child(dlg, panel_index);
1453 mutt_window_add_child(dlg, panel_pager);
1454
1455 return dlg;
1456}
1457
1463void index_change_folder(struct MuttWindow *dlg, struct Mailbox *m)
1464{
1465 if (!dlg || !m)
1466 return;
1467
1468 struct IndexSharedData *shared = dlg->wdata;
1469 if (!shared)
1470 return;
1471
1472 struct MuttWindow *panel_index = window_find_child(dlg, WT_INDEX);
1473 if (!panel_index)
1474 return;
1475
1476 struct IndexPrivateData *priv = panel_index->wdata;
1477 if (!priv)
1478 return;
1479
1480 change_folder_mailbox(priv->menu, m, &priv->oldcount, shared, false);
1481}
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:79
@ MT_COLOR_NORMAL
Plain text.
Definition color.h:54
@ MT_COLOR_INDEX
Index: default colour.
Definition color.h:87
void mutt_pattern_free(struct PatternList **pat)
Free a Pattern.
Definition compile.c:775
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:38
#define SORT_REVERSE
Reverse the order of the sort.
Definition sort.h:39
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:174
static const char * mailbox_path(const struct Mailbox *m)
Get the Mailbox's path string.
Definition mailbox.h:214
uint16_t AclFlags
ACL Rights - These show permission to...
Definition mailbox.h:59
MailboxType
Supported mailbox formats.
Definition mailbox.h:41
@ MUTT_MAILBOX_ERROR
Error occurred examining Mailbox.
Definition mailbox.h:43
@ MUTT_NNTP
'NNTP' (Usenet) Mailbox type
Definition mailbox.h:49
@ MUTT_UNKNOWN
Mailbox wasn't recognised.
Definition mailbox.h:44
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:608
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:729
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:956
void email_set_color(struct Mailbox *m, struct Email *e)
Select an Index colour for an Email.
Definition dlg_index.c:1404
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:539
void index_change_folder(struct MuttWindow *dlg, struct Mailbox *m)
Change the current folder, cautiously.
Definition dlg_index.c:1463
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:490
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:754
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:800
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:1435
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:63
EmailSortType
Methods for sorting Emails.
Definition sort.h:53
@ EMAIL_SORT_THREADS
Sort by email threads.
Definition sort.h:62
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
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:138
Parse Expando string.
const struct ExpandoRenderCallback IndexRenderCallbacks[]
Callbacks for Index Expandos.
String processing routines to generate the mail index.
struct KeyEvent km_dokey(enum MenuType mtype, GetChFlags flags)
Determine what a keypress should do.
Definition get.c:431
void mutt_flush_macro_to_endcond(void)
Drop a macro from the input buffer.
Definition get.c:157
void km_error_key(enum MenuType mtype)
Handle an unbound key sequence.
Definition get.c:285
#define GETCH_NO_FLAGS
No flags are set.
Definition get.h:34
bool OptNews
(pseudo) used to change reader mode
Definition globals.c:64
char * LastFolder
Previously selected mailbox.
Definition globals.c:40
char * CurrentFolder
Currently selected mailbox.
Definition globals.c:39
Global variables.
int sb_function_dispatcher(struct MuttWindow *win, const struct KeyEvent *event)
Perform a Sidebar function - Implements function_dispatcher_t -.
Definition functions.c:422
int index_function_dispatcher(struct MuttWindow *win, const struct KeyEvent *event)
Perform an Index function - Implements function_dispatcher_t -.
Definition functions.c:3321
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:318
struct Mailbox * dlg_index(struct MuttWindow *dlg, struct Mailbox *m_init)
Display a list of emails -.
Definition dlg_index.c:1097
#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:924
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:823
static int index_mailbox_observer(struct NotifyCallback *nc)
Notification that a Mailbox has changed - Implements observer_t -.
Definition dlg_index.c:582
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
Hook Commands.
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:181
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)
Definition memory.h:63
#define MIN(a, b)
Definition memory.h:38
#define MUTT_MEM_REALLOC(pptr, n, type)
Definition memory.h:51
#define MUTT_MEM_MALLOC(n, type)
Definition memory.h:49
#define MAX(a, b)
Definition memory.h:37
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:186
int menu_get_index(struct Menu *menu)
Get the current selection in the Menu.
Definition menu.c:162
MenuRedrawFlags menu_set_index(struct Menu *menu, int index)
Set the current selection in the Menu.
Definition menu.c:176
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:87
@ WT_INDEX
A panel containing the Index Window.
Definition mutt_window.h:97
@ WT_SIDEBAR
Side panel containing Accounts or groups of data.
@ WT_MENU
An Window containing a Menu.
Definition mutt_window.h:98
@ MUTT_WIN_ORIENT_HORIZONTAL
Window uses all available horizontal space.
Definition mutt_window.h:40
#define MUTT_WIN_SIZE_UNLIMITED
Use as much space as possible.
Definition mutt_window.h:53
@ MUTT_WIN_SIZE_MAXIMISE
Window wants as much space as possible.
Definition mutt_window.h:49
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:43
uint8_t OpenMailboxFlags
Flags for mutt_open_mailbox(), e.g. MUTT_NOSORT.
Definition mxapi.h:39
#define MUTT_MAILBOX_CHECK_NO_FLAGS
No flags are set.
Definition mxapi.h:50
#define MUTT_OPEN_NO_FLAGS
No flags are set.
Definition mxapi.h:40
#define MUTT_MAILBOX_CHECK_POSTPONED
Make sure the number of postponed messages is updated.
Definition mxapi.h:51
MxStatus
Return values from mbox_check(), mbox_check_stats(), mbox_sync(), and mbox_close()
Definition mxapi.h:60
@ MX_STATUS_ERROR
An error occurred.
Definition mxapi.h:61
@ MX_STATUS_OK
No changes.
Definition mxapi.h:62
@ MX_STATUS_FLAGS
Nondestructive flags change (IMAP)
Definition mxapi.h:66
@ MX_STATUS_REOPENED
Mailbox was reopened.
Definition mxapi.h:65
@ MX_STATUS_NEW_MAIL
New mail received in Mailbox.
Definition mxapi.h:63
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:1593
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
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:82
void buf_pool_release(struct Buffer **ptr)
Return a Buffer to the pool.
Definition pool.c:96
#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
void mutt_folder_hook(const char *path, const char *desc)
Perform a folder hook.
Definition run.c:63
GUI display the mailboxes in a side panel.
#define ASSERT(COND)
Definition signal2.h:60
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:66
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:190
struct Mailbox * mailbox
The Mailbox this Event relates to.
Definition mailbox.h:191
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:79
int vcount
The number of virtual messages.
Definition mailbox.h:99
char * realpath
Used for duplicate detection, context comparison, and the sidebar.
Definition mailbox.h:81
int * v2r
Mapping from virtual to real msgno.
Definition mailbox.h:98
int msg_count
Total number of messages.
Definition mailbox.h:88
AclFlags rights
ACL bits, see AclFlags.
Definition mailbox.h:119
int email_max
Size of emails array.
Definition mailbox.h:97
enum MailboxType type
Mailbox type.
Definition mailbox.h:102
struct Email ** emails
Array of Emails.
Definition mailbox.h:96
char * name
A short name for the Mailbox.
Definition mailbox.h:82
struct Notify * notify
Notifications: NotifyMailbox, EventMailbox.
Definition mailbox.h:145
struct Buffer pathbuf
Path of the Mailbox.
Definition mailbox.h:80
void * compress_info
Compressed mbox module private data.
Definition mailbox.h:121
int msg_tagged
How many messages are tagged?
Definition mailbox.h:94
bool verbose
Display status messages?
Definition mailbox.h:117
struct ConfigSubset * sub
Inherited config items.
Definition mailbox.h:83
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.
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)
int help_menu
Menu for key bindings, e.g. MENU_PAGER.
Container for Accounts, Notifications.
Definition neomutt.h:128
char ** env
Private copy of the environment variables.
Definition neomutt.h:143
struct Notify * notify
Notifications handler.
Definition neomutt.h:130
struct ConfigSubset * sub
Inherited config items.
Definition neomutt.h:134
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:36
regex_t regex
Compiled regex.
Definition regex4.h:39
struct PatternList * color_pattern
Compiled pattern to speed up index color calculation.
Definition regex4.h:41
struct AttrColor attr_color
Colour and attributes to apply.
Definition regex4.h:37
int match
Substring to match, 0 for old behaviour.
Definition regex4.h:40
struct PatternList * pattern
compiled search pattern
short cols
Number of columns, can be MUTT_WIN_SIZE_UNLIMITED.
Definition mutt_window.h:61
@ MENU_INDEX
Index panel (list of emails)
Definition type.h:44