CVS: mharc/bin mk-procmailrc,1.15,1.16

Update of /cvsroot/mhonarc/mharc/bin
In directory subversions:/tmp/cvs-serv22623/bin

Modified Files:
	mk-procmailrc 
Log Message:
* bin/mk-procmailrc:
  . Added -final-dest option: The destination of messages that make
    it to the end of the procmailrc.  Generally, this option can
    be ignored.

    Run mk-procmailrc program with -man option to view the manpage
    to get more information about this option.

* lib/config.sh.dist:
  . Added FINAL_MSG_DESTINATION variable to repesent destination
    mailbox for end rule in procmailrc (checked by mk-procmailrc if
    -final-dest not specified).


Index: mk-procmailrc
===================================================================
RCS file: /cvsroot/mhonarc/mharc/bin/mk-procmailrc,v
retrieving revision 1.15
retrieving revision 1.16
diff -C2 -r1.15 -r1.16
*** mk-procmailrc	23 Jul 2002 04:00:21 -0000	1.15
--- mk-procmailrc	1 Aug 2002 01:18:46 -0000	1.16
***************
*** 46,49 ****
--- 46,50 ----
      'catch-archive=s',
      'disable-catch-archive!',
+     'final-dest=s',
      'home=s',
      'mbox-dir=s',
***************
*** 80,83 ****
--- 81,87 ----
  			  $opt{'disable-catch-archive'} :
  			  ($config->{'DISABLE_CATCH_ARCHIVE'} || 0);
+   my $final_dest    = $opt{'final-dest'} ||
+ 		      $config->{'FINAL_MSG_DESTINATION'} ||
+ 		      '/dev/null';
  
    ## Read lists definition file
***************
*** 283,292 ****
    }
  
!   print $outfh <<'EOT';
  ##======================================================================
! ##	Discard message at the end
  ##======================================================================
  :0
! /dev/null
  EOT
  
--- 287,299 ----
    }
  
!   print $outfh <<EOT;
  ##======================================================================
! ##	Final destination, typically discard since at least one of the
! ##	above rules should have matched.  But if paranoid, you can
! ##	have copies delivered to a real mailbox by the -final-dest
! ##	option.
  ##======================================================================
  :0
! $final_dest
  EOT
  
***************
*** 508,511 ****
--- 515,540 ----
  B<Note:> Care should be used when using this option since any
  message that does not match a normal rule will be lost.
+ 
+ =item C<-final-dest> I<mailbox>
+ 
+ The destination of messages that make it to the end of the procmailrc.
+ In normal operations, it should be okay to discard messages at the
+ end since it should have matched one of the list rules or have been
+ caught by the catch archive (see C<-catch-archive>).
+ 
+ It is normal for messages to make it to the end since the list matching
+ rules create copies of the message during filtering.  This typically
+ will be apparent by the "C<Folder: /dev/null>" destinations in the
+ procmail log.  Message copying is done inorder to properly archive a
+ message that has been cross-posted to multiple lists that are being
+ archived.  Exceptions to the message copying are for lists with the
+ C<Final> option set to 1, for CVS commit archives, or for messages
+ that are captured by the catch archive.
+ 
+ This option is generally only set for debugging purposes.
+ 
+ If C<-final-dest> is not specified, the
+ C<FINAL_MSG_DESTINATION> variable in C<config.sh> is used, else
+ C</dev/null> is used.
  
  =item C<-help>

---------------------------------------------------------------------
To sign-off this list, send email to majordomo(_at_)mhonarc(_dot_)org with the
message text UNSUBSCRIBE MHONARC-DEV