Docstring improvement.
[emacs.git] / lisp / gnus / sieve-mode.el
blob49b4caff160106541b0e2100f8965b145b570389
1 ;;; sieve-mode.el --- Sieve code editing commands for Emacs
3 ;; Copyright (C) 2001, 2002, 2003, 2004, 2005,
4 ;; 2006, 2007, 2008 Free Software Foundation, Inc.
6 ;; Author: Simon Josefsson <simon@josefsson.org>
8 ;; This file is part of GNU Emacs.
10 ;; GNU Emacs is free software: you can redistribute it and/or modify
11 ;; it under the terms of the GNU General Public License as published by
12 ;; the Free Software Foundation, either version 3 of the License, or
13 ;; (at your option) any later version.
15 ;; GNU Emacs is distributed in the hope that it will be useful,
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 ;; GNU General Public License for more details.
20 ;; You should have received a copy of the GNU General Public License
21 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
23 ;;; Commentary:
25 ;; This file contain editing mode functions and font-lock support for
26 ;; editing Sieve scripts. It sets up C-mode with support for
27 ;; sieve-style #-comments and a lightly hacked syntax table. It was
28 ;; strongly influenced by awk-mode.el.
30 ;; Put something similar to the following in your .emacs to use this file:
32 ;; (load "~/lisp/sieve")
33 ;; (setq auto-mode-alist (cons '("\\.siv\\'" . sieve-mode) auto-mode-alist))
35 ;; References:
37 ;; RFC 3028,
38 ;; "Sieve: A Mail Filtering Language",
39 ;; by Tim Showalter.
41 ;; Release history:
43 ;; 2001-03-02 version 1.0 posted to gnu.emacs.sources
44 ;; version 1.1 change file extension into ".siv" (official one)
45 ;; added keymap and menubar to hook into sieve-manage
46 ;; 2001-10-31 version 1.2 committed to Oort Gnus
48 ;;; Code:
50 (autoload 'sieve-manage "sieve")
51 (autoload 'sieve-upload "sieve")
52 (require 'easymenu)
53 (eval-when-compile
54 (require 'font-lock))
56 (defgroup sieve nil
57 "Sieve."
58 :group 'languages)
60 (defcustom sieve-mode-hook nil
61 "Hook run in sieve mode buffers."
62 :group 'sieve
63 :type 'hook)
65 ;; Font-lock
67 (defvar sieve-control-commands-face 'sieve-control-commands
68 "Face name used for Sieve Control Commands.")
70 (defface sieve-control-commands
71 '((((type tty) (class color)) (:foreground "blue" :weight light))
72 (((class grayscale) (background light)) (:foreground "LightGray" :bold t))
73 (((class grayscale) (background dark)) (:foreground "DimGray" :bold t))
74 (((class color) (background light)) (:foreground "Orchid"))
75 (((class color) (background dark)) (:foreground "LightSteelBlue"))
76 (t (:bold t)))
77 "Face used for Sieve Control Commands."
78 :group 'sieve)
79 ;; backward-compatibility alias
80 (put 'sieve-control-commands-face 'face-alias 'sieve-control-commands)
82 (defvar sieve-action-commands-face 'sieve-action-commands
83 "Face name used for Sieve Action Commands.")
85 (defface sieve-action-commands
86 '((((type tty) (class color)) (:foreground "blue" :weight bold))
87 (((class color) (background light)) (:foreground "Blue"))
88 (((class color) (background dark)) (:foreground "LightSkyBlue"))
89 (t (:inverse-video t :bold t)))
90 "Face used for Sieve Action Commands."
91 :group 'sieve)
92 ;; backward-compatibility alias
93 (put 'sieve-action-commands-face 'face-alias 'sieve-action-commands)
95 (defvar sieve-test-commands-face 'sieve-test-commands
96 "Face name used for Sieve Test Commands.")
98 (defface sieve-test-commands
99 '((((type tty) (class color)) (:foreground "magenta"))
100 (((class grayscale) (background light))
101 (:foreground "LightGray" :bold t :underline t))
102 (((class grayscale) (background dark))
103 (:foreground "Gray50" :bold t :underline t))
104 (((class color) (background light)) (:foreground "CadetBlue"))
105 (((class color) (background dark)) (:foreground "Aquamarine"))
106 (t (:bold t :underline t)))
107 "Face used for Sieve Test Commands."
108 :group 'sieve)
109 ;; backward-compatibility alias
110 (put 'sieve-test-commands-face 'face-alias 'sieve-test-commands)
112 (defvar sieve-tagged-arguments-face 'sieve-tagged-arguments
113 "Face name used for Sieve Tagged Arguments.")
115 (defface sieve-tagged-arguments
116 '((((type tty) (class color)) (:foreground "cyan" :weight bold))
117 (((class grayscale) (background light)) (:foreground "LightGray" :bold t))
118 (((class grayscale) (background dark)) (:foreground "DimGray" :bold t))
119 (((class color) (background light)) (:foreground "Purple"))
120 (((class color) (background dark)) (:foreground "Cyan"))
121 (t (:bold t)))
122 "Face used for Sieve Tagged Arguments."
123 :group 'sieve)
124 ;; backward-compatibility alias
125 (put 'sieve-tagged-arguments-face 'face-alias 'sieve-tagged-arguments)
128 (defconst sieve-font-lock-keywords
129 (eval-when-compile
130 (list
131 ;; control commands
132 (cons (regexp-opt '("require" "if" "else" "elsif" "stop"))
133 'sieve-control-commands-face)
134 ;; action commands
135 (cons (regexp-opt '("fileinto" "redirect" "reject" "keep" "discard"))
136 'sieve-action-commands-face)
137 ;; test commands
138 (cons (regexp-opt '("address" "allof" "anyof" "exists" "false"
139 "true" "header" "not" "size" "envelope"))
140 'sieve-test-commands-face)
141 (cons "\\Sw+:\\sw+"
142 'sieve-tagged-arguments-face))))
144 ;; Syntax table
146 (defvar sieve-mode-syntax-table nil
147 "Syntax table in use in sieve-mode buffers.")
149 (if sieve-mode-syntax-table
151 (setq sieve-mode-syntax-table (make-syntax-table))
152 (modify-syntax-entry ?\\ "\\" sieve-mode-syntax-table)
153 (modify-syntax-entry ?\n "> " sieve-mode-syntax-table)
154 (modify-syntax-entry ?\f "> " sieve-mode-syntax-table)
155 (modify-syntax-entry ?\# "< " sieve-mode-syntax-table)
156 (modify-syntax-entry ?/ "." sieve-mode-syntax-table)
157 (modify-syntax-entry ?* "." sieve-mode-syntax-table)
158 (modify-syntax-entry ?+ "." sieve-mode-syntax-table)
159 (modify-syntax-entry ?- "." sieve-mode-syntax-table)
160 (modify-syntax-entry ?= "." sieve-mode-syntax-table)
161 (modify-syntax-entry ?% "." sieve-mode-syntax-table)
162 (modify-syntax-entry ?< "." sieve-mode-syntax-table)
163 (modify-syntax-entry ?> "." sieve-mode-syntax-table)
164 (modify-syntax-entry ?& "." sieve-mode-syntax-table)
165 (modify-syntax-entry ?| "." sieve-mode-syntax-table)
166 (modify-syntax-entry ?_ "_" sieve-mode-syntax-table)
167 (modify-syntax-entry ?\' "\"" sieve-mode-syntax-table))
169 ;; Key map definition
171 (defvar sieve-mode-map
172 (let ((map (make-sparse-keymap)))
173 (define-key map "\C-c\C-l" 'sieve-upload)
174 (define-key map "\C-c\C-c" 'sieve-upload-and-bury)
175 (define-key map "\C-c\C-m" 'sieve-manage)
176 map)
177 "Key map used in sieve mode.")
179 ;; Menu definition
181 (defvar sieve-mode-menu nil
182 "Menubar used in sieve mode.")
184 ;; Code for Sieve editing mode.
186 ;;;###autoload
187 (define-derived-mode sieve-mode c-mode "Sieve"
188 "Major mode for editing Sieve code.
189 This is much like C mode except for the syntax of comments. Its keymap
190 inherits from C mode's and it has the same variables for customizing
191 indentation. It has its own abbrev table and its own syntax table.
193 Turning on Sieve mode runs `sieve-mode-hook'."
194 (set (make-local-variable 'paragraph-start) (concat "$\\|" page-delimiter))
195 (set (make-local-variable 'paragraph-separate) paragraph-start)
196 (set (make-local-variable 'comment-start) "#")
197 (set (make-local-variable 'comment-end) "")
198 ;;(set (make-local-variable 'comment-start-skip) "\\(^\\|\\s-\\);?#+ *")
199 (set (make-local-variable 'comment-start-skip) "#+ *")
200 (unless (featurep 'xemacs)
201 (set (make-local-variable 'font-lock-defaults)
202 '(sieve-font-lock-keywords nil nil ((?_ . "w")))))
203 (easy-menu-add-item nil nil sieve-mode-menu))
205 ;; Menu
207 (easy-menu-define sieve-mode-menu sieve-mode-map
208 "Sieve Menu."
209 '("Sieve"
210 ["Upload script" sieve-upload t]
211 ["Manage scripts on server" sieve-manage t]))
213 (provide 'sieve-mode)
215 ;; arch-tag: 3b8ab76d-065d-4c52-b1e8-ab2ec21f2ace
216 ;; sieve-mode.el ends here