Synch with the Emacs trunk.
[gnus] / lisp / sieve-mode.el
1 ;;; sieve-mode.el --- Sieve code editing commands for Emacs
2
3 ;; Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009
4 ;;   Free Software Foundation, Inc.
5
6 ;; Author: Simon Josefsson <simon@josefsson.org>
7
8 ;; This file is part of GNU Emacs.
9
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.
14
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.
19
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/>.
22
23 ;;; Commentary:
24
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.
29 ;;
30 ;; Put something similar to the following in your .emacs to use this file:
31 ;;
32 ;; (load "~/lisp/sieve")
33 ;; (setq auto-mode-alist (cons '("\\.siv\\'" . sieve-mode) auto-mode-alist))
34 ;;
35 ;; References:
36 ;;
37 ;; RFC 3028,
38 ;; "Sieve: A Mail Filtering Language",
39 ;; by Tim Showalter.
40 ;;
41 ;; Release history:
42 ;;
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
47
48 ;;; Code:
49
50 (autoload 'sieve-manage "sieve")
51 (autoload 'sieve-upload "sieve")
52 (require 'easymenu)
53 (eval-when-compile
54   (require 'font-lock))
55
56 (defgroup sieve nil
57   "Sieve."
58   :group 'languages)
59
60 (defcustom sieve-mode-hook nil
61   "Hook run in sieve mode buffers."
62   :group 'sieve
63   :type 'hook)
64
65 ;; Font-lock
66
67 (defvar sieve-control-commands-face 'sieve-control-commands
68   "Face name used for Sieve Control Commands.")
69
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)
81 (put 'sieve-control-commands-face 'obsolete-face "22.1")
82
83 (defvar sieve-action-commands-face 'sieve-action-commands
84   "Face name used for Sieve Action Commands.")
85
86 (defface sieve-action-commands
87   '((((type tty) (class color)) (:foreground "blue" :weight bold))
88     (((class color) (background light)) (:foreground "Blue"))
89     (((class color) (background dark)) (:foreground "LightSkyBlue"))
90     (t (:inverse-video t :bold t)))
91   "Face used for Sieve Action Commands."
92   :group 'sieve)
93 ;; backward-compatibility alias
94 (put 'sieve-action-commands-face 'face-alias 'sieve-action-commands)
95 (put 'sieve-action-commands-face 'obsolete-face "22.1")
96
97 (defvar sieve-test-commands-face 'sieve-test-commands
98   "Face name used for Sieve Test Commands.")
99
100 (defface sieve-test-commands
101   '((((type tty) (class color)) (:foreground "magenta"))
102     (((class grayscale) (background light))
103      (:foreground "LightGray" :bold t :underline t))
104     (((class grayscale) (background dark))
105      (:foreground "Gray50" :bold t :underline t))
106     (((class color) (background light)) (:foreground "CadetBlue"))
107     (((class color) (background dark)) (:foreground "Aquamarine"))
108     (t (:bold t :underline t)))
109   "Face used for Sieve Test Commands."
110   :group 'sieve)
111 ;; backward-compatibility alias
112 (put 'sieve-test-commands-face 'face-alias 'sieve-test-commands)
113 (put 'sieve-test-commands-face 'obsolete-face "22.1")
114
115 (defvar sieve-tagged-arguments-face 'sieve-tagged-arguments
116   "Face name used for Sieve Tagged Arguments.")
117
118 (defface sieve-tagged-arguments
119   '((((type tty) (class color)) (:foreground "cyan" :weight bold))
120     (((class grayscale) (background light)) (:foreground "LightGray" :bold t))
121     (((class grayscale) (background dark)) (:foreground "DimGray" :bold t))
122     (((class color) (background light)) (:foreground "Purple"))
123     (((class color) (background dark)) (:foreground "Cyan"))
124     (t (:bold t)))
125   "Face used for Sieve Tagged Arguments."
126   :group 'sieve)
127 ;; backward-compatibility alias
128 (put 'sieve-tagged-arguments-face 'face-alias 'sieve-tagged-arguments)
129 (put 'sieve-tagged-arguments-face 'obsolete-face "22.1")
130
131
132 (defconst sieve-font-lock-keywords
133   (eval-when-compile
134     (list
135      ;; control commands
136      (cons (regexp-opt '("require" "if" "else" "elsif" "stop"))
137            'sieve-control-commands-face)
138      ;; action commands
139      (cons (regexp-opt '("fileinto" "redirect" "reject" "keep" "discard"))
140            'sieve-action-commands-face)
141      ;; test commands
142      (cons (regexp-opt '("address" "allof" "anyof" "exists" "false"
143                          "true" "header" "not" "size" "envelope"))
144            'sieve-test-commands-face)
145      (cons "\\Sw+:\\sw+"
146            'sieve-tagged-arguments-face))))
147
148 ;; Syntax table
149
150 (defvar sieve-mode-syntax-table nil
151   "Syntax table in use in sieve-mode buffers.")
152
153 (if sieve-mode-syntax-table
154     ()
155   (setq sieve-mode-syntax-table (make-syntax-table))
156   (modify-syntax-entry ?\\ "\\" sieve-mode-syntax-table)
157   (modify-syntax-entry ?\n ">   " sieve-mode-syntax-table)
158   (modify-syntax-entry ?\f ">   " 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)
168   (modify-syntax-entry ?& "." sieve-mode-syntax-table)
169   (modify-syntax-entry ?| "." sieve-mode-syntax-table)
170   (modify-syntax-entry ?_ "_" sieve-mode-syntax-table)
171   (modify-syntax-entry ?\' "\"" sieve-mode-syntax-table))
172
173 ;; Key map definition
174
175 (defvar sieve-mode-map
176   (let ((map (make-sparse-keymap)))
177     (define-key map "\C-c\C-l" 'sieve-upload)
178     (define-key map "\C-c\C-c" 'sieve-upload-and-bury)
179     (define-key map "\C-c\C-m" 'sieve-manage)
180     map)
181   "Key map used in sieve mode.")
182
183 ;; Menu definition
184
185 (defvar sieve-mode-menu nil
186   "Menubar used in sieve mode.")
187
188 ;; Code for Sieve editing mode.
189
190 ;;;###autoload
191 (define-derived-mode sieve-mode c-mode "Sieve"
192   "Major mode for editing Sieve code.
193 This is much like C mode except for the syntax of comments.  Its keymap
194 inherits from C mode's and it has the same variables for customizing
195 indentation.  It has its own abbrev table and its own syntax table.
196
197 Turning on Sieve mode runs `sieve-mode-hook'."
198   (set (make-local-variable 'paragraph-start) (concat "$\\|" page-delimiter))
199   (set (make-local-variable 'paragraph-separate) paragraph-start)
200   (set (make-local-variable 'comment-start) "#")
201   (set (make-local-variable 'comment-end) "")
202   ;;(set (make-local-variable 'comment-start-skip) "\\(^\\|\\s-\\);?#+ *")
203   (set (make-local-variable 'comment-start-skip) "#+ *")
204   (unless (featurep 'xemacs)
205     (set (make-local-variable 'font-lock-defaults)
206          '(sieve-font-lock-keywords nil nil ((?_ . "w")))))
207   (easy-menu-add-item nil nil sieve-mode-menu))
208
209 ;; Menu
210
211 (easy-menu-define sieve-mode-menu sieve-mode-map
212   "Sieve Menu."
213   '("Sieve"
214     ["Upload script" sieve-upload t]
215     ["Manage scripts on server" sieve-manage t]))
216
217 (provide 'sieve-mode)
218
219 ;; arch-tag: 3b8ab76d-065d-4c52-b1e8-ab2ec21f2ace
220 ;; sieve-mode.el ends here