[Emacs-diffs] Changes to sieve.texi

[Glenn Morris]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Glenn Morris <gm>       07/09/06 04:40:30

Index: sieve.texi
===================================================================
RCS file: sieve.texi
diff -N sieve.texi
--- sieve.texi  13 Aug 2007 13:41:22 -0000      1.10
+++ /dev/null   1 Jan 1970 00:00:00 -0000
@@ -1,369 +0,0 @@
-\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