(shr-tag-hr): New function.

[gnus] / texi / sieve.texi

diff --git a/texi/sieve.texi b/texi/sieve.texi
index f069dbb..f8f9b62 100644 (file)
--- a/texi/sieve.texi
+++ b/texi/sieve.texi
@@ -5,6 +5,27 @@
 @synindex fn cp
 @synindex vr cp
 @synindex pg cp
 @synindex fn cp
 @synindex vr cp
 @synindex pg cp

+
+@copying
+This file documents the Emacs Sieve package, for server-side mail filtering.
+
+Copyright @copyright{} 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008,
+2009, 2010  Free Software Foundation, Inc.
+
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3 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''.
+
+(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
+modify this GNU manual.  Buying copies from the FSF supports it in
+developing GNU and promoting software freedom.''
+@end quotation
+@end copying
+

 @dircategory Emacs
 @direntry
 * Sieve: (sieve).               Managing Sieve scripts in Emacs.
 @dircategory Emacs
 @direntry
 * Sieve: (sieve).               Managing Sieve scripts in Emacs.


@@ -14,68 +35,22 @@
 @end iftex
 @setchapternewpage odd
 
 @end iftex
 @setchapternewpage odd
 

-@ifnottex
-
-This file documents the Emacs Sieve package.
-
-Copyright (C) 2001 Free Software Foundation, Inc.
-
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1 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.
-@end ifnottex
-
-@tex
-

 @titlepage
 @title Emacs Sieve Manual
 
 @author by Simon Josefsson
 @page
 @titlepage
 @title Emacs Sieve Manual
 
 @author by Simon Josefsson
 @page

-

 @vskip 0pt plus 1filll
 @vskip 0pt plus 1filll

-Copyright @copyright{} 2001 Free Software Foundation, Inc.
-
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1 or
-any later version published by the Free Software Foundation; with the
-Invariant Sections being none, 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.
+@insertcopying

 @end titlepage
 @end titlepage

-@page

 
 

-@end tex
+@summarycontents
+@contents

 
 @node Top
 @top Sieve Support for Emacs
 
 
 @node Top
 @top 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
+This 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.
 
 as a reference manual for the @samp{sieve-manage} protocol Emacs Lisp
 API.
 


@@ -83,7 +58,9 @@ 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.
 
 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/}.
+@ifnottex
+@insertcopying
+@end ifnottex

 
 @menu
 * Installation::          Getting ready to use the package.
 
 @menu
 * Installation::          Getting ready to use the package.


