debian/patches/features/trash-folder

   1 # vim:ft=diff:
   2 This is the trash folder patch by Cedric Duval <cedricduval@free.fr>.
   3
   4 With this patch, if the trash variable is set to a path (unset by default), the
   5 deleted mails will be moved to a trash folder instead of being irremediably
   6 purged when syncing the mailbox.
   7
   8 For instance, set trash="~/Mail/trash" will cause every deleted mail to go to
   9 this folder.
  10
  11 Note that the append to the trash folder doesn't occur until the resync is
  12 done. This allows you to change your mind and undo deletes, and thus the moves
  13 to the trash folder are unnecessary.
  14
  15 Notes
  16
  17     * You might also want to have a look at the purge message feature below
  18       which is related to this patch.
  19     * IMAP is now supported. To retain the previous behavior, add this to your
  20       muttrc:
  21       folder-hook ^imap:// 'unset trash'
  22
  23 FAQ
  24
  25 Every once in a while, someone asks what are the advantages of this patch over
  26 a macro based solution. Here's an attempt to answer this question:
  27
  28     * The folder history doesn't clutter up with unwanted trash entries.
  29     * Delayed move to the trash allows to change one's mind.
  30     * No need to treat the case of "normal folders" and trash folders
  31       separately with folder-hooks, and to create two sets of macros (one for
  32       the index, one for the pager).
  33     * Works not only with delete-message, but also with every deletion
  34       functions like delete-pattern, delete-thread or delete-subthread.
  35
  36 To sum up, it's more integrated and transparent to the user.
  37
  38 * Patch last synced with upstream:
  39   - Date: 2007-02-15
  40   - File: http://cedricduval.free.fr/mutt/patches/download/patch-1.5.5.1.cd.trash_folder.3.4
  41
  42 * Changes made:
  43   - Updated to 1.5.13:
  44     - structure of _mutt_save_message changed (commands.c)
  45     - context of option (OPTCONFIRMAPPEND) changed (muttlib.c)
  46   - Fixed indentation of "appended" in mutt.h.
  47
  48 == END PATCH
  49 Index: mutt/commands.c
  50 ===================================================================
  51 --- mutt.orig/commands.c        2009-06-25 12:35:37.000000000 +0200
  52 +++ mutt/commands.c     2009-06-25 12:35:48.000000000 +0200
  53 @@ -716,6 +716,7 @@
  54      if (option (OPTDELETEUNTAG))
  55        mutt_set_flag (Context, h, M_TAG, 0);
  56    }
  57 +  mutt_set_flag (Context, h, M_APPENDED, 1);
  58
  59    return 0;
  60  }
  61 Index: mutt/flags.c
  62 ===================================================================
  63 --- mutt.orig/flags.c   2009-06-25 12:35:37.000000000 +0200
  64 +++ mutt/flags.c        2009-06-25 12:35:48.000000000 +0200
  65 @@ -65,7 +65,13 @@
  66        {
  67         h->deleted = 0;
  68          update = 1;
  69 -       if (upd_ctx) ctx->deleted--;
  70 +       if (upd_ctx)
  71 +       {
  72 +         ctx->deleted--;
  73 +         if (h->appended)
  74 +           ctx->appended--;
  75 +       }
  76 +       h->appended = 0; /* when undeleting, also reset the appended flag */
  77  #ifdef USE_IMAP
  78          /* see my comment above */
  79         if (ctx->magic == M_IMAP)
  80 @@ -87,6 +93,17 @@
  81        }
  82        break;
  83
  84 +    case M_APPENDED:
  85 +      if (bf)
  86 +      {
  87 +       if (!h->appended)
  88 +       {
  89 +         h->appended = 1;
  90 +         if (upd_ctx) ctx->appended++;
  91 +       }
  92 +      }
  93 +      break;
  94 +
  95      case M_NEW:
  96
  97        if (!mutt_bit_isset(ctx->rights,M_ACL_SEEN))
  98 Index: mutt/globals.h
  99 ===================================================================
 100 --- mutt.orig/globals.h 2009-06-25 12:35:44.000000000 +0200
 101 +++ mutt/globals.h      2009-06-25 12:35:48.000000000 +0200
 102 @@ -139,6 +139,7 @@
 103  WHERE char *Status;
 104  WHERE char *Tempdir;
 105  WHERE char *Tochars;
 106 +WHERE char *TrashPath;
 107  WHERE char *Username;
 108  WHERE char *Visual;
 109  WHERE char *XtermTitle;
 110 Index: mutt/imap/message.c
 111 ===================================================================
 112 --- mutt.orig/imap/message.c    2009-06-25 12:35:37.000000000 +0200
 113 +++ mutt/imap/message.c 2009-06-25 12:35:48.000000000 +0200
 114 @@ -867,6 +867,7 @@
 115          if (ctx->hdrs[n]->tagged)
 116          {
 117            mutt_set_flag (ctx, ctx->hdrs[n], M_DELETE, 1);
 118 +         mutt_set_flag (ctx, ctx->hdrs[n], M_APPENDED, 1);
 119            if (option (OPTDELETEUNTAG))
 120              mutt_set_flag (ctx, ctx->hdrs[n], M_TAG, 0);
 121          }
 122 @@ -874,6 +875,7 @@
 123      else
 124      {
 125        mutt_set_flag (ctx, h, M_DELETE, 1);
 126 +      mutt_set_flag (ctx, h, M_APPENDED, 1);
 127        if (option (OPTDELETEUNTAG))
 128          mutt_set_flag (ctx, h, M_TAG, 0);
 129      }
 130 Index: mutt/init.h
 131 ===================================================================
 132 --- mutt.orig/init.h    2009-06-25 12:35:44.000000000 +0200
 133 +++ mutt/init.h 2009-06-25 12:35:48.000000000 +0200
 134 @@ -3180,6 +3180,16 @@
 135    ** by \fIyou\fP.  The sixth character is used to indicate when a mail
 136    ** was sent to a mailing-list you subscribe to.
 137    */
 138 +  { "trash",           DT_PATH, R_NONE, UL &TrashPath, 0 },
 139 +  /*
 140 +  ** .pp
 141 +  ** If set, this variable specifies the path of the trash folder where the
 142 +  ** mails marked for deletion will be moved, instead of being irremediably
 143 +  ** purged.
 144 +  ** .pp
 145 +  ** NOTE: When you delete a message in the trash folder, it is really
 146 +  ** deleted, so that you have a way to clean the trash.
 147 +  */
 148  #ifdef USE_SOCKET
 149    { "tunnel",            DT_STR, R_NONE, UL &Tunnel, UL 0 },
 150    /*
 151 Index: mutt/mutt.h
 152 ===================================================================
 153 --- mutt.orig/mutt.h    2009-06-25 12:35:44.000000000 +0200
 154 +++ mutt/mutt.h 2009-06-25 12:35:48.000000000 +0200
 155 @@ -187,6 +187,7 @@
 156    M_DELETE,
 157    M_UNDELETE,
 158    M_DELETED,
 159 +  M_APPENDED,
 160    M_FLAG,
 161    M_TAG,
 162    M_UNTAG,
 163 @@ -702,6 +703,7 @@
 164    unsigned int mime : 1;               /* has a MIME-Version header? */
 165    unsigned int flagged : 1;            /* marked important? */
 166    unsigned int tagged : 1;
 167 +  unsigned int appended : 1;           /* has been saved */
 168    unsigned int deleted : 1;
 169    unsigned int changed : 1;
 170    unsigned int attach_del : 1;                 /* has an attachment marked for deletion */
 171 @@ -874,6 +876,7 @@
 172    int new;                     /* how many new messages? */
 173    int unread;                  /* how many unread messages? */
 174    int deleted;                 /* how many deleted messages */
 175 +  int appended;                 /* how many saved messages? */
 176    int flagged;                 /* how many flagged messages */
 177    int msgnotreadyet;           /* which msg "new" in pager, -1 if none */
 178
 179 Index: mutt/muttlib.c
 180 ===================================================================
 181 --- mutt.orig/muttlib.c 2009-06-25 12:35:37.000000000 +0200
 182 +++ mutt/muttlib.c      2009-06-25 12:35:48.000000000 +0200
 183 @@ -1460,7 +1460,9 @@
 184
 185    if (magic > 0 && !mx_access (s, W_OK))
 186    {
 187 -    if (option (OPTCONFIRMAPPEND))
 188 +    if (option (OPTCONFIRMAPPEND) &&
 189 +       (!TrashPath || (mutt_strcmp (s, TrashPath) != 0)))
 190 +      /* if we're appending to the trash, there's no point in asking */
 191      {
 192        snprintf (tmp, sizeof (tmp), _("Append messages to %s?"), s);
 193        if ((rc = mutt_yesorno (tmp, M_YES)) == M_NO)
 194 Index: mutt/mx.c
 195 ===================================================================
 196 --- mutt.orig/mx.c      2009-06-25 12:35:37.000000000 +0200
 197 +++ mutt/mx.c   2009-06-25 12:35:48.000000000 +0200
 198 @@ -773,6 +773,53 @@
 199    return rc;
 200  }
 201
 202 +/* move deleted mails to the trash folder */
 203 +static int trash_append (CONTEXT *ctx)
 204 +{
 205 +    CONTEXT *ctx_trash;
 206 +    int i = 0;
 207 +    struct stat st, stc;
 208 +
 209 +    if (!TrashPath || !ctx->deleted ||
 210 +       (ctx->magic == M_MAILDIR && option (OPTMAILDIRTRASH)))
 211 +      return 0;
 212 +
 213 +    for (;i < ctx->msgcount && (!ctx->hdrs[i]->deleted ||
 214 +                               ctx->hdrs[i]->appended); i++);
 215 +    if (i == ctx->msgcount)
 216 +      return 0; /* nothing to be done */
 217 +
 218 +    if (mutt_save_confirm (TrashPath, &st) != 0)
 219 +    {
 220 +      mutt_error _("message(s) not deleted");
 221 +      return -1;
 222 +    }
 223 +
 224 +    if (lstat (ctx->path, &stc) == 0 && stc.st_ino == st.st_ino
 225 +       && stc.st_dev == st.st_dev && stc.st_rdev == st.st_rdev)
 226 +      return 0;  /* we are in the trash folder: simple sync */
 227 +
 228 +    if ((ctx_trash = mx_open_mailbox (TrashPath, M_APPEND, NULL)) != NULL)
 229 +    {
 230 +      for (i = 0 ; i < ctx->msgcount ; i++)
 231 +       if (ctx->hdrs[i]->deleted && !ctx->hdrs[i]->appended
 232 +           && mutt_append_message (ctx_trash, ctx, ctx->hdrs[i], 0, 0) == -1)
 233 +         {
 234 +           mx_close_mailbox (ctx_trash, NULL);
 235 +           return -1;
 236 +         }
 237 +
 238 +      mx_close_mailbox (ctx_trash, NULL);
 239 +    }
 240 +    else
 241 +    {
 242 +      mutt_error _("Can't open trash folder");
 243 +      return -1;
 244 +    }
 245 +
 246 +    return 0;
 247 +}
 248 +
 249  /* save changes and close mailbox */
 250  int mx_close_mailbox (CONTEXT *ctx, int *index_hint)
 251  {
 252 @@ -909,6 +956,7 @@
 253           if (mutt_append_message (&f, ctx, ctx->hdrs[i], 0, CH_UPDATE_LEN) == 0)
 254           {
 255             mutt_set_flag (ctx, ctx->hdrs[i], M_DELETE, 1);
 256 +           mutt_set_flag (ctx, ctx->hdrs[i], M_APPENDED, 1);
 257           }
 258           else
 259           {
 260 @@ -931,6 +979,14 @@
 261      return 0;
 262    }
 263
 264 +  /* copy mails to the trash before expunging */
 265 +  if (purge && ctx->deleted && mutt_strcmp(ctx->path, TrashPath))
 266 +    if (trash_append (ctx) != 0)
 267 +    {
 268 +      ctx->closing = 0;
 269 +      return -1;
 270 +    }
 271 +
 272  #ifdef USE_IMAP
 273    /* allow IMAP to preserve the deleted flag across sessions */
 274    if (ctx->magic == M_IMAP)
 275 @@ -1130,6 +1186,12 @@
 276    msgcount = ctx->msgcount;
 277    deleted = ctx->deleted;
 278
 279 +  if (purge && ctx->deleted && mutt_strcmp(ctx->path, TrashPath))
 280 +  {
 281 +    if (trash_append (ctx) == -1)
 282 +      return -1;
 283 +  }
 284 +
 285  #ifdef USE_IMAP
 286    if (ctx->magic == M_IMAP)
 287      rc = imap_sync_mailbox (ctx, purge, index_hint);
 288 Index: mutt/postpone.c
 289 ===================================================================
 290 --- mutt.orig/postpone.c        2009-06-25 12:35:37.000000000 +0200
 291 +++ mutt/postpone.c     2009-06-25 12:35:48.000000000 +0200
 292 @@ -276,6 +276,9 @@
 293    /* finished with this message, so delete it. */
 294    mutt_set_flag (PostContext, h, M_DELETE, 1);
 295
 296 +  /* and consider it saved, so that it won't be moved to the trash folder */
 297 +  mutt_set_flag (PostContext, h, M_APPENDED, 1);
 298 +
 299    /* update the count for the status display */
 300    PostCount = PostContext->msgcount - PostContext->deleted;
 301