[Dovecot] Released Sieve v0.1.11 and ManageSieve v0.11.8 for Dovecot v1.2.3

[Wolfgang.Friebel at desy.de]

On Mon, 10 Aug 2009, Michal Hlavinka wrote:

> build process for Sieve fails when --with-unfinished-features option is set:
> ...
> make[2]: Entering directory
> `/home/mihl/myroot/job/cvsf/dovecot/devel/dovecot-1.2.3/dovecot-1.2-
> sieve-0.1.11'
> make[2]: *** No rule to make target `doc/man/sieve-filter.1', needed by `all-
> am'.  Stop.
>

I have added a dummy sieve-filter.1 file to get it going. See the 
attachment.

-- 
Wolfgang Friebel                   Deutsches Elektronen-Synchrotron DESY
Phone/Fax:  +49 33762 77372/216    Platanenallee 6
Mail: Wolfgang.Friebel AT desy.de  D-15738 Zeuthen  Germany
-------------- next part --------------
.TH "SIEVE-FILTER" "1" "8 August 2009"
.SH NAME
sieve-filter \- Sieve filter for the Dovecot secure IMAP server
.SH SYNOPSIS
sieve-filter
[\fB-c\fR] 
[\fB-m\fR \fIdefault-mailbox\fR]
[\fB-s\fR \fIscript-file\fR]
[\fB-x\fR "\fIextension extension ...\fR"]
\fIscript-file\fR \fImail-store\fR \fI[dest-mail-store]\fR
.SH DESCRIPTION
.PP
The \fBsieve-filter\fP command is part of the Sieve implementation for the Dovecot secure 
IMAP server. Sieve (RFC 5228) is a simple and highly extensible language for filtering 
e-mail messages. It can be implemented for any type of mail access protocol, mail 
architecture and operating system. The language cannot execute external programs and in 
its basic form it does not provide the means to cause infinite loops, making it suitable 
for running securely on mail servers where mail users have no permission run arbitrary programs.
.PP
Using the \fBsieve-filter\fP command, 
bla bla (to be done)
.SH OPTIONS
.TP 
\fB-c\fP
Force compilation. By default, the compiled binary is stored on disk. When this binary is found
during the next execution of \fBsieve-filter\fP and its modification time is more recent than the
script file, it is used and the script is not compiled again. This option forces the script to be
compiled, thus ignoring any present binary. Refer to \fBsievec\fP(1) for more information about 
Sieve compilation.
.TP
\fB-m\fP \fIdefault-mailbox\fP
The mailbox where the keep action stores the message. This is "INBOX" by default.
\fB-s\fP \fIscript-file\fP
Specify additional scripts to be executed before the main script. Multiple \fB-s\fP arguments are
allowed and the specified scripts are executed sequentially in the order specified at the command
line.
.TP
\fB-x\fP "\fIextension extension ...\fP"
Set the available extensions. The parameter is a space-separated list of the active extensions. By
prepending the extension identifiers with \fB+\fP or \fB-\fP, extensions can be included or excluded
relative to the default set of extensions. If no extensions have a \fB+\fP or \fB-\fP prefix, only 
those extensions that are explicitly listed will be enabled. Unknown extensions are ignored and a 
warning is produced. By default, all supported extensions are available, except for deprecated extensions 
or those that are still under development.

For example \fB-x\fP "+imapflags -enotify" will enable the deprecated imapflags extension along with all
extensions that are available by default, except for the enotify extension.
.SH DEBUG SUPPORT
.PP
To improve script debugging, the Sieve command line tools such as \fBsieve-filter\fP support a custom
Sieve language extension called 'vnd.dovecot.debug'. It adds the \fBdebug_print\fP command that allows
printing debug messages to \fBstdout\fP. 
.PP
Example:
.PP
require "vnd.dovecot.debug";
.PP
if header :contains "subject" "hello" {
.PP
  debug_print "Subject header contains hello!";
.PP
}
.PP
Other tools like \fBsievec\fP and \fBsieved\fP also recognize the vnd.dovecot.debug extension. In contrast,
the actual Sieve plugin for the Dovecot LDA does not allow the use of the debug extension. So, keep in mind that 
scripts and compiled binaries that refer to de debug extension will fail to be run by the Sieve plugin itself.
.PP
Note that it is not necessary to enable nor possible to disable the availability of the debug extension with 
the \fB-x\fP option.
.SH AUTHOR
.PP
The Sieve implementation for Dovecot was written by Stephan Bosch <stephan at rename-it.nl>.
.PP
Dovecot was written by Timo Sirainen <tss at iki.fi>.
.SH "SEE ALSO"
.BR sievec (1),
.BR sieved (1)