Don't quote symbols 'like-this' in docstrings

[gnus] / texi / sieve.texi

diff --git a/texi/sieve.texi b/texi/sieve.texi
index 45b7aa6..7bb8a4d 100644 (file)
--- a/texi/sieve.texi
+++ b/texi/sieve.texi
@@ -1,7 +1,10 @@
 \input texinfo                  @c -*-texinfo-*-
 
 \input texinfo                  @c -*-texinfo-*-
 

-@setfilename sieve
+@include gnus-overrides.texi
+
+@setfilename sieve.info

 @settitle Emacs Sieve Manual
 @settitle Emacs Sieve Manual

+@include docstyle.texi

 @synindex fn cp
 @synindex vr cp
 @synindex pg cp
 @synindex fn cp
 @synindex vr cp
 @synindex pg cp


@@ -9,24 +12,22 @@
 @copying
 This file documents the Emacs Sieve package, for server-side mail filtering.
 
 @copying
 This file documents the Emacs Sieve package, for server-side mail filtering.
 

-Copyright @copyright{} 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009
-Free Software Foundation, Inc.
+Copyright @copyright{} 2001--2015 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
 
 @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'',
+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
 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.''
+modify this GNU manual.''

 @end quotation
 @end copying
 
 @end quotation
 @end copying
 

-@dircategory Emacs
+@dircategory Emacs network features

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


@@ -36,7 +37,12 @@ developing GNU and promoting software freedom.''
 @setchapternewpage odd
 
 @titlepage
 @setchapternewpage odd
 
 @titlepage

+@ifset WEBHACKDEVEL
+@title Emacs Sieve Manual (DEVELOPMENT VERSION)
+@end ifset
+@ifclear WEBHACKDEVEL

 @title Emacs Sieve Manual
 @title Emacs Sieve Manual

+@end ifclear

 
 @author by Simon Josefsson
 @page
 
 @author by Simon Josefsson
 @page


@@ -44,13 +50,13 @@ developing GNU and promoting software freedom.''
 @insertcopying
 @end titlepage
 
 @insertcopying
 @end titlepage
 

+@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.
 


@@ -58,7 +64,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.


@@ -142,7 +150,7 @@ When a server has been successfully contacted, the Manage Sieve buffer
 looks something like:
 
 @example
 looks something like:
 
 @example

-Server  : mailserver:2000
+Server  : mailserver:sieve

 
 2 scripts on server, press RET on a script name edits it, or
 press RET on <new script> to create a new script.
 
 2 scripts on server, press RET on a script name edits it, or
 press RET on <new script> to create a new script.


@@ -152,7 +160,7 @@ press RET on <new script> to create a new script.
 @end example
 
 One of the scripts are highlighted, and standard point navigation
 @end example
 
 One of the scripts are highlighted, and standard point navigation

-commands (@kbd{<up>}, @kbd{<down>} etc) can be used to navigate the
+commands (@kbd{<up>}, @kbd{<down>} etc.)@: can be used to navigate the

 list.
 
 The following commands are available in the Manage Sieve buffer:
 list.
 
 The following commands are available in the Manage Sieve buffer:


@@ -205,7 +213,12 @@ Bury the Manage Sieve buffer without closing the connection.
 @kindex ?
 @kindex h
 @findex sieve-help
 @kindex ?
 @kindex h
 @findex sieve-help

-Displays help in the minibuffer. 
+Displays help in the minibuffer.
+
+@item Q
+@kindex Q
+@findex sieve-manage-quit
+Quit Manage Sieve and close the connection.

 
 @end table
 
 
 @end table
 


@@ -226,7 +239,7 @@ 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
 


@@ -237,7 +250,7 @@ required.
 
 @example
 if header :contains "Delivered-To" "auc-tex@@sunsite.dk" @{
 
 @example
 if header :contains "Delivered-To" "auc-tex@@sunsite.dk" @{

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

 @}
 @end example
 
 @}
 @end example
 


@@ -248,7 +261,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
 


@@ -263,10 +276,6 @@ 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-default-port
 @vindex sieve-manage-default-port
 Sets the default port to use, the suggested port number is @code{2000}.


@@ -339,7 +348,7 @@ lists the relevant ones.  They can all be fetched from
 @item RFC3028
 Sieve: A Mail Filtering Language.
 
 @item RFC3028
 Sieve: A Mail Filtering Language.
 

-@item draft-martin-managesieve-03
+@item RFC5804

 A Protocol for Remotely Managing Sieve Scripts
 
 @end table
 A Protocol for Remotely Managing Sieve Scripts
 
 @end table


@@ -352,12 +361,6 @@ A Protocol for Remotely Managing Sieve Scripts
 @unnumbered Index
 @printindex cp
 
 @unnumbered Index
 @printindex cp
 

-@summarycontents
-@contents

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

-
-@ignore
-   arch-tag: 6e3ad0af-2eaf-4f35-a081-d40f4a683ec3
-@end ignore