svn commit: r473572 - in head/mail/dovecot-pigeonhole: . files

[Larry Rosenman]

Author: ler
Date: Fri Jun 29 18:44:50 2018
New Revision: 473572
URL: https://svnweb.freebsd.org/changeset/ports/473572

Log:
  mail/dovecot-pigeonhole: add missing doc file
  
  Obtained from:	upstream github

Added:
  head/mail/dovecot-pigeonhole/files/
  head/mail/dovecot-pigeonhole/files/patch-doc_plugins_imap__filter__sieve.txt   (contents, props changed)
Modified:
  head/mail/dovecot-pigeonhole/Makefile

Modified: head/mail/dovecot-pigeonhole/Makefile
==============================================================================
--- head/mail/dovecot-pigeonhole/Makefile	Fri Jun 29 18:38:13 2018	(r473571)
+++ head/mail/dovecot-pigeonhole/Makefile	Fri Jun 29 18:44:50 2018	(r473572)
@@ -3,6 +3,7 @@
 
 PORTNAME=	dovecot-pigeonhole
 PORTVERSION=	0.5.2
+PORTREVISION=	1
 CATEGORIES=	mail
 MASTER_SITES=	http://pigeonhole.dovecot.org/releases/${DOVECOTVERSION}/
 DISTNAME=	${PORTNAME:C/-/-${DOVECOTVERSION}-/}-${PORTVERSION}

Added: head/mail/dovecot-pigeonhole/files/patch-doc_plugins_imap__filter__sieve.txt
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ head/mail/dovecot-pigeonhole/files/patch-doc_plugins_imap__filter__sieve.txt	Fri Jun 29 18:44:50 2018	(r473572)
@@ -0,0 +1,55 @@
+--- doc/plugins/imap_filter_sieve.txt.orig	2018-06-29 18:42:19 UTC
++++ doc/plugins/imap_filter_sieve.txt
+@@ -0,0 +1,52 @@
++IMAP FILTER Sieve plugin for Pigeonhole
++
++Relevant specifications
++=======================
++
++	doc/rfc/draft-bosch-imap-filter-sieve-00.txt
++
++Introduction
++============
++
++Normally, Sieve filters can either be applied at initial mail delivery or
++triggered by certain events in the Internet Message Access Protocol (IMAPSIEVE;
++RFC 6785). The user can configure which Sieve scripts to run at these instances,
++but it is not possible to trigger the execution of Sieve scripts manually.
++However, this could be very useful; e.g, to test new Sieve rules and to
++re-filter messages that were erroneously handled by an earlier version of the
++Sieve scripts involved.
++
++Pigeonhole provides the imap_filter_sieve plugin, which provides a vendor-
++defined IMAP extension called "FILTER=SIEVE". This adds a new "FILTER" command
++that allows applying a mail filter (a Sieve script) on a set of messages that
++match the specified searching criteria.
++
++This plugin is experimental and the specification is likely to change.
++
++Configuration
++=============
++
++The IMAP FILTER Sieve plugin is activated by adding it to the mail_plugins
++setting for  the imap protocol:
++
++protocol imap {
++	mail_plugins = $mail_plugins imap_filter_sieve
++}
++
++Currently, no other settings specific to this plugin are defined. It uses the
++normal configuration settings used by the LDA Sieve plugin at delivery.
++
++The sieve_before and sieve_after scripts are currently ignored by this plugin.
++
++Example
++-------
++
++protocol imap {
++  # Space separated list of plugins to load (default is global mail_plugins).
++  mail_plugins = $mail_plugins imap_filter_sieve
++}
++
++plugin {
++  sieve_global = /usr/lib/dovecot/sieve-global.d
++}
++