@@ -92,6 +69,7 @@ A good online Sieve resources is @uref{http://www.cyrusoft.com/sieve/}.
 * 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.
 * 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.
 @end menu
 
 * Index::                 Function and variable index.
 @end menu
 


@@ -111,7 +89,7 @@ commands in your @code{~/.emacs}:
 (autoload 'sieve-mode "sieve-mode")
 @end lisp
 @lisp
 (autoload 'sieve-mode "sieve-mode")
 @end lisp
 @lisp

-(setq auto-mode-alist (cons '("\\.si\\(v\\|eve\\)\\'" . sieve-mode)
+(setq auto-mode-alist (cons '("\\.s\\(v\\|iv\\|ieve\\)\\'" . sieve-mode)

                             auto-mode-alist))
 @end lisp
 
                             auto-mode-alist))
 @end lisp
 


@@ -129,13 +107,13 @@ runs the hook @code{sieve-mode-hook}.
 @vindex 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
 @vindex 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 the variables for customizing
+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
 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. @pxref{Managing Sieve}.
+bindings to manage Sieve scripts remotely. @xref{Managing Sieve}.

 
 @table @kbd
 
 
 @table @kbd
 


@@ -162,7 +140,7 @@ 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.
 
 RET}, which queries the user for a server and if necessary, user
 credentials to use.
 

-When a server has been succesfully contacted, the Manage Sieve buffer
+When a server has been successfully contacted, the Manage Sieve buffer

 looks something like:
 
 @example
 looks something like:
 
 @example


@@ -250,18 +228,18 @@ the @code{fileinto} command.
 require "fileinto";
 
 if address "sender" "owner-w3-beta@@xemacs.org" @{
 require "fileinto";
 
 if address "sender" "owner-w3-beta@@xemacs.org" @{

-       fileinto "INBOX.w3-beta";
+        fileinto "INBOX.w3-beta";

 @}
 @end example
 
 @}
 @end 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
+A few mailing lists do not use the @samp{Sender:} header, but has a
+unique identifier in some other header.  The following is not a
+complete script, it assumes that @code{fileinto} has already been

 required.
 
 @example
 if header :contains "Delivered-To" "auc-tex@@sunsite.dk" @{
 required.
 
 @example
 if header :contains "Delivered-To" "auc-tex@@sunsite.dk" @{

-       fileinto "INBOX.auc-tex";
+        fileinto "INBOX.auc-tex";

 @}
 @end example
 
 @}
 @end example
 


@@ -272,7 +250,7 @@ has been required.
 
 @example
 if address ["to", "cc"] "kerberos@@mit.edu" @{
 
 @example
 if address ["to", "cc"] "kerberos@@mit.edu" @{

-       fileinto "INBOX.kerberos";
+        fileinto "INBOX.kerberos";

 @}
 @end example
 
 @}
 @end example
 


@@ -287,17 +265,13 @@ in the @code{sieve} group (@kbd{M-x customize-group RET sieve RET}):
 
 @table @code
 
 
 @table @code
 

-@item sieve-manage-default-user
-@vindex sieve-manage-default-user
-Sets the default username.
-

 @item sieve-manage-default-port
 @vindex sieve-manage-default-port
 Sets the default port to use, the suggested port number is @code{2000}.
 
 @item sieve-manage-log
 @vindex sieve-manage-log
 @item sieve-manage-default-port
 @vindex sieve-manage-default-port
 Sets the default port to use, the suggested port number is @code{2000}.
 
 @item sieve-manage-log
 @vindex sieve-manage-log

-If non-nil, should be a string naming a buffer where a protocol trace
+If non-@code{nil}, should be a string naming a buffer where a protocol trace

 is dumped (for debugging purposes).
 
 @end table
 is dumped (for debugging purposes).
 
 @end table


@@ -325,7 +299,7 @@ Authenticate to the server.
 
 @item sieve-manage-capability
 @findex sieve-manage-capability
 
 @item sieve-manage-capability
 @findex sieve-manage-capability

-Return a list of capabilities the server support.
+Return a list of capabilities the server supports.

 
 @item sieve-manage-listscripts
 @findex sieve-manage-listscripts
 
 @item sieve-manage-listscripts
 @findex sieve-manage-listscripts


@@ -333,7 +307,8 @@ List scripts on the server.
 
 @item sieve-manage-havespace
 @findex sieve-manage-havespace
 
 @item sieve-manage-havespace
 @findex sieve-manage-havespace

-Returns non-nil iff server have roam for a script of given size.
+Return non-@code{nil} if the server has room for a script of given
+size.

 
 @item sieve-manage-getscript
 @findex sieve-manage-getscript
 
 @item sieve-manage-getscript
 @findex sieve-manage-getscript


@@ -355,7 +330,7 @@ Indicate which script on the server should be active.
 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
 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

-@samp{http://quimby.gnus.org/notes/}.
+@uref{http://quimby.gnus.org/notes/}.

 
 @table @dfn
 
 
 @table @dfn
 


@@ -367,13 +342,14 @@ A Protocol for Remotely Managing Sieve Scripts
 
 @end table
 
 
 @end table
 

+@node GNU Free Documentation License
+@appendix GNU Free Documentation License
+@include doclicense.texi

 
 @node Index
 
 @node Index

-@chapter Index
+@unnumbered Index

 @printindex cp
 
 @printindex cp
 

-@summarycontents
-@contents

 @bye
 
 @c End:
 @bye
 
 @c End: