emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] Changes to sieve.texi


From: Glenn Morris
Subject: [Emacs-diffs] Changes to sieve.texi
Date: Thu, 06 Sep 2007 05:02:11 +0000

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Glenn Morris <gm>       07/09/06 05:02:11

Index: sieve.texi
===================================================================
RCS file: sieve.texi
diff -N sieve.texi
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ sieve.texi  6 Sep 2007 05:02:11 -0000       1.1
@@ -0,0 +1,369 @@
+\input texinfo                  @c -*-texinfo-*-
+
address@hidden ../info/sieve
address@hidden Emacs Sieve Manual
address@hidden fn cp
address@hidden vr cp
address@hidden pg cp
+
address@hidden
+This file documents the Emacs Sieve package, for server-side mail filtering.
+
+Copyright @copyright{} 2001, 2002, 2003, 2004, 2005, 2006, 2007
+Free Software Foundation, Inc.
+
address@hidden
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, with the Front-Cover texts being ``A GNU
+Manual'', and with the Back-Cover Texts as in (a) below.  A copy of the
+license is included in the section entitled ``GNU Free Documentation
+License'' in the Emacs manual.
+
+(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
+this GNU Manual, like GNU software.  Copies published by the Free
+Software Foundation raise funds for GNU development.''
+
+This document is part of a collection distributed under the GNU Free
+Documentation License.  If you want to distribute this document
+separately from the collection, you can do so by adding a copy of the
+license to the document, as described in section 6 of the license.
address@hidden quotation
address@hidden copying
+
address@hidden Emacs
address@hidden
+* Sieve: (sieve).               Managing Sieve scripts in Emacs.
address@hidden direntry
address@hidden
address@hidden
address@hidden iftex
address@hidden odd
+
address@hidden
address@hidden Emacs Sieve Manual
+
address@hidden by Simon Josefsson
address@hidden
address@hidden 0pt plus 1filll
address@hidden
address@hidden titlepage
+
+
address@hidden Top
address@hidden Sieve Support for Emacs
+
+This manual documents the Emacs Sieve package.
+
+It is intended as a users manual for Sieve Mode and Manage Sieve, and
+as a reference manual for the @samp{sieve-manage} protocol Emacs Lisp
+API.
+
+Sieve is a language for server-side filtering of mail.  The language
+is documented in RFC 3028.  This manual does not attempt to document
+the language, so keep RFC 3028 around.
+
+A good online Sieve resources is @uref{http://www.cyrusoft.com/sieve/}.
+
address@hidden
+* Installation::          Getting ready to use the package.
+* Sieve Mode::            Editing Sieve scripts.
+* Managing Sieve::        Managing Sieve scripts on a remote server.
+* Examples ::             A few Sieve code snippets.
+* Manage Sieve API ::     Interfacing to the Manage Sieve Protocol API.
+* Standards::             A summary of RFCs and working documents used.
+* GNU Free Documentation License:: The license for this documentation.
+* Index::                 Function and variable index.
address@hidden menu
+
+
address@hidden Installation
address@hidden Installation
address@hidden Install
address@hidden Setup
+
+The Sieve package should come with your Emacs version, and should be
+ready for use directly.
+
+However, to manually set up the package you can put the following
+commands in your @code{~/.emacs}:
+
address@hidden
+(autoload 'sieve-mode "sieve-mode")
address@hidden lisp
address@hidden
+(setq auto-mode-alist (cons '("\\.s\\(v\\|iv\\|ieve\\)\\'" . sieve-mode)
+                            auto-mode-alist))
address@hidden lisp
+
+
address@hidden Sieve Mode
address@hidden Sieve Mode
+
+Sieve mode provides syntax-based indentation, font-locking support and
+other handy functions to make editing Sieve scripts easier.
+
+Use @samp{M-x sieve-mode} to switch to this major mode.  This command
+runs the hook @code{sieve-mode-hook}.
+
address@hidden sieve-mode-map
address@hidden sieve-mode-syntax-table
+Sieve mode is derived from @code{c-mode}, and is very similar except
+for the syntax of comments.  The keymap (@code{sieve-mode-map}) is
+inherited from @code{c-mode}, as are the variables for customizing
+indentation.  Sieve mode has its own abbrev table
+(@code{sieve-mode-abbrev-table}) and syntax table
+(@code{sieve-mode-syntax-table}).
+
+In addition to the editing utility functions, Sieve mode also contains
+bindings to manage Sieve scripts remotely. @xref{Managing Sieve}.
+
address@hidden @kbd
+
address@hidden C-c RET
address@hidden C-c RET
address@hidden sieve-manage
address@hidden manage remote sieve script
+Open a connection to a remote server using the Managesieve protocol.
+
address@hidden C-c C-l
address@hidden C-c C-l
address@hidden sieve-upload
address@hidden upload sieve script
+Upload the Sieve script to the currently open server.
+
address@hidden table
+
+
address@hidden Managing Sieve
address@hidden Managing Sieve
+
+Manage Sieve is a special mode used to display Sieve scripts available
+on a remote server.  It can be invoked with @kbd{M-x sieve-manage
+RET}, which queries the user for a server and if necessary, user
+credentials to use.
+
+When a server has been successfully contacted, the Manage Sieve buffer
+looks something like:
+
address@hidden
+Server  : mailserver:2000
+
+2 scripts on server, press RET on a script name edits it, or
+press RET on <new script> to create a new script.
+        <new script>
+ ACTIVE .sieve
+        template.siv
address@hidden example
+
+One of the scripts are highlighted, and standard point navigation
+commands (@kbd{<up>}, @kbd{<down>} etc) can be used to navigate the
+list.
+
+The following commands are available in the Manage Sieve buffer:
+
address@hidden @kbd
+
address@hidden m
address@hidden m
address@hidden sieve-activate
+Activates the currently highlighted script.
+
address@hidden u
address@hidden u
address@hidden sieve-deactivate
+Deactivates the currently highlighted script.
+
address@hidden C-M-?
address@hidden C-M-?
address@hidden sieve-deactivate-all
+Deactivates all scripts.
+
address@hidden r
address@hidden r
address@hidden sieve-remove
+Remove currently highlighted script.
+
address@hidden RET
address@hidden mouse-2
address@hidden f
address@hidden RET
address@hidden mouse-2
address@hidden f
address@hidden sieve-edit-script
+Bury the server buffer and download the currently highlighted script
+into a new buffer for editing in Sieve mode (@pxref{Sieve Mode}).
+
address@hidden o
address@hidden o
address@hidden sieve-edit-script-other-window
+Create a new buffer in another window containing the currently
+highlighted script for editing in Sieve mode (@pxref{Sieve Mode}).
+
address@hidden q
address@hidden q
address@hidden sieve-bury-buffer
+Bury the Manage Sieve buffer without closing the connection.
+
address@hidden ?
address@hidden h
address@hidden ?
address@hidden h
address@hidden sieve-help
+Displays help in the minibuffer. 
+
address@hidden table
+
address@hidden Examples
address@hidden Examples
+
+If you are not familiar with Sieve, this chapter contains a few simple
+code snippets that you can cut'n'paste and modify at will, until you
+feel more comfortable with the Sieve language to write the rules from
+scratch.
+
+The following complete Sieve script places all messages with a matching
address@hidden:} header into the given mailbox.  Many mailing lists uses
+this format.  The first line makes sure your Sieve server understands
+the @code{fileinto} command.
+
address@hidden
+require "fileinto";
+
+if address "sender" "owner-w3-beta@@xemacs.org" @{
+       fileinto "INBOX.w3-beta";
address@hidden
address@hidden example
+
+A few mailing lists do not use the @samp{Sender:} header, but does
+contain some unique identifier in some other header.  The following is
+not a complete script, it assumes that @code{fileinto} has already been
+required.
+
address@hidden
+if header :contains "Delivered-To" "auc-tex@@sunsite.dk" @{
+       fileinto "INBOX.auc-tex";
address@hidden
address@hidden example
+
+At last, we have the hopeless mailing lists that does not have any
+unique identifier and you are forced to match on the @samp{To:} and
address@hidden headers.  As before, this snippet assumes that @code{fileinto}
+has been required.
+
address@hidden
+if address ["to", "cc"] "kerberos@@mit.edu" @{
+       fileinto "INBOX.kerberos";
address@hidden
address@hidden example
+
address@hidden Manage Sieve API
address@hidden Manage Sieve API
+
+The @file{sieve-manage.el} library contains low-level functionality
+for talking to a server with the @sc{managesieve} protocol.
+
+A number of user-visible variables exist, which all can be customized
+in the @code{sieve} group (@kbd{M-x customize-group RET sieve RET}):
+
address@hidden @code
+
address@hidden sieve-manage-default-user
address@hidden sieve-manage-default-user
+Sets the default username.
+
address@hidden sieve-manage-default-port
address@hidden sieve-manage-default-port
+Sets the default port to use, the suggested port number is @code{2000}.
+
address@hidden sieve-manage-log
address@hidden sieve-manage-log
+If address@hidden, should be a string naming a buffer where a protocol trace
+is dumped (for debugging purposes).
+
address@hidden table
+
+The API functions include:
+
address@hidden @code
+
address@hidden sieve-manage-open
address@hidden sieve-manage-open
+Open connection to managesieve server, returning a buffer to be used
+by all other API functions.
+
address@hidden sieve-manage-opened
address@hidden sieve-manage-opened
+Check if a server is open or not.
+
address@hidden sieve-manage-close
address@hidden sieve-manage-close
+Close a server connection.
+
address@hidden sieve-manage-authenticate
address@hidden sieve-manage-authenticate
+Authenticate to the server.
+
address@hidden sieve-manage-capability
address@hidden sieve-manage-capability
+Return a list of capabilities the server supports.
+
address@hidden sieve-manage-listscripts
address@hidden sieve-manage-listscripts
+List scripts on the server.
+
address@hidden sieve-manage-havespace
address@hidden sieve-manage-havespace
+Return address@hidden if the server has room for a script of given
+size.
+
address@hidden sieve-manage-getscript
address@hidden sieve-manage-getscript
+Download script from server.
+
address@hidden sieve-manage-putscript
address@hidden sieve-manage-putscript
+Upload script to server.
+
address@hidden sieve-manage-setactive
address@hidden sieve-manage-setactive
+Indicate which script on the server should be active.
+
address@hidden table
+
address@hidden Standards
address@hidden Standards
+
+The Emacs Sieve package implements all or parts of a small but
+hopefully growing number of RFCs and drafts documents.  This chapter
+lists the relevant ones.  They can all be fetched from
address@hidden://quimby.gnus.org/notes/}.
+
address@hidden @dfn
+
address@hidden RFC3028
+Sieve: A Mail Filtering Language.
+
address@hidden draft-martin-managesieve-03
+A Protocol for Remotely Managing Sieve Scripts
+
address@hidden table
+
address@hidden GNU Free Documentation License
address@hidden GNU Free Documentation License
address@hidden doclicense.texi
+
address@hidden Index
address@hidden Index
address@hidden cp
+
address@hidden
address@hidden
address@hidden
+
address@hidden End:
+
address@hidden
+   arch-tag: 6e3ad0af-2eaf-4f35-a081-d40f4a683ec3
address@hidden ignore




reply via email to

[Prev in Thread] Current Thread [Next in Thread]