Mercurial > emacs
annotate lisp/mail/supercite.el @ 19490:04b0c835c0eb
(caar, cadr, cdar, cddr): Definitiosn deleted.
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Sat, 23 Aug 1997 18:53:50 +0000 |
parents | 59dc7e0fc186 |
children | d5d9362aa189 |
rev | line source |
---|---|
4850 | 1 ;;; supercite.el --- minor mode for citing mail and news replies |
2 | |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
3 ;; Copyright (C) 1993, 1997 Free Software Foundation, Inc. |
12859
90c22a02c12b
(sc-attribs-extract-namestring): If name has <...>,
Richard M. Stallman <rms@gnu.org>
parents:
12425
diff
changeset
|
4 |
4850 | 5 ;; Author: 1993 Barry A. Warsaw, Century Computing, Inc. <bwarsaw@cen.com> |
17492 | 6 ;; Maintainer: supercite-help@python.org |
4850 | 7 ;; Created: February 1993 |
8 ;; Last Modified: 1993/09/22 18:58:46 | |
5140 | 9 ;; Keywords: mail, news |
4850 | 10 |
11 ;; supercite.el revision: 3.54 | |
12 | |
13 ;; This file is part of GNU Emacs. | |
14 | |
15 ;; GNU Emacs is free software; you can redistribute it and/or modify | |
16 ;; it under the terms of the GNU General Public License as published by | |
17 ;; the Free Software Foundation; either version 2, or (at your option) | |
18 ;; any later version. | |
19 | |
20 ;; GNU Emacs is distributed in the hope that it will be useful, | |
21 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
22 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
23 ;; GNU General Public License for more details. | |
24 | |
25 ;; You should have received a copy of the GNU General Public License | |
14169 | 26 ;; along with GNU Emacs; see the file COPYING. If not, write to the |
27 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330, | |
28 ;; Boston, MA 02111-1307, USA. | |
4850 | 29 |
30 ;; LCD Archive Entry | |
31 ;; supercite|Barry A. Warsaw|supercite-help@anthem.nlm.nih.gov | |
32 ;; |Mail and news reply citation package | |
33 ;; |1993/09/22 18:58:46|3.1| | |
34 | |
35 ;; Code: | |
36 | |
37 | |
38 (require 'regi) | |
39 | |
40 ;; start user configuration variables | |
41 ;; vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv | |
42 | |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
43 (defgroup supercite nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
44 "Supercite package" |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
45 :prefix "sc-" |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
46 :group 'mail |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
47 :group 'news) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
48 |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
49 (defgroup supercite-frames nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
50 "Supercite (regi) frames" |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
51 :prefix "sc-" |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
52 :group 'supercite) |
4850 | 53 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
54 (defgroup supercite-attr nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
55 "Supercite attributions" |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
56 :prefix "sc-" |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
57 :group 'supercite) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
58 |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
59 (defgroup supercite-cite nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
60 "Supercite citings" |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
61 :prefix "sc-" |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
62 :group 'supercite) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
63 |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
64 (defgroup supercite-hooks nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
65 "Hooking into supercite" |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
66 :prefix "sc-" |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
67 :group 'supercite) |
4850 | 68 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
69 (defcustom sc-auto-fill-region-p t |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
70 "*If non-nil, automatically fill each paragraph after it has been cited." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
71 :type 'boolean |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
72 :group 'supercite) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
73 |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
74 (defcustom sc-blank-lines-after-headers 1 |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
75 "*Number of blank lines to leave after mail headers have been nuked. |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
76 Set to nil, to use whatever blank lines happen to occur naturally." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
77 :type '(choice (const :tag "leave" nil) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
78 integer) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
79 :group 'supercite) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
80 |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
81 (defcustom sc-citation-leader " " |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
82 "*String comprising first part of a citation." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
83 :type 'string |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
84 :group 'supercite-cite) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
85 |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
86 (defcustom sc-citation-delimiter ">" |
4850 | 87 "*String comprising third part of a citation. |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
88 This string is used in both nested and non-nested citations." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
89 :type 'string |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
90 :group 'supercite-cite) |
4850 | 91 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
92 (defcustom sc-citation-separator " " |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
93 "*String comprising fourth and last part of a citation." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
94 :type 'string |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
95 :group 'supercite-cite) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
96 |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
97 (defcustom sc-citation-leader-regexp "[ \t]*" |
4850 | 98 "*Regexp describing citation leader for a cited line. |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
99 This should NOT have a leading `^' character." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
100 :type 'regexp |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
101 :group 'supercite-cite) |
4850 | 102 |
103 ;; Nemacs and Mule users note: please see the texinfo manual for | |
104 ;; suggestions on setting these variables. | |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
105 (defcustom sc-citation-root-regexp "[-._a-zA-Z0-9]*" |
4850 | 106 "*Regexp describing variable root part of a citation for a cited line. |
107 This should NOT have a leading `^' character. See also | |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
108 `sc-citation-nonnested-root-regexp'." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
109 :type 'regexp |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
110 :group 'supercite-cite) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
111 |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
112 (defcustom sc-citation-nonnested-root-regexp "[-._a-zA-Z0-9]+" |
4850 | 113 "*Regexp describing the variable root part of a nested citation. |
114 This should NOT have a leading `^' character. This variable is | |
14007
c6476f4bb121
(sc-citation-nonnested-root-regexp,
Karl Heuer <kwzh@gnu.org>
parents:
13813
diff
changeset
|
115 related to `sc-citation-root-regexp' but whereas that variable |
4850 | 116 describes both nested and non-nested citation roots, this variable |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
117 describes only nested citation roots." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
118 :type 'regexp |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
119 :group 'supercite-cite) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
120 |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
121 (defcustom sc-citation-delimiter-regexp "[>]+" |
4850 | 122 "*Regexp describing citation delimiter for a cited line. |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
123 This should NOT have a leading `^' character." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
124 :type 'regexp |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
125 :group 'supercite-cite) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
126 |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
127 (defcustom sc-citation-separator-regexp "[ \t]*" |
4850 | 128 "*Regexp describing citation separator for a cited line. |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
129 This should NOT have a leading `^' character." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
130 :type 'regexp |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
131 :group 'supercite-cite) |
4850 | 132 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
133 (defcustom sc-cite-blank-lines-p nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
134 "*If non-nil, put a citation on blank lines." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
135 :type 'boolean |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
136 :group 'supercite-cite) |
4850 | 137 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
138 (defcustom sc-cite-frame-alist '() |
4850 | 139 "*Alist for frame selection during citing. |
140 Each element of this list has the following form: | |
141 (INFOKEY ((REGEXP . FRAME) | |
142 (REGEXP . FRAME) | |
143 (...))) | |
144 | |
145 Where INFOKEY is a key for `sc-mail-field', REGEXP is a regular | |
146 expression to match against the INFOKEY's value. FRAME is a citation | |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
147 frame, or a variable containing a citation frame." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
148 :type '(repeat (list symbol (repeat (cons regexp |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
149 (choice (repeat (repeat sexp)) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
150 symbol))))) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
151 :group 'supercite-frames) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
152 |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
153 (defcustom sc-uncite-frame-alist '() |
4850 | 154 "*Alist for frame selection during unciting. |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
155 See the variable `sc-cite-frame-alist' for details." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
156 :type '(repeat (list symbol (repeat (cons regexp |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
157 (choice (repeat (repeat sexp)) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
158 symbol))))) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
159 :group 'supercite-frames) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
160 |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
161 (defcustom sc-recite-frame-alist '() |
4850 | 162 "*Alist for frame selection during reciting. |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
163 See the variable `sc-cite-frame-alist' for details." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
164 :type '(repeat (list symbol (repeat (cons regexp |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
165 (choice (repeat (repeat sexp)) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
166 symbol))))) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
167 :group 'supercite-frames) |
4850 | 168 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
169 (defcustom sc-default-cite-frame |
4850 | 170 '(;; initialize fill state and temporary variables when entering |
171 ;; frame. this makes things run much faster | |
172 (begin (progn | |
173 (sc-fill-if-different) | |
174 (setq sc-tmp-nested-regexp (sc-cite-regexp "") | |
175 sc-tmp-nonnested-regexp (sc-cite-regexp) | |
176 sc-tmp-dumb-regexp | |
177 (concat "\\(" | |
178 (sc-cite-regexp "") | |
179 "\\)" | |
180 (sc-cite-regexp sc-citation-nonnested-root-regexp)) | |
181 ))) | |
182 ;; blank lines mean paragraph separators, so fill the last cited | |
183 ;; paragraph, unless sc-cite-blank-lines-p is non-nil, in which | |
184 ;; case we treat blank lines just like any other line. | |
185 ("^[ \t]*$" (if sc-cite-blank-lines-p | |
186 (sc-cite-line) | |
187 (sc-fill-if-different ""))) | |
188 ;; do nothing if looking at a reference tag. make sure that the | |
189 ;; tag string isn't the empty string since this will match every | |
190 ;; line. it cannot be nil. | |
191 (sc-reference-tag-string (if (string= sc-reference-tag-string "") | |
192 (list 'continue) | |
193 nil)) | |
194 ;; this regexp catches nested citations in which the author cited | |
195 ;; a non-nested citation with a dumb citer. | |
196 (sc-tmp-dumb-regexp (sc-cite-coerce-dumb-citer)) | |
197 ;; if we are looking at a nested citation then add a citation level | |
198 (sc-tmp-nested-regexp (sc-add-citation-level)) | |
199 ;; if we're looking at a non-nested citation, coerce it to our style | |
200 (sc-tmp-nonnested-regexp (sc-cite-coerce-cited-line)) | |
201 ;; we must be looking at an uncited line. if we are in nested | |
202 ;; citations, just add a citation level | |
203 (sc-nested-citation-p (sc-add-citation-level)) | |
204 ;; we're looking at an uncited line and we are in non-nested | |
205 ;; citations, so cite it with a non-nested citation | |
206 (t (sc-cite-line)) | |
207 ;; be sure when we're done that we fill the last cited paragraph. | |
208 (end (sc-fill-if-different "")) | |
209 ) | |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
210 "*Default REGI frame for citing a region." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
211 :type '(repeat (repeat sexp)) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
212 :group 'supercite-frames) |
4850 | 213 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
214 (defcustom sc-default-uncite-frame |
4850 | 215 '(;; do nothing on a blank line |
216 ("^[ \t]*$" nil) | |
217 ;; if the line is cited, uncite it | |
218 ((sc-cite-regexp) (sc-uncite-line)) | |
219 ) | |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
220 "*Default REGI frame for unciting a region." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
221 :type '(repeat (repeat sexp)) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
222 :group 'supercite-frames) |
4850 | 223 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
224 (defcustom sc-default-recite-frame |
4850 | 225 '(;; initialize fill state when entering frame |
226 (begin (sc-fill-if-different)) | |
227 ;; do nothing on a blank line | |
228 ("^[ \t]*$" nil) | |
229 ;; if we're looking at a cited line, recite it | |
230 ((sc-cite-regexp) (sc-recite-line (sc-cite-regexp))) | |
231 ;; otherwise, the line is uncited, so just cite it | |
232 (t (sc-cite-line)) | |
233 ;; be sure when we're done that we fill the last cited paragraph. | |
234 (end (sc-fill-if-different "")) | |
235 ) | |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
236 "*Default REGI frame for reciting a region." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
237 :type '(repeat (repeat sexp)) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
238 :group 'supercite-frames) |
4850 | 239 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
240 (defcustom sc-cite-region-limit t |
4850 | 241 "*This variable controls automatic citation of yanked text. |
242 Legal values are: | |
243 | |
244 non-nil -- cite the entire region, regardless of its size | |
245 nil -- do not cite the region at all | |
246 <integer> -- a number indicating the threshold for citation. When | |
247 the number of lines in the region is greater than this | |
248 value, a warning message will be printed and the region | |
249 will not be cited. Lines in region are counted with | |
250 `count-lines'. | |
251 | |
252 The gathering of attribution information is not affected by the value | |
253 of this variable. The number of lines in the region is calculated | |
254 *after* all mail headers are removed. This variable is only consulted | |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
255 during the initial citing via `sc-cite-original'." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
256 :type '(choice (const :tag "always cite" t) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
257 (const :tag "do not cite" nil) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
258 (integer :tag "citation threshold")) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
259 :group 'supercite-cite) |
4850 | 260 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
261 (defcustom sc-confirm-always-p t |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
262 "*If non-nil, always confirm attribution string before citing text body." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
263 :type 'boolean |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
264 :group 'supercite-attr) |
4850 | 265 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
266 (defcustom sc-default-attribution "Anon" |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
267 "*String used when author's attribution cannot be determined." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
268 :type 'string |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
269 :group 'supercite-attr) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
270 (defcustom sc-default-author-name "Anonymous" |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
271 "*String used when author's name cannot be determined." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
272 :type 'string |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
273 :group 'supercite-attr) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
274 (defcustom sc-downcase-p nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
275 "*Non-nil means downcase the attribution and citation strings." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
276 :type 'boolean |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
277 :group 'supercite-attr |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
278 :group 'supercite-cite) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
279 (defcustom sc-electric-circular-p t |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
280 "*If non-nil, treat electric references as circular." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
281 :type 'boolean |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
282 :group 'supercite-attr) |
4850 | 283 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
284 (defcustom sc-electric-mode-hook nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
285 "*Hook for `sc-electric-mode' electric references mode." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
286 :type 'hook |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
287 :group 'supercite-hooks) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
288 (defcustom sc-electric-references-p nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
289 "*Use electric references if non-nil." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
290 :type 'boolean |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
291 :group 'supercite) |
4850 | 292 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
293 (defcustom sc-fixup-whitespace-p nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
294 "*If non-nil, delete all leading white space before citing." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
295 :type 'boolean |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
296 :group 'supercite) |
4850 | 297 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
298 (defcustom sc-load-hook nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
299 "*Hook which gets run once after Supercite loads." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
300 :type 'hook |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
301 :group 'supercite-hooks) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
302 (defcustom sc-pre-hook nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
303 "*Hook which gets run before each invocation of `sc-cite-original'." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
304 :type 'hook |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
305 :group 'supercite-hooks) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
306 (defcustom sc-post-hook nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
307 "*Hook which gets run after each invocation of `sc-cite-original'." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
308 :type 'hook |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
309 :group 'supercite-hooks) |
4850 | 310 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
311 (defcustom sc-mail-warn-if-non-rfc822-p t |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
312 "*Warn if mail headers don't conform to RFC822." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
313 :type 'boolean |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
314 :group 'supercite-attr) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
315 (defcustom sc-mumble "" |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
316 "*Value returned by `sc-mail-field' if field isn't in mail headers." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
317 :type 'string |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
318 :group 'supercite-attr) |
4850 | 319 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
320 (defcustom sc-name-filter-alist |
4850 | 321 '(("^\\(Mr\\|Mrs\\|Ms\\|Dr\\)[.]?$" . 0) |
322 ("^\\(Jr\\|Sr\\)[.]?$" . last) | |
323 ("^ASTS$" . 0) | |
324 ("^[I]+$" . last)) | |
325 "*Name list components which are filtered out as noise. | |
326 This variable contains an association list where each element is of | |
327 the form: (REGEXP . POSITION). | |
328 | |
329 REGEXP is a regular expression which matches the name list component. | |
330 Match is performed using `string-match'. POSITION is the position in | |
331 the name list which can match the regular expression, starting at zero | |
332 for the first element. Use `last' to match the last element in the | |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
333 list and `any' to match all elements." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
334 :type '(repeat (cons regexp (choice (const last) (const any) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
335 (integer :tag "position")))) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
336 :group 'supercite-attr) |
4850 | 337 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
338 (defcustom sc-nested-citation-p nil |
4850 | 339 "*Controls whether to use nested or non-nested citation style. |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
340 Non-nil uses nested citations, nil uses non-nested citations." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
341 :type 'boolean |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
342 :group 'supercite) |
4850 | 343 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
344 (defcustom sc-nuke-mail-headers 'all |
4850 | 345 "*Controls mail header nuking. |
346 Used in conjunction with `sc-nuke-mail-header-list'. Legal values are: | |
347 | |
348 `all' -- nuke all mail headers | |
349 `none' -- don't nuke any mail headers | |
350 `specified' -- nuke headers specified in `sc-nuke-mail-header-list' | |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
351 `keep' -- keep headers specified in `sc-nuke-mail-header-list'" |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
352 :type '(choice (const all) (const none) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
353 (const specified) (const keep)) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
354 :group 'supercite) |
4850 | 355 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
356 (defcustom sc-nuke-mail-header-list nil |
4850 | 357 "*List of mail header regexps to remove or keep in body of reply. |
358 This list contains regular expressions describing the mail headers to | |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
359 keep or nuke, depending on the value of `sc-nuke-mail-headers'." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
360 :type '(repeat regexp) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
361 :group 'supercite) |
4850 | 362 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
363 (defcustom sc-preferred-attribution-list |
4850 | 364 '("sc-lastchoice" "x-attribution" "firstname" "initials" "lastname") |
365 "*Specifies what to use as the attribution string. | |
366 Supercite creates a list of possible attributions when it scans the | |
367 mail headers from the original message. Each attribution choice is | |
368 associated with a key in an attribution alist. Supercite tries to | |
369 pick a \"preferred\" attribution by matching the attribution alist | |
370 keys against the elements in `sc-preferred-attribution-list' in order. | |
371 The first non-empty string value found is used as the preferred | |
372 attribution. | |
373 | |
374 Note that Supercite now honors the X-Attribution: mail field. If | |
375 present in the original message, the value of this field should always | |
376 be used to select the most preferred attribution since it reflects how | |
377 the original author would like to be distinguished. It should be | |
378 considered bad taste to put any attribution preference key before | |
379 \"x-attribution\" in this list, except perhaps for \"sc-lastchoice\" | |
7639 | 380 \(see below). |
4850 | 381 |
382 Supercite remembers the last attribution used when reciting an already | |
383 cited paragraph. This attribution will always be saved with the | |
384 \"sc-lastchoice\" key, which can be used in this list. Note that the | |
385 last choice is always reset after every call of `sc-cite-original'. | |
386 | |
387 Barring error conditions, the following preferences are always present | |
388 in the attribution alist: | |
389 | |
390 \"emailname\" -- email terminus name | |
391 \"initials\" -- initials of author | |
392 \"firstname\" -- first name of author | |
393 \"lastname\" -- last name of author | |
394 \"middlename-1\" -- first middle name of author | |
395 \"middlename-2\" -- second middle name of author | |
396 ... | |
397 | |
398 Middle name indexes can be any positive integer greater than 0, | |
399 although it is unlikely that many authors will supply more than one | |
400 middle name, if that many. The string of all middle names is | |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
401 associated with the key \"middlenames\"." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
402 :type '(repeat string) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
403 :group 'supercite-attr) |
4850 | 404 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
405 (defcustom sc-attrib-selection-list nil |
4850 | 406 "*An alist for selecting preferred attribution based on mail headers. |
407 Each element of this list has the following form: | |
408 | |
409 (INFOKEY ((REGEXP . ATTRIBUTION) | |
410 (REGEXP . ATTRIBUTION) | |
411 (...))) | |
412 | |
413 Where INFOKEY is a key for `sc-mail-field', REGEXP is a regular | |
414 expression to match against the INFOKEY's value. ATTRIBUTION can be a | |
415 string or a list. If its a string, then it is the attribution that is | |
416 selected by `sc-select-attribution'. If it is a list, it is `eval'd | |
417 and the return value must be a string, which is used as the selected | |
418 attribution. Note that the variable `sc-preferred-attribution-list' | |
419 must contain an element of the string \"sc-consult\" for this variable | |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
420 to be consulted during attribution selection." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
421 :type '(repeat (list symbol (repeat (cons regexp |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
422 (choice (repeat (repeat sexp)) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
423 symbol))))) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
424 :group 'supercite-attr) |
4850 | 425 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
426 (defcustom sc-attribs-preselect-hook nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
427 "*Hook to run before selecting an attribution." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
428 :type 'hook |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
429 :group 'supercite-attr |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
430 :group 'supercite-hooks) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
431 (defcustom sc-attribs-postselect-hook nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
432 "*Hook to run after selecting an attribution, but before confirmation." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
433 :type 'hook |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
434 :group 'supercite-attr |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
435 :group 'supercite-hooks) |
4850 | 436 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
437 (defcustom sc-pre-cite-hook nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
438 "*Hook to run before citing a region of text." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
439 :type 'hook |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
440 :group 'supercite-cite |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
441 :group 'supercite-hooks) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
442 (defcustom sc-pre-uncite-hook nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
443 "*Hook to run before unciting a region of text." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
444 :type 'hook |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
445 :group 'supercite-cite |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
446 :group 'supercite-hooks) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
447 (defcustom sc-pre-recite-hook nil |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
448 "*Hook to run before reciting a region of text." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
449 :type 'hook |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
450 :group 'supercite-cite |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
451 :group 'supercite-hooks) |
4850 | 452 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
453 (defcustom sc-preferred-header-style 4 |
4850 | 454 "*Index into `sc-rewrite-header-list' specifying preferred header style. |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
455 Index zero accesses the first function in the list." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
456 :type 'integer |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
457 :group 'supercite) |
4850 | 458 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
459 (defcustom sc-reference-tag-string ">>>>> " |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
460 "*String used at the beginning of built-in reference headers." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
461 :type 'string |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
462 :group 'supercite) |
4850 | 463 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
464 (defcustom sc-rewrite-header-list |
4850 | 465 '((sc-no-header) |
466 (sc-header-on-said) | |
467 (sc-header-inarticle-writes) | |
468 (sc-header-regarding-adds) | |
469 (sc-header-attributed-writes) | |
470 (sc-header-author-writes) | |
471 (sc-header-verbose) | |
472 (sc-no-blank-line-or-header) | |
473 ) | |
474 "*List of reference header rewrite functions. | |
475 The variable `sc-preferred-header-style' controls which function in | |
476 this list is chosen for automatic reference header insertions. | |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
477 Electric reference mode will cycle through this list of functions." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
478 :type '(repeat sexp) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
479 :group 'supercite) |
4850 | 480 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
481 (defcustom sc-titlecue-regexp "\\s +-+\\s +" |
4850 | 482 "*Regular expression describing the separator between names and titles. |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
483 Set to nil to treat entire field as a name." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
484 :type '(choice (const :tag "entire field as name" nil) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
485 regexp) |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
486 :group 'supercite-attr) |
4850 | 487 |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
488 (defcustom sc-use-only-preference-p nil |
4850 | 489 "*Controls what happens when the preferred attribution cannot be found. |
490 If non-nil, then `sc-default-attribution' will be used. If nil, then | |
491 some secondary scheme will be employed to find a suitable attribution | |
17489
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
492 string." |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
493 :type 'boolean |
cb41a5b41836
Add defgroup's; use defcustom for user vars.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
494 :group 'supercite-attr) |
4850 | 495 |
496 ;; ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
497 ;; end user configuration variables | |
498 | |
499 (defconst sc-version "3.1" | |
500 "Supercite version number.") | |
501 (defconst sc-help-address "supercite-help@anthem.nlm.nih.gov" | |
502 "Address accepting submissions of bug reports.") | |
503 | |
504 (defvar sc-mail-info nil | |
505 "Alist of mail header information gleaned from reply buffer.") | |
506 (defvar sc-attributions nil | |
507 "Alist of attributions for use when citing.") | |
508 | |
509 (defconst sc-emacs-features | |
510 (let ((version 'v18) | |
511 (flavor 'GNU)) | |
512 (if (string= (substring emacs-version 0 2) "19") | |
513 (setq version 'v19)) | |
514 (if (string-match "Lucid" emacs-version) | |
515 (setq flavor 'Lucid)) | |
516 ;; cobble up list | |
517 (list version flavor)) | |
518 "A list describing what version of Emacs we're running on. | |
519 Known flavors are: | |
520 | |
521 All GNU18's: (v18 GNU) | |
522 FSF19.x : (v19 GNU) | |
523 Lucid19.x : (v19 Lucid)") | |
524 | |
525 | |
526 (defvar sc-tmp-nested-regexp nil | |
527 "Temporary regepx describing nested citations.") | |
528 (defvar sc-tmp-nonnested-regexp nil | |
529 "Temporary regexp describing non-nested citations.") | |
530 (defvar sc-tmp-dumb-regexp nil | |
531 "Temp regexp describing non-nested citation cited with a nesting citer.") | |
532 | |
533 (defvar sc-minor-mode nil | |
534 "Supercite minor mode on flag.") | |
535 (defvar sc-mode-string " SC" | |
536 "Supercite minor mode string.") | |
537 | |
538 (make-variable-buffer-local 'sc-mail-info) | |
539 (make-variable-buffer-local 'sc-attributions) | |
540 (make-variable-buffer-local 'sc-minor-mode) | |
541 | |
542 | |
543 ;; ====================================================================== | |
544 ;; supercite keymaps | |
545 | |
546 (defvar sc-mode-map-prefix "\C-c\C-p" | |
547 "*Key binding to install Supercite keymap. | |
548 If this is nil, Supercite keymap is not installed.") | |
549 | |
550 (defvar sc-T-keymap () | |
551 "Keymap for sub-keymap of setting and toggling functions.") | |
552 (if sc-T-keymap | |
553 () | |
554 (setq sc-T-keymap (make-sparse-keymap)) | |
555 (define-key sc-T-keymap "a" 'sc-S-preferred-attribution-list) | |
556 (define-key sc-T-keymap "b" 'sc-T-mail-nuke-blank-lines) | |
557 (define-key sc-T-keymap "c" 'sc-T-confirm-always) | |
558 (define-key sc-T-keymap "d" 'sc-T-downcase) | |
559 (define-key sc-T-keymap "e" 'sc-T-electric-references) | |
560 (define-key sc-T-keymap "f" 'sc-T-auto-fill-region) | |
561 (define-key sc-T-keymap "h" 'sc-T-describe) | |
562 (define-key sc-T-keymap "l" 'sc-S-cite-region-limit) | |
563 (define-key sc-T-keymap "n" 'sc-S-mail-nuke-mail-headers) | |
564 (define-key sc-T-keymap "N" 'sc-S-mail-header-nuke-list) | |
565 (define-key sc-T-keymap "o" 'sc-T-electric-circular) | |
566 (define-key sc-T-keymap "p" 'sc-S-preferred-header-style) | |
567 (define-key sc-T-keymap "s" 'sc-T-nested-citation) | |
568 (define-key sc-T-keymap "u" 'sc-T-use-only-preferences) | |
569 (define-key sc-T-keymap "w" 'sc-T-fixup-whitespace) | |
570 (define-key sc-T-keymap "?" 'sc-T-describe) | |
571 ) | |
572 | |
573 (defvar sc-mode-map () | |
574 "Keymap for Supercite quasi-mode.") | |
575 (if sc-mode-map | |
576 () | |
577 (setq sc-mode-map (make-sparse-keymap)) | |
578 (define-key sc-mode-map "c" 'sc-cite-region) | |
579 (define-key sc-mode-map "f" 'sc-mail-field-query) | |
580 (define-key sc-mode-map "g" 'sc-mail-process-headers) | |
581 (define-key sc-mode-map "h" 'sc-describe) | |
582 (define-key sc-mode-map "i" 'sc-insert-citation) | |
583 (define-key sc-mode-map "o" 'sc-open-line) | |
584 (define-key sc-mode-map "r" 'sc-recite-region) | |
585 (define-key sc-mode-map "\C-p" 'sc-raw-mode-toggle) | |
586 (define-key sc-mode-map "u" 'sc-uncite-region) | |
587 (define-key sc-mode-map "v" 'sc-version) | |
588 (define-key sc-mode-map "w" 'sc-insert-reference) | |
589 (define-key sc-mode-map "\C-t" sc-T-keymap) | |
590 (define-key sc-mode-map "\C-b" 'sc-submit-bug-report) | |
591 (define-key sc-mode-map "?" 'sc-describe) | |
592 ) | |
593 | |
594 (defvar sc-electric-mode-map () | |
595 "Keymap for `sc-electric-mode' electric references mode.") | |
596 (if sc-electric-mode-map | |
597 nil | |
598 (setq sc-electric-mode-map (make-sparse-keymap)) | |
599 (define-key sc-electric-mode-map "p" 'sc-eref-prev) | |
600 (define-key sc-electric-mode-map "n" 'sc-eref-next) | |
601 (define-key sc-electric-mode-map "s" 'sc-eref-setn) | |
602 (define-key sc-electric-mode-map "j" 'sc-eref-jump) | |
603 (define-key sc-electric-mode-map "x" 'sc-eref-abort) | |
604 (define-key sc-electric-mode-map "q" 'sc-eref-abort) | |
605 (define-key sc-electric-mode-map "\r" 'sc-eref-exit) | |
606 (define-key sc-electric-mode-map "\n" 'sc-eref-exit) | |
607 (define-key sc-electric-mode-map "g" 'sc-eref-goto) | |
608 (define-key sc-electric-mode-map "?" 'describe-mode) | |
609 (define-key sc-electric-mode-map "\C-h" 'describe-mode) | |
12425
47c3aac35700
(sc-electric-mode-map): Bind f1 and help like C-h.
Richard M. Stallman <rms@gnu.org>
parents:
11768
diff
changeset
|
610 (define-key sc-electric-mode-map [f1] 'describe-mode) |
47c3aac35700
(sc-electric-mode-map): Bind f1 and help like C-h.
Richard M. Stallman <rms@gnu.org>
parents:
11768
diff
changeset
|
611 (define-key sc-electric-mode-map [help] 'describe-mode) |
4850 | 612 ) |
613 | |
614 (defvar sc-minibuffer-local-completion-map nil | |
615 "Keymap for minibuffer confirmation of attribution strings.") | |
616 (if sc-minibuffer-local-completion-map | |
617 () | |
618 (setq sc-minibuffer-local-completion-map | |
619 (copy-keymap minibuffer-local-completion-map)) | |
620 (define-key sc-minibuffer-local-completion-map "\C-t" 'sc-toggle-fn) | |
621 (define-key sc-minibuffer-local-completion-map " " 'self-insert-command)) | |
622 | |
623 (defvar sc-minibuffer-local-map nil | |
624 "Keymap for minibuffer confirmation of attribution strings.") | |
625 (if sc-minibuffer-local-map | |
626 () | |
627 (setq sc-minibuffer-local-map (copy-keymap minibuffer-local-map)) | |
628 (define-key sc-minibuffer-local-map "\C-t" 'sc-toggle-fn)) | |
629 | |
630 | |
631 ;; ====================================================================== | |
632 ;; utility functions | |
633 | |
634 (defun sc-completing-read (prompt table &optional predicate require-match | |
635 initial-contents history) | |
636 "Compatibility between Emacs 18 and 19 `completing-read'. | |
637 In version 18, the HISTORY argument is ignored." | |
638 (if (memq 'v19 sc-emacs-features) | |
639 (funcall 'completing-read prompt table predicate require-match | |
640 initial-contents history) | |
641 (funcall 'completing-read prompt table predicate require-match | |
642 (or (car-safe initial-contents) | |
643 initial-contents)))) | |
644 | |
645 (defun sc-read-string (prompt &optional initial-contents history) | |
646 "Compatibility between Emacs 18 and 19 `read-string'. | |
647 In version 18, the HISTORY argument is ignored." | |
648 (if (memq 'v19 sc-emacs-features) | |
5286
7b3b23470fa1
(sc-read-string): Don't pass a history arg to read-string.
Richard M. Stallman <rms@gnu.org>
parents:
5140
diff
changeset
|
649 ;; maybe future versions will take a `history' argument: |
7b3b23470fa1
(sc-read-string): Don't pass a history arg to read-string.
Richard M. Stallman <rms@gnu.org>
parents:
5140
diff
changeset
|
650 (read-string prompt initial-contents) |
7b3b23470fa1
(sc-read-string): Don't pass a history arg to read-string.
Richard M. Stallman <rms@gnu.org>
parents:
5140
diff
changeset
|
651 (read-string prompt initial-contents))) |
4850 | 652 |
11556
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
653 (if (fboundp 'match-string) |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
654 (defalias 'sc-submatch 'match-string) |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
655 (defun sc-submatch (matchnum &optional string) |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
656 "Returns `match-beginning' and `match-end' sub-expression for MATCHNUM. |
4850 | 657 If optional STRING is provided, take sub-expression using `substring' |
658 of argument, otherwise use `buffer-substring' on current buffer. Note | |
659 that `match-data' must have already been generated and no error | |
660 checking is performed by this function." | |
11556
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
661 (if string |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
662 (substring string (match-beginning matchnum) (match-end matchnum)) |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
663 (buffer-substring (match-beginning matchnum) (match-end matchnum))))) |
4850 | 664 |
11556
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
665 (if (fboundp 'member) |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
666 (defalias 'sc-member 'member) |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
667 (defun sc-member (elt list) |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
668 "Like `memq', but uses `equal' instead of `eq'. |
4850 | 669 Emacs19 has a builtin function `member' which does exactly this." |
11556
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
670 (catch 'elt-is-member |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
671 (while list |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
672 (if (equal elt (car list)) |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
673 (throw 'elt-is-member list)) |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
674 (setq list (cdr list)))))) |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
675 |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
676 ;; One day maybe Emacs will have this... |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
677 (if (fboundp 'string-text) |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
678 (defalias 'sc-string-text 'string-text) |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
679 (defun sc-string-text (string) |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
680 "Return STRING with all text properties removed." |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
681 (let ((string (copy-sequence string))) |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
682 (set-text-properties 0 (length string) nil string) |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
683 string))) |
4850 | 684 |
685 (defun sc-ask (alist) | |
686 "Ask a question in the minibuffer requiring a single character answer. | |
687 This function is kind of an extension of `y-or-n-p' where a single | |
688 letter is used to answer a question. Question is formed from ALIST | |
689 which has members of the form: (WORD . LETTER). WORD is the long | |
690 word form, while LETTER is the letter for selecting that answer. The | |
691 selected letter is returned, or nil if the question was not answered. | |
692 Note that WORD is a string and LETTER is a character. All LETTERs in | |
693 the list should be unique." | |
694 (let* ((prompt (concat | |
695 (mapconcat (function (lambda (elt) (car elt))) alist ", ") | |
696 "? (" | |
697 (mapconcat | |
698 (function | |
699 (lambda (elt) (char-to-string (cdr elt)))) alist "/") | |
700 ") ")) | |
701 (p prompt) | |
702 (event | |
703 (if (memq 'Lucid sc-emacs-features) | |
704 (allocate-event) | |
705 nil))) | |
706 (while (stringp p) | |
707 (if (let ((cursor-in-echo-area t) | |
708 (inhibit-quit t)) | |
709 (message "%s" p) | |
710 ;; lets be good neighbors and be compatible with all emacsen | |
711 (cond | |
712 ((memq 'v18 sc-emacs-features) | |
713 (setq event (read-char))) | |
714 ((memq 'Lucid sc-emacs-features) | |
715 (next-command-event event)) | |
716 (t ; must be FSF19 | |
717 (setq event (read-event)))) | |
718 (prog1 quit-flag (setq quit-flag nil))) | |
719 (progn | |
720 (message "%s%s" p (single-key-description event)) | |
721 (and (memq 'Lucid sc-emacs-features) | |
722 (deallocate-event event)) | |
723 (setq quit-flag nil) | |
724 (signal 'quit '()))) | |
725 (let ((char | |
726 (if (memq 'Lucid sc-emacs-features) | |
727 (let* ((key (and (key-press-event-p event) (event-key event))) | |
728 (char (and key (event-to-character event)))) | |
729 char) | |
730 event)) | |
731 elt) | |
732 (if char (setq char (downcase char))) | |
733 (cond | |
734 ((setq elt (rassq char alist)) | |
735 (message "%s%s" p (car elt)) | |
736 (setq p (cdr elt))) | |
737 ((and (memq 'Lucid sc-emacs-features) | |
738 (button-release-event-p event)) ; ignore them | |
739 nil) | |
740 (t | |
741 (message "%s%s" p (single-key-description event)) | |
742 (if (memq 'Lucid sc-emacs-features) | |
743 (ding nil 'y-or-n-p) | |
744 (ding)) | |
745 (discard-input) | |
746 (if (eq p prompt) | |
747 (setq p (concat "Try again. " prompt))))))) | |
748 (and (memq 'Lucid sc-emacs-features) | |
749 (deallocate-event event)) | |
750 p)) | |
751 | |
752 (defun sc-scan-info-alist (alist) | |
753 "Find a match in the info alist that matches a regexp in ALIST." | |
754 (let ((sc-mumble "") | |
755 rtnvalue) | |
756 (while alist | |
757 (let* ((elem (car alist)) | |
758 (infokey (car elem)) | |
759 (infoval (sc-mail-field infokey)) | |
760 (mlist (car (cdr elem)))) | |
761 (while mlist | |
762 (let* ((ml-elem (car mlist)) | |
763 (regexp (car ml-elem)) | |
764 (thing (cdr ml-elem))) | |
765 (if (string-match regexp infoval) | |
766 ;; we found a match, time to return | |
767 (setq rtnvalue thing | |
768 mlist nil | |
769 alist nil) | |
770 ;; else we didn't find a match | |
771 (setq mlist (cdr mlist)) | |
772 ))) ;end of mlist loop | |
773 (setq alist (cdr alist)) | |
774 )) ;end of alist loop | |
775 rtnvalue)) | |
776 | |
777 | |
778 ;; ====================================================================== | |
779 ;; extract mail field information from headers in reply buffer | |
780 | |
781 ;; holder variables for bc happiness | |
782 (defvar sc-mail-headers-start nil | |
783 "Start of header fields.") | |
784 (defvar sc-mail-headers-end nil | |
785 "End of header fields.") | |
786 (defvar sc-mail-field-history nil | |
787 "For minibuffer completion on mail field queries.") | |
788 (defvar sc-mail-field-modification-history nil | |
789 "For minibuffer completion on mail field modifications.") | |
790 (defvar sc-mail-glom-frame | |
791 '((begin (setq sc-mail-headers-start (point))) | |
792 ("^x-attribution:[ \t]+.*$" (sc-mail-fetch-field t) nil t) | |
793 ("^\\S +:.*$" (sc-mail-fetch-field) nil t) | |
794 ("^$" (list 'abort '(step . 0))) | |
795 ("^[ \t]+" (sc-mail-append-field)) | |
796 (sc-mail-warn-if-non-rfc822-p (sc-mail-error-in-mail-field)) | |
797 (end (setq sc-mail-headers-end (point)))) | |
798 "Regi frame for glomming mail header information.") | |
799 | |
800 ;; regi functions | |
801 (defun sc-mail-fetch-field (&optional attribs-p) | |
802 "Insert a key and value into `sc-mail-info' alist. | |
803 If optional ATTRIBS-P is non-nil, the key/value pair is placed in | |
804 `sc-attributions' too." | |
805 (if (string-match "^\\(\\S *\\)\\s *:\\s +\\(.*\\)$" curline) | |
11556
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
806 (let* ((key (downcase (sc-string-text (sc-submatch 1 curline)))) |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
807 (val (sc-string-text (sc-submatch 2 curline))) |
4850 | 808 (keyval (cons key val))) |
809 (setq sc-mail-info (cons keyval sc-mail-info)) | |
810 (if attribs-p | |
811 (setq sc-attributions (cons keyval sc-attributions))) | |
812 )) | |
813 nil) | |
814 | |
815 (defun sc-mail-append-field () | |
816 "Append a continuation line onto the last fetched mail field's info." | |
817 (let ((keyval (car sc-mail-info))) | |
818 (if (and keyval (string-match "^\\s *\\(.*\\)$" curline)) | |
11556
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
819 (setcdr keyval (concat (cdr keyval) " " |
a83ee7a1e0fd
Made sc-string-text to strip of text properties of buffer text, so string
Simon Marshall <simon@gnu.org>
parents:
9845
diff
changeset
|
820 (sc-string-text (sc-submatch 1 curline)))))) |
4850 | 821 nil) |
822 | |
823 (defun sc-mail-error-in-mail-field () | |
824 "Issue warning that mail headers don't conform to RFC 822." | |
825 (let* ((len (min (length curline) 10)) | |
826 (ellipsis (if (< len (length curline)) "..." "")) | |
827 (msg "Mail header \"%s%s\" doesn't conform to RFC 822. skipping...")) | |
828 (message msg (substring curline 0 len) ellipsis)) | |
829 (beep) | |
830 (sit-for 2) | |
831 nil) | |
832 | |
833 ;; mail header nuking | |
834 (defvar sc-mail-last-header-nuked-p nil | |
835 "True if the last header was nuked.") | |
836 | |
837 (defun sc-mail-nuke-line () | |
838 "Nuke the current mail header line." | |
839 (delete-region (regi-pos 'bol) (regi-pos 'bonl)) | |
840 '((step . -1))) | |
841 | |
842 (defun sc-mail-nuke-header-line () | |
843 "Delete current-line and set up for possible continuation." | |
844 (setq sc-mail-last-header-nuked-p t) | |
845 (sc-mail-nuke-line)) | |
846 | |
847 (defun sc-mail-nuke-continuation-line () | |
848 "Delete a continuation line if the last header line was deleted." | |
849 (if sc-mail-last-header-nuked-p | |
850 (sc-mail-nuke-line))) | |
851 | |
852 (defun sc-mail-cleanup-blank-lines () | |
853 "Leave some blank lines after original mail headers are nuked. | |
854 The number of lines left is specified by `sc-blank-lines-after-headers'." | |
855 (if sc-blank-lines-after-headers | |
856 (save-restriction | |
857 (widen) | |
858 (skip-chars-backward " \t\n") | |
859 (forward-line 1) | |
860 (delete-blank-lines) | |
861 (beginning-of-line) | |
862 (if (looking-at "[ \t]*$") | |
863 (delete-region (regi-pos 'bol) (regi-pos 'bonl))) | |
864 (insert-char ?\n sc-blank-lines-after-headers))) | |
865 nil) | |
866 | |
867 (defun sc-mail-build-nuke-frame () | |
868 "Build the regiframe for nuking mail headers." | |
869 (let (every-func entry-func nonentry-func) | |
870 (cond | |
871 ((eq sc-nuke-mail-headers 'all) | |
872 (setq every-func '(progn (forward-line -1) (sc-mail-nuke-line)))) | |
873 ((eq sc-nuke-mail-headers 'specified) | |
874 (setq entry-func '(sc-mail-nuke-header-line) | |
875 nonentry-func '(setq sc-mail-last-header-nuked-p nil))) | |
876 ((eq sc-nuke-mail-headers 'keep) | |
877 (setq entry-func '(setq sc-mail-last-header-nuked-p nil) | |
878 nonentry-func '(sc-mail-nuke-header-line))) | |
879 ;; we never get far enough to interpret a frame if s-n-m-h == 'none | |
880 ((eq sc-nuke-mail-headers 'none)) | |
881 (t (error "Illegal value for sc-nuke-mail-headers: %s" | |
882 sc-nuke-mail-headers)) | |
883 ) ; end-cond | |
884 (append | |
885 (and entry-func | |
886 (regi-mapcar sc-nuke-mail-header-list entry-func nil t)) | |
887 (and nonentry-func (list (list "^\\S +:.*$" nonentry-func))) | |
888 (and (not every-func) | |
889 '(("^[ \t]+" (sc-mail-nuke-continuation-line)))) | |
890 '((begin (setq sc-mail-last-header-zapped-p nil))) | |
891 '((end (sc-mail-cleanup-blank-lines))) | |
892 (and every-func (list (list 'every every-func))) | |
893 ))) | |
894 | |
895 ;; mail processing and zapping. this is the top level entry defun to | |
896 ;; all header processing. | |
897 (defun sc-mail-process-headers (start end) | |
898 "Process original mail message's mail headers. | |
899 After processing, mail headers may be nuked. Header information is | |
900 stored in `sc-mail-info', and any old information is lost unless an | |
901 error occurs." | |
902 (interactive "r") | |
903 (let ((info (copy-alist sc-mail-info)) | |
904 (attribs (copy-alist sc-attributions))) | |
905 (setq sc-mail-info nil | |
906 sc-attributions nil) | |
907 (regi-interpret sc-mail-glom-frame start end) | |
908 (if (null sc-mail-info) | |
909 (progn | |
910 (message "No mail headers found! Restoring old information.") | |
911 (setq sc-mail-info info | |
912 sc-attributions attribs)) | |
913 (regi-interpret (sc-mail-build-nuke-frame) | |
914 sc-mail-headers-start sc-mail-headers-end) | |
915 ))) | |
916 | |
917 | |
918 ;; let the user change mail field information | |
919 (defun sc-mail-field (field) | |
920 "Return the mail header field value associated with FIELD. | |
921 If there was no mail header with FIELD as its key, return the value of | |
922 `sc-mumble'. FIELD is case insensitive." | |
923 (or (cdr (assoc (downcase field) sc-mail-info)) sc-mumble)) | |
924 | |
925 (defun sc-mail-field-query (arg) | |
926 "View the value of a mail field. | |
927 With `\\[universal-argument]', prompts for action on mail field. | |
928 Action can be one of: View, Modify, Add, or Delete." | |
929 (interactive "P") | |
930 (let* ((alist '(("view" . ?v) ("modify" . ?m) ("add" . ?a) ("delete" . ?d))) | |
931 (action (if (not arg) ?v (sc-ask alist))) | |
932 key) | |
933 (if (not action) | |
934 () | |
935 (setq key (sc-completing-read | |
936 (concat (car (rassq action alist)) | |
937 " information key: ") | |
938 sc-mail-info nil | |
939 (if (eq action ?a) nil 'noexit) | |
940 nil 'sc-mail-field-history)) | |
941 (cond | |
942 ((eq action ?v) | |
943 (message "%s: %s" key (cdr (assoc key sc-mail-info)))) | |
944 ((eq action ?d) | |
945 (setq sc-mail-info (delq (assoc key sc-mail-info) sc-mail-info))) | |
946 ((eq action ?m) | |
947 (let ((keyval (assoc key sc-mail-info))) | |
948 ;; first put initial value onto list if not already there | |
949 (if (not (sc-member (cdr keyval) | |
950 sc-mail-field-modification-history)) | |
951 (setq sc-mail-field-modification-history | |
952 (cons (cdr keyval) sc-mail-field-modification-history))) | |
953 (setcdr keyval (sc-read-string | |
954 (concat key ": ") (cdr keyval) | |
955 'sc-mail-field-modification-history)))) | |
956 ((eq action ?a) | |
957 (setq sc-mail-info | |
958 (cons (cons key | |
959 (sc-read-string (concat key ": "))) sc-mail-info))) | |
960 )))) | |
961 | |
962 | |
963 ;; ====================================================================== | |
964 ;; attributions | |
965 | |
966 (defvar sc-attribution-confirmation-history nil | |
967 "History for confirmation of attribution strings.") | |
968 (defvar sc-citation-confirmation-history nil | |
969 "History for confirmation of attribution prefixes.") | |
970 | |
971 (defun sc-attribs-%@-addresses (from &optional delim) | |
972 "Extract the author's email terminus from email address FROM. | |
973 Match addresses of the style ``name%[stuff].'' when called with DELIM | |
974 of \"%\" and addresses of the style ``[stuff]name@[stuff]'' when | |
975 called with DELIM \"@\". If DELIM is nil or not provided, matches | |
976 addresses of the style ``name''." | |
977 (and (string-match (concat "[-a-zA-Z0-9_.]+" delim) from 0) | |
978 (substring from | |
979 (match-beginning 0) | |
980 (- (match-end 0) (if (null delim) 0 1))))) | |
981 | |
982 (defun sc-attribs-!-addresses (from) | |
983 "Extract the author's email terminus from email address FROM. | |
984 Match addresses of the style ``[stuff]![stuff]...!name[stuff].''" | |
985 (let ((eos (length from)) | |
986 (mstart (string-match "![-a-zA-Z0-9_.]+\\([^-!a-zA-Z0-9_.]\\|$\\)" | |
987 from 0)) | |
988 (mend (match-end 0))) | |
989 (and mstart | |
990 (substring from (1+ mstart) (- mend (if (= mend eos) 0 1))) | |
991 ))) | |
992 | |
993 (defun sc-attribs-<>-addresses (from) | |
994 "Extract the author's email terminus from email address FROM. | |
995 Match addresses of the style ``<name[stuff]>.''" | |
996 (and (string-match "<\\(.*\\)>" from) | |
997 (sc-submatch 1 from))) | |
998 | |
999 (defun sc-get-address (from author) | |
1000 "Get the full email address path from FROM. | |
1001 AUTHOR is the author's name (which is removed from the address)." | |
1002 (let ((eos (length from))) | |
1003 (if (string-match (concat "\\(^\\|^\"\\)" author | |
1004 "\\(\\s +\\|\"\\s +\\)") from 0) | |
1005 (let ((address (substring from (match-end 0) eos))) | |
1006 (if (and (= (aref address 0) ?<) | |
1007 (= (aref address (1- (length address))) ?>)) | |
1008 (substring address 1 (1- (length address))) | |
1009 address)) | |
1010 (if (string-match "[-a-zA-Z0-9!@%._]+" from 0) | |
1011 (sc-submatch 0 from) | |
1012 "") | |
1013 ))) | |
1014 | |
1015 (defun sc-attribs-emailname (from) | |
1016 "Get the email terminus name from FROM." | |
1017 (or | |
1018 (sc-attribs-%@-addresses from "%") | |
1019 (sc-attribs-%@-addresses from "@") | |
1020 (sc-attribs-!-addresses from) | |
1021 (sc-attribs-<>-addresses from) | |
1022 (sc-attribs-%@-addresses from) | |
1023 (substring from 0 10))) | |
1024 | |
1025 (defun sc-name-substring (string start end extend) | |
1026 "Extract the specified substring of STRING from START to END. | |
1027 EXTEND is the number of characters on each side to extend the | |
1028 substring." | |
1029 (and start | |
1030 (let ((sos (+ start extend)) | |
1031 (eos (- end extend))) | |
1032 (substring string sos | |
1033 (or (string-match sc-titlecue-regexp string sos) eos) | |
1034 )))) | |
1035 | |
1036 (defun sc-attribs-extract-namestring (from) | |
1037 "Extract the name string from FROM. | |
1038 This should be the author's full name minus an optional title." | |
1039 (let ((namestring | |
1040 (or | |
12859
90c22a02c12b
(sc-attribs-extract-namestring): If name has <...>,
Richard M. Stallman <rms@gnu.org>
parents:
12425
diff
changeset
|
1041 ;; If there is a <...> in the name, |
90c22a02c12b
(sc-attribs-extract-namestring): If name has <...>,
Richard M. Stallman <rms@gnu.org>
parents:
12425
diff
changeset
|
1042 ;; treat everything before that as the full name. |
90c22a02c12b
(sc-attribs-extract-namestring): If name has <...>,
Richard M. Stallman <rms@gnu.org>
parents:
12425
diff
changeset
|
1043 ;; Even if it contains parens, use the whole thing. |
13813
7d18fdd1acf4
(sc-attribs-extract-namestring): Do look for
Karl Heuer <kwzh@gnu.org>
parents:
12859
diff
changeset
|
1044 ;; On the other hand, we do look for quotes in the usual way. |
12859
90c22a02c12b
(sc-attribs-extract-namestring): If name has <...>,
Richard M. Stallman <rms@gnu.org>
parents:
12425
diff
changeset
|
1045 (and (string-match " *<.*>" from 0) |
13813
7d18fdd1acf4
(sc-attribs-extract-namestring): Do look for
Karl Heuer <kwzh@gnu.org>
parents:
12859
diff
changeset
|
1046 (let ((before-angles |
7d18fdd1acf4
(sc-attribs-extract-namestring): Do look for
Karl Heuer <kwzh@gnu.org>
parents:
12859
diff
changeset
|
1047 (sc-name-substring from 0 (match-beginning 0) 0))) |
7d18fdd1acf4
(sc-attribs-extract-namestring): Do look for
Karl Heuer <kwzh@gnu.org>
parents:
12859
diff
changeset
|
1048 (if (string-match "\".*\"" before-angles 0) |
7d18fdd1acf4
(sc-attribs-extract-namestring): Do look for
Karl Heuer <kwzh@gnu.org>
parents:
12859
diff
changeset
|
1049 (sc-name-substring |
7d18fdd1acf4
(sc-attribs-extract-namestring): Do look for
Karl Heuer <kwzh@gnu.org>
parents:
12859
diff
changeset
|
1050 before-angles (match-beginning 0) (match-end 0) 1) |
7d18fdd1acf4
(sc-attribs-extract-namestring): Do look for
Karl Heuer <kwzh@gnu.org>
parents:
12859
diff
changeset
|
1051 before-angles))) |
4850 | 1052 (sc-name-substring |
1053 from (string-match "(.*)" from 0) (match-end 0) 1) | |
1054 (sc-name-substring | |
1055 from (string-match "\".*\"" from 0) (match-end 0) 1) | |
1056 (sc-name-substring | |
1057 from (string-match "\\([-.a-zA-Z0-9_]+\\s +\\)+<" from 0) | |
1058 (match-end 1) 0) | |
1059 (sc-attribs-emailname from)))) | |
1060 ;; strip off any leading or trailing whitespace | |
1061 (if namestring | |
1062 (let ((bos 0) | |
1063 (eos (1- (length namestring)))) | |
1064 (while (and (<= bos eos) | |
1065 (memq (aref namestring bos) '(32 ?\t))) | |
1066 (setq bos (1+ bos))) | |
1067 (while (and (> eos bos) | |
1068 (memq (aref namestring eos) '(32 ?\t))) | |
1069 (setq eos (1- eos))) | |
1070 (substring namestring bos (1+ eos)))))) | |
1071 | |
1072 (defun sc-attribs-chop-namestring (namestring) | |
1073 "Convert NAMESTRING to a list of names. | |
1074 example: (sc-namestring-to-list \"John Xavier Doe\") | |
1075 => (\"John\" \"Xavier\" \"Doe\")" | |
1076 (if (string-match "\\([ \t]*\\)\\([^ \t._]+\\)\\([ \t]*\\)" namestring) | |
1077 (cons (sc-submatch 2 namestring) | |
1078 (sc-attribs-chop-namestring (substring namestring (match-end 3))) | |
1079 ))) | |
1080 | |
1081 (defun sc-attribs-strip-initials (namelist) | |
1082 "Extract the author's initials from the NAMELIST." | |
1083 (mapconcat | |
1084 (function | |
1085 (lambda (name) | |
1086 (if (< 0 (length name)) | |
1087 (substring name 0 1)))) | |
1088 namelist "")) | |
1089 | |
1090 (defun sc-guess-attribution (&optional string) | |
1091 "Guess attribution string on current line. | |
1092 If attribution cannot be guessed, nil is returned. Optional STRING if | |
1093 supplied, is used instead of the line point is on in the current buffer." | |
1094 (let ((start 0) | |
1095 (string (or string (buffer-substring (regi-pos 'bol) (regi-pos 'eol)))) | |
1096 attribution) | |
1097 (and | |
1098 (= start (or (string-match sc-citation-leader-regexp string start) -1)) | |
1099 (setq start (match-end 0)) | |
1100 (= start (or (string-match sc-citation-root-regexp string start) 1)) | |
1101 (setq attribution (sc-submatch 0 string) | |
1102 start (match-end 0)) | |
1103 (= start (or (string-match sc-citation-delimiter-regexp string start) -1)) | |
1104 (setq start (match-end 0)) | |
1105 (= start (or (string-match sc-citation-separator-regexp string start) -1)) | |
1106 attribution))) | |
1107 | |
1108 (defun sc-attribs-filter-namelist (namelist) | |
1109 "Filter out noise in NAMELIST according to `sc-name-filter-alist'." | |
1110 (let ((elements (length namelist)) | |
1111 (position -1) | |
1112 keepers filtered-list) | |
1113 (mapcar | |
1114 (function | |
1115 (lambda (name) | |
1116 (setq position (1+ position)) | |
1117 (let ((keep-p t)) | |
1118 (mapcar | |
1119 (function | |
1120 (lambda (filter) | |
1121 (let ((regexp (car filter)) | |
1122 (pos (cdr filter))) | |
1123 (if (and (string-match regexp name) | |
1124 (or (and (numberp pos) | |
1125 (= pos position)) | |
1126 (and (eq pos 'last) | |
1127 (= position (1- elements))) | |
1128 (eq pos 'any))) | |
1129 (setq keep-p nil)) | |
1130 ))) | |
1131 sc-name-filter-alist) | |
1132 (if keep-p | |
1133 (setq keepers (cons position keepers))) | |
1134 ))) | |
1135 namelist) | |
1136 (mapcar | |
1137 (function | |
1138 (lambda (position) | |
1139 (setq filtered-list (cons (nth position namelist) filtered-list)) | |
1140 )) | |
1141 keepers) | |
1142 filtered-list)) | |
1143 | |
1144 (defun sc-attribs-chop-address (from) | |
1145 "Extract attribution information from FROM. | |
1146 This populates the `sc-attributions' with the list of possible attributions." | |
1147 (if (and (stringp from) | |
1148 (< 0 (length from))) | |
1149 (let* ((sc-mumble "") | |
1150 (namestring (sc-attribs-extract-namestring from)) | |
1151 (namelist (sc-attribs-filter-namelist | |
1152 (sc-attribs-chop-namestring namestring))) | |
1153 (revnames (reverse (cdr namelist))) | |
1154 (firstname (car namelist)) | |
1155 (midnames (reverse (cdr revnames))) | |
1156 (lastname (car revnames)) | |
1157 (initials (sc-attribs-strip-initials namelist)) | |
1158 (emailname (sc-attribs-emailname from)) | |
1159 (n 1) | |
1160 author middlenames) | |
1161 | |
1162 ;; put basic information | |
1163 (setq | |
1164 ;; put middle names and build sc-author entry | |
1165 middlenames (mapconcat | |
1166 (function | |
1167 (lambda (midname) | |
1168 (let ((key-attribs (format "middlename-%d" n)) | |
1169 (key-mail (format "sc-middlename-%d" n))) | |
1170 (setq | |
1171 sc-attributions (cons (cons key-attribs midname) | |
1172 sc-attributions) | |
1173 sc-mail-info (cons (cons key-mail midname) | |
1174 sc-mail-info) | |
1175 n (1+ n)) | |
1176 midname))) | |
1177 midnames " ") | |
1178 | |
1179 author (concat firstname " " middlenames (and midnames " ") lastname) | |
1180 | |
1181 sc-attributions (append | |
1182 (list | |
1183 (cons "firstname" firstname) | |
1184 (cons "lastname" lastname) | |
1185 (cons "emailname" emailname) | |
1186 (cons "initials" initials)) | |
1187 sc-attributions) | |
1188 sc-mail-info (append | |
1189 (list | |
1190 (cons "sc-firstname" firstname) | |
1191 (cons "sc-middlenames" middlenames) | |
1192 (cons "sc-lastname" lastname) | |
1193 (cons "sc-emailname" emailname) | |
1194 (cons "sc-initials" initials) | |
1195 (cons "sc-author" author) | |
1196 (cons "sc-from-address" (sc-get-address | |
1197 (sc-mail-field "from") | |
1198 namestring)) | |
1199 (cons "sc-reply-address" (sc-get-address | |
1200 (sc-mail-field "reply-to") | |
1201 namestring)) | |
1202 (cons "sc-sender-address" (sc-get-address | |
1203 (sc-mail-field "sender") | |
1204 namestring)) | |
1205 ) | |
1206 sc-mail-info) | |
1207 )) | |
1208 ;; from string is empty | |
1209 (setq sc-mail-info (cons (cons "sc-author" sc-default-author-name) | |
1210 sc-mail-info)))) | |
1211 | |
1212 (defvar sc-attrib-or-cite nil | |
1213 "Used to toggle between attribution input or citation input.") | |
1214 | |
1215 (defun sc-toggle-fn () | |
1216 "Toggle between attribution selection and citation selection. | |
1217 Only used during confirmation." | |
1218 (interactive) | |
1219 (setq sc-attrib-or-cite (not sc-attrib-or-cite)) | |
1220 (throw 'sc-reconfirm t)) | |
1221 | |
1222 (defun sc-select-attribution () | |
1223 "Select an attribution from `sc-attributions'. | |
1224 | |
1225 Variables involved in selection process include: | |
1226 `sc-preferred-attribution-list' | |
1227 `sc-use-only-preference-p' | |
1228 `sc-confirm-always-p' | |
1229 `sc-default-attribution' | |
1230 `sc-attrib-selection-list'. | |
1231 | |
1232 Runs the hook `sc-attribs-preselect-hook' before selecting an | |
1233 attribution and the hook `sc-attribs-postselect-hook' after making the | |
1234 selection but before querying is performed. During | |
1235 `sc-attribs-postselect-hook' the variable `citation' is bound to the | |
1236 auto-selected citation string and the variable `attribution' is bound | |
1237 to the auto-selected attribution string." | |
1238 (run-hooks 'sc-attribs-preselect-hook) | |
1239 (let ((query-p sc-confirm-always-p) | |
1240 attribution citation | |
1241 (attriblist sc-preferred-attribution-list)) | |
1242 | |
1243 ;; first cruise through sc-preferred-attribution-list looking for | |
1244 ;; a match in either sc-attributions or sc-mail-info. if the | |
1245 ;; element is "sc-consult", then we have to do the alist | |
1246 ;; consultation phase | |
1247 (while attriblist | |
1248 (let* ((preferred (car attriblist))) | |
1249 (cond | |
1250 ((string= preferred "sc-consult") | |
1251 ;; we've been told to consult the attribution vs. mail | |
1252 ;; header key alist. we do this until we find a match in | |
1253 ;; the sc-attrib-selection-list. if we do not find a match, | |
1254 ;; we continue scanning attriblist | |
1255 (let ((attrib (sc-scan-info-alist sc-attrib-selection-list))) | |
1256 (cond | |
1257 ((not attrib) | |
1258 (setq attriblist (cdr attriblist))) | |
1259 ((stringp attrib) | |
1260 (setq attribution attrib | |
1261 attriblist nil)) | |
1262 ((listp attrib) | |
1263 (setq attribution (eval attrib) | |
1264 attriblist nil)) | |
1265 (t (error "%s did not evaluate to a string or list!" | |
1266 "sc-attrib-selection-list")) | |
1267 ))) | |
1268 ((setq attribution (cdr (assoc preferred sc-attributions))) | |
1269 (setq attriblist nil)) | |
1270 (t | |
1271 (setq attriblist (cdr attriblist))) | |
1272 ))) | |
1273 | |
1274 ;; if preference was not found, we may use a secondary method to | |
1275 ;; find a valid attribution | |
1276 (if (and (not attribution) | |
1277 (not sc-use-only-preference-p)) | |
1278 ;; secondary method tries to find a preference in this order | |
1279 ;; 1. sc-lastchoice | |
1280 ;; 2. x-attribution | |
1281 ;; 3. firstname | |
1282 ;; 4. lastname | |
1283 ;; 5. initials | |
1284 ;; 6. first non-empty attribution in alist | |
1285 (setq attribution | |
1286 (or (cdr (assoc "sc-lastchoice" sc-attributions)) | |
1287 (cdr (assoc "x-attribution" sc-attributions)) | |
1288 (cdr (assoc "firstname" sc-attributions)) | |
1289 (cdr (assoc "lastname" sc-attributions)) | |
1290 (cdr (assoc "initials" sc-attributions)) | |
1291 (cdr (car sc-attributions))))) | |
1292 | |
1293 ;; still couldn't find an attribution. we're now limited to using | |
1294 ;; the default attribution, but we'll force a query when this happens | |
1295 (if (not attribution) | |
1296 (setq attribution sc-default-attribution | |
1297 query-p t)) | |
1298 | |
1299 ;; create the attribution prefix | |
1300 (setq citation (sc-make-citation attribution)) | |
1301 | |
1302 ;; run the post selection hook before querying the user | |
1303 (run-hooks 'sc-attribs-postselect-hook) | |
1304 | |
1305 ;; query for confirmation | |
1306 (if query-p | |
1307 (let* ((query-alist (mapcar (function (lambda (entry) | |
1308 (list (cdr entry)))) | |
1309 sc-attributions)) | |
1310 (minibuffer-local-completion-map | |
1311 sc-minibuffer-local-completion-map) | |
1312 (minibuffer-local-map sc-minibuffer-local-map) | |
1313 (initial attribution) | |
1314 (completer-disable t) ; in case completer.el is used | |
1315 choice) | |
1316 (setq sc-attrib-or-cite nil) ; nil==attribution, t==citation | |
1317 (while | |
1318 (catch 'sc-reconfirm | |
1319 (string= "" (setq choice | |
1320 (if sc-attrib-or-cite | |
1321 (sc-read-string | |
1322 "Enter citation prefix: " | |
1323 citation | |
1324 'sc-citation-confirmation-history) | |
1325 (sc-completing-read | |
1326 "Complete attribution name: " | |
1327 query-alist nil nil | |
1328 (cons initial 0) | |
1329 'sc-attribution-confirmation-history) | |
1330 ))))) | |
1331 (if sc-attrib-or-cite | |
1332 ;; since the citation was chosen, we have to guess at | |
1333 ;; the attribution | |
1334 (setq citation choice | |
1335 attribution (or (sc-guess-attribution citation) | |
1336 citation)) | |
1337 | |
1338 (setq citation (sc-make-citation choice) | |
1339 attribution choice)) | |
1340 )) | |
1341 | |
1342 ;; its possible that the user wants to downcase the citation and | |
1343 ;; attribution | |
1344 (if sc-downcase-p | |
1345 (setq citation (downcase citation) | |
1346 attribution (downcase attribution))) | |
1347 | |
1348 ;; set up mail info alist | |
1349 (let* ((ckey "sc-citation") | |
1350 (akey "sc-attribution") | |
1351 (ckeyval (assoc ckey sc-mail-info)) | |
1352 (akeyval (assoc akey sc-mail-info))) | |
1353 (if ckeyval | |
1354 (setcdr ckeyval citation) | |
1355 (setq sc-mail-info | |
1356 (append (list (cons ckey citation)) sc-mail-info))) | |
1357 (if akeyval | |
1358 (setcdr akeyval attribution) | |
1359 (setq sc-mail-info | |
1360 (append (list (cons akey attribution)) sc-mail-info)))) | |
1361 | |
1362 ;; set the sc-lastchoice attribution | |
1363 (let* ((lkey "sc-lastchoice") | |
1364 (lastchoice (assoc lkey sc-attributions))) | |
1365 (if lastchoice | |
1366 (setcdr lastchoice attribution) | |
1367 (setq sc-attributions | |
1368 (cons (cons lkey attribution) sc-attributions)))) | |
1369 )) | |
1370 | |
1371 | |
1372 ;; ====================================================================== | |
1373 ;; filladapt hooks for supercite 3.1. you shouldn't need anything | |
1374 ;; extra to make gin-mode understand supercited lines. Even this | |
1375 ;; stuff might not be entirely necessary... | |
1376 | |
1377 (defun sc-cite-regexp (&optional root-regexp) | |
1378 "Return a regexp describing a Supercited line. | |
1379 The regexp is the concatenation of `sc-citation-leader-regexp', | |
1380 `sc-citation-root-regexp', `sc-citation-delimiter-regexp', and | |
1381 `sc-citation-separator-regexp'. If optional ROOT-REGEXP is supplied, | |
1382 use it instead of `sc-citation-root-regexp'." | |
1383 (concat sc-citation-leader-regexp | |
1384 (or root-regexp sc-citation-root-regexp) | |
1385 sc-citation-delimiter-regexp | |
1386 sc-citation-separator-regexp)) | |
1387 | |
1388 (defun sc-make-citation (attribution) | |
1389 "Make a non-nested citation from ATTRIBUTION." | |
1390 (concat sc-citation-leader | |
1391 attribution | |
1392 sc-citation-delimiter | |
1393 sc-citation-separator)) | |
1394 | |
1395 (defun sc-setup-filladapt () | |
1396 "Setup `filladapt-prefix-table' to handle Supercited paragraphs." | |
1397 (let* ((fa-sc-elt 'filladapt-supercite-included-text) | |
1398 (elt (rassq fa-sc-elt filladapt-prefix-table))) | |
1399 (if elt (setcar elt (sc-cite-regexp)) | |
1400 (message "Filladapt doesn't seem to know about Supercite.") | |
1401 (beep)))) | |
1402 | |
1403 | |
1404 ;; ====================================================================== | |
1405 ;; citing and unciting regions of text | |
1406 | |
1407 (defvar sc-fill-begin 1 | |
1408 "Buffer position to begin filling.") | |
1409 (defvar sc-fill-line-prefix "" | |
1410 "Fill prefix of previous line") | |
1411 | |
1412 ;; filling | |
1413 (defun sc-fill-if-different (&optional prefix) | |
1414 "Fill the region bounded by `sc-fill-begin' and point. | |
1415 Only fill if optional PREFIX is different than `sc-fill-line-prefix'. | |
1416 If `sc-auto-fill-region-p' is nil, do not fill region. If PREFIX is | |
1417 not supplied, initialize fill variables. This is useful for a regi | |
1418 `begin' frame-entry." | |
1419 (if (not prefix) | |
1420 (setq sc-fill-line-prefix "" | |
1421 sc-fill-begin (regi-pos 'bol)) | |
1422 (if (and sc-auto-fill-region-p | |
1423 (not (string= prefix sc-fill-line-prefix))) | |
1424 (let ((fill-prefix sc-fill-line-prefix)) | |
1425 (if (not (string= fill-prefix "")) | |
1426 (fill-region sc-fill-begin (regi-pos 'bol))) | |
1427 (setq sc-fill-line-prefix prefix | |
1428 sc-fill-begin (regi-pos 'bol)))) | |
1429 ) | |
1430 nil) | |
1431 | |
1432 (defun sc-cite-coerce-cited-line () | |
1433 "Coerce a Supercited line to look like our style." | |
1434 (let* ((attribution (sc-guess-attribution)) | |
1435 (regexp (sc-cite-regexp attribution)) | |
1436 (prefix (sc-make-citation attribution))) | |
1437 (if (and attribution | |
1438 (looking-at regexp)) | |
1439 (progn | |
1440 (delete-region | |
1441 (match-beginning 0) | |
1442 (save-excursion | |
1443 (goto-char (match-end 0)) | |
1444 (if (bolp) (forward-char -1)) | |
1445 (point))) | |
1446 (insert prefix) | |
1447 (sc-fill-if-different prefix))) | |
1448 nil)) | |
1449 | |
1450 (defun sc-cite-coerce-dumb-citer () | |
1451 "Coerce a non-nested citation that's been cited with a dumb nesting citer." | |
1452 (delete-region (match-beginning 1) (match-end 1)) | |
1453 (beginning-of-line) | |
1454 (sc-cite-coerce-cited-line)) | |
1455 | |
1456 (defun sc-guess-nesting (&optional string) | |
1457 "Guess the citation nesting on the current line. | |
1458 If nesting cannot be guessed, nil is returned. Optional STRING if | |
1459 supplied, is used instead of the line point is on in the current | |
1460 buffer." | |
1461 (let ((start 0) | |
1462 (string (or string (buffer-substring (regi-pos 'bol) (regi-pos 'eol)))) | |
1463 nesting) | |
1464 (and | |
1465 (= start (or (string-match sc-citation-leader-regexp string start) -1)) | |
1466 (setq start (match-end 0)) | |
1467 (= start (or (string-match sc-citation-delimiter-regexp string start) -1)) | |
1468 (setq nesting (sc-submatch 0 string) | |
1469 start (match-end 0)) | |
1470 (= start (or (string-match sc-citation-separator-regexp string start) -1)) | |
1471 nesting))) | |
1472 | |
1473 (defun sc-add-citation-level () | |
14007
c6476f4bb121
(sc-citation-nonnested-root-regexp,
Karl Heuer <kwzh@gnu.org>
parents:
13813
diff
changeset
|
1474 "Add a citation level for nested citation style w/ coercion." |
4850 | 1475 (let* ((nesting (sc-guess-nesting)) |
1476 (citation (make-string (1+ (length nesting)) | |
1477 (string-to-char sc-citation-delimiter))) | |
1478 (prefix (concat sc-citation-leader citation sc-citation-separator))) | |
1479 (if (looking-at (sc-cite-regexp "")) | |
1480 (delete-region (match-beginning 0) (match-end 0))) | |
1481 (insert prefix) | |
1482 (sc-fill-if-different prefix))) | |
1483 | |
1484 (defun sc-cite-line (&optional citation) | |
1485 "Cite a single line of uncited text. | |
1486 Optional CITATION overrides any citation automatically selected." | |
1487 (if sc-fixup-whitespace-p | |
1488 (fixup-whitespace)) | |
1489 (let ((prefix (or citation | |
1490 (cdr (assoc "sc-citation" sc-mail-info)) | |
1491 sc-default-attribution))) | |
1492 (insert prefix) | |
1493 (sc-fill-if-different prefix)) | |
1494 nil) | |
1495 | |
1496 (defun sc-uncite-line () | |
1497 "Remove citation from current line." | |
1498 (let ((cited (looking-at (sc-cite-regexp)))) | |
1499 (if cited | |
1500 (delete-region (match-beginning 0) (match-end 0)))) | |
1501 nil) | |
1502 | |
1503 (defun sc-recite-line (regexp) | |
1504 "Remove citation matching REGEXP from current line and recite line." | |
1505 (let ((cited (looking-at (concat "^" regexp))) | |
1506 (prefix (cdr (assoc "sc-citation" sc-mail-info)))) | |
1507 (if cited | |
1508 (delete-region (match-beginning 0) (match-end 0))) | |
1509 (insert (or prefix sc-default-attribution)) | |
1510 (sc-fill-if-different prefix)) | |
1511 nil) | |
1512 | |
1513 ;; interactive functions | |
1514 (defun sc-cite-region (start end &optional confirm-p) | |
1515 "Cite a region delineated by START and END. | |
1516 If optional CONFIRM-P is non-nil, the attribution is confirmed before | |
1517 its use in the citation string. This function first runs | |
1518 `sc-pre-cite-hook'." | |
1519 (interactive "r\nP") | |
1520 (undo-boundary) | |
1521 (let ((frame (or (sc-scan-info-alist sc-cite-frame-alist) | |
1522 sc-default-cite-frame)) | |
1523 (sc-confirm-always-p (if confirm-p t sc-confirm-always-p))) | |
1524 (run-hooks 'sc-pre-cite-hook) | |
1525 (if (interactive-p) | |
1526 (sc-select-attribution)) | |
1527 (regi-interpret frame start end))) | |
1528 | |
1529 (defun sc-uncite-region (start end) | |
1530 "Uncite a region delineated by START and END. | |
1531 First runs `sc-pre-uncite-hook'." | |
1532 (interactive "r") | |
1533 (undo-boundary) | |
1534 (let ((frame (or (sc-scan-info-alist sc-uncite-frame-alist) | |
1535 sc-default-uncite-frame))) | |
1536 (run-hooks 'sc-pre-uncite-hook) | |
1537 (regi-interpret frame start end))) | |
1538 | |
1539 (defun sc-recite-region (start end) | |
1540 "Recite a region delineated by START and END. | |
1541 First runs `sc-pre-recite-hook'." | |
1542 (interactive "r") | |
1543 (let ((sc-confirm-always-p t)) | |
1544 (sc-select-attribution)) | |
1545 (undo-boundary) | |
1546 (let ((frame (or (sc-scan-info-alist sc-recite-frame-alist) | |
1547 sc-default-recite-frame))) | |
1548 (run-hooks 'sc-pre-recite-hook) | |
1549 (regi-interpret frame start end))) | |
1550 | |
1551 | |
1552 ;; ====================================================================== | |
1553 ;; building headers | |
1554 | |
1555 (defun sc-hdr (prefix field &optional sep return-nil-p) | |
1556 "Returns a concatenation of PREFIX and FIELD. | |
1557 If FIELD is not a string or is the empty string, the empty string will | |
1558 be returned. Optional third argument SEP is concatenated on the end if | |
1559 it is a string. Returns empty string, unless optional RETURN-NIL-P is | |
1560 non-nil." | |
1561 (if (and (stringp field) | |
1562 (not (string= field ""))) | |
1563 (concat prefix field (or sep "")) | |
1564 (and (not return-nil-p) ""))) | |
1565 | |
1566 (defun sc-whofrom () | |
1567 "Return the value of (sc-mail-field \"from\") or nil." | |
1568 (let ((sc-mumble nil)) | |
1569 (sc-mail-field "from"))) | |
1570 | |
1571 (defun sc-no-header () | |
1572 "Does nothing. Use this instead of nil to get a blank header." | |
1573 ()) | |
1574 | |
1575 (defun sc-no-blank-line-or-header() | |
14007
c6476f4bb121
(sc-citation-nonnested-root-regexp,
Karl Heuer <kwzh@gnu.org>
parents:
13813
diff
changeset
|
1576 "Similar to `sc-no-header' except it removes the preceding blank line." |
4850 | 1577 (if (not (bobp)) |
1578 (if (and (eolp) | |
1579 (progn (forward-line -1) | |
11768
8f49fc89adcc
(sc-no-blank-line-or-header): Make mail-header-separator into a regexp.
Richard M. Stallman <rms@gnu.org>
parents:
11571
diff
changeset
|
1580 (or (looking-at |
8f49fc89adcc
(sc-no-blank-line-or-header): Make mail-header-separator into a regexp.
Richard M. Stallman <rms@gnu.org>
parents:
11571
diff
changeset
|
1581 (concat "^" (regexp-quote mail-header-separator) "$")) |
4850 | 1582 (and (eq major-mode 'mh-letter-mode) |
1583 (mh-in-header-p))))) | |
1584 (progn (forward-line) | |
1585 (let ((kill-lines-magic t)) | |
1586 (kill-line)))))) | |
1587 | |
1588 (defun sc-header-on-said () | |
1589 "\"On <date>, <from> said:\" unless: | |
1590 1. the \"from\" field cannot be found, in which case nothing is inserted; | |
1591 2. the \"date\" field is missing in which case only the from part is printed." | |
1592 (let ((sc-mumble "") | |
1593 (whofrom (sc-whofrom))) | |
1594 (if whofrom | |
1595 (insert sc-reference-tag-string | |
1596 (sc-hdr "On " (sc-mail-field "date") ", ") | |
1597 whofrom " said:\n")))) | |
1598 | |
1599 (defun sc-header-inarticle-writes () | |
1600 "\"In article <message-id>, <from> writes:\" | |
1601 Treats \"message-id\" and \"from\" fields similar to `sc-header-on-said'." | |
1602 (let ((sc-mumble "") | |
1603 (whofrom (sc-mail-field "from"))) | |
1604 (if whofrom | |
1605 (insert sc-reference-tag-string | |
1606 (sc-hdr "In article " (sc-mail-field "message-id") ", ") | |
1607 whofrom " writes:\n")))) | |
1608 | |
1609 (defun sc-header-regarding-adds () | |
1610 "\"Regarding <subject>; <from> adds:\" | |
1611 Treats \"subject\" and \"from\" fields similar to `sc-header-on-said'." | |
1612 (let ((sc-mumble "") | |
1613 (whofrom (sc-whofrom))) | |
1614 (if whofrom | |
1615 (insert sc-reference-tag-string | |
1616 (sc-hdr "Regarding " (sc-mail-field "subject") "; ") | |
1617 whofrom " adds:\n")))) | |
1618 | |
1619 (defun sc-header-attributed-writes () | |
1620 "\"<sc-attribution>\" == <sc-author> <address> writes: | |
1621 Treats these fields in a similar manner to `sc-header-on-said'." | |
1622 (let ((sc-mumble "") | |
1623 (whofrom (sc-whofrom))) | |
1624 (if whofrom | |
1625 (insert sc-reference-tag-string | |
1626 (sc-hdr "\"" (sc-mail-field "sc-attribution") "\" == ") | |
1627 (sc-hdr "" (sc-mail-field "sc-author") " ") | |
1628 (or (sc-hdr "<" (sc-mail-field "sc-from-address") ">" t) | |
1629 (sc-hdr "<" (sc-mail-field "sc-reply-address") ">" t) | |
1630 "") | |
1631 " writes:\n")))) | |
1632 | |
1633 (defun sc-header-author-writes () | |
1634 "<sc-author> writes:" | |
1635 (let ((sc-mumble "") | |
1636 (whofrom (sc-whofrom))) | |
1637 (if whofrom | |
1638 (insert sc-reference-tag-string | |
1639 (sc-hdr "" (sc-mail-field "sc-author")) | |
1640 " writes:\n")))) | |
1641 | |
1642 (defun sc-header-verbose () | |
1643 "Very verbose, some say gross." | |
1644 (let ((sc-mumble "") | |
1645 (whofrom (sc-whofrom)) | |
1646 (tag sc-reference-tag-string)) | |
1647 (if whofrom | |
1648 (insert (sc-hdr (concat tag "On ") (sc-mail-field "date") ",\n") | |
1649 (or (sc-hdr tag (sc-mail-field "sc-author") "\n" t) | |
1650 (concat tag whofrom "\n")) | |
1651 (sc-hdr (concat tag "from the organization of ") | |
1652 (sc-mail-field "organization") "\n") | |
1653 (let ((rtag (concat tag "who can be reached at: "))) | |
1654 (or (sc-hdr rtag (sc-mail-field "sc-from-address") "\n" t) | |
1655 (sc-hdr rtag (sc-mail-field "sc-reply-address") "\n" t) | |
1656 "")) | |
1657 (sc-hdr | |
1658 (concat tag "(whose comments are cited below with \"") | |
1659 (sc-mail-field "sc-citation") "\"),\n") | |
1660 (sc-hdr (concat tag "had this to say in article ") | |
1661 (sc-mail-field "message-id") "\n") | |
1662 (sc-hdr (concat tag "in newsgroups ") | |
1663 (sc-mail-field "newsgroups") "\n") | |
1664 (sc-hdr (concat tag "concerning the subject of ") | |
1665 (sc-mail-field "subject") "\n") | |
1666 (sc-hdr (concat tag "(see ") | |
1667 (sc-mail-field "references") | |
1668 " for more details)\n") | |
1669 )))) | |
1670 | |
1671 | |
1672 ;; ====================================================================== | |
1673 ;; header rewrites | |
1674 | |
1675 (defconst sc-electric-bufname " *sc-erefs* " | |
1676 "Supercite electric reference mode's buffer name.") | |
1677 (defvar sc-eref-style 0 | |
1678 "Current electric reference style.") | |
1679 | |
1680 (defun sc-valid-index-p (index) | |
1681 "Returns INDEX if it is a valid index into `sc-rewrite-header-list'. | |
1682 Otherwise returns nil." | |
1683 ;; a number, and greater than or equal to zero | |
1684 ;; less than or equal to the last index | |
1685 (and (natnump index) | |
1686 (< index (length sc-rewrite-header-list)) | |
1687 index)) | |
1688 | |
1689 (defun sc-eref-insert-selected (&optional nomsg) | |
1690 "Insert the selected reference header in the current buffer. | |
1691 Optional NOMSG, if non-nil, inhibits printing messages, unless an | |
1692 error occurs." | |
1693 (let ((ref (nth sc-eref-style sc-rewrite-header-list))) | |
1694 (condition-case err | |
1695 (progn | |
1696 (eval ref) | |
1697 (let ((lines (count-lines (point-min) (point-max)))) | |
1698 (or nomsg (message "Ref header %d [%d line%s]: %s" | |
1699 sc-eref-style lines | |
1700 (if (= lines 1) "" "s") | |
1701 ref)))) | |
1702 (void-function | |
1703 (progn (message | |
1704 "Symbol's function definition is void: %s (Header %d)" | |
1705 (car (cdr err)) sc-eref-style) | |
1706 (beep) | |
1707 )) | |
1708 ))) | |
1709 | |
1710 (defun sc-electric-mode (&optional arg) | |
1711 " | |
1712 Mode for viewing Supercite reference headers. Commands are: | |
1713 \n\\{sc-electric-mode-map} | |
1714 | |
1715 `sc-electric-mode' is not intended to be run interactively, but rather | |
1716 accessed through Supercite's electric reference feature. See | |
1717 `sc-insert-reference' for more details. Optional ARG is the initial | |
1718 header style to use, unless not supplied or invalid, in which case | |
1719 `sc-preferred-header-style' is used." | |
1720 | |
1721 (let ((info sc-mail-info)) | |
1722 | |
1723 (setq sc-eref-style | |
1724 (or (sc-valid-index-p arg) | |
1725 (sc-valid-index-p sc-preferred-header-style) | |
1726 0)) | |
1727 | |
1728 (get-buffer-create sc-electric-bufname) | |
1729 ;; set up buffer and enter command loop | |
1730 (save-excursion | |
1731 (save-window-excursion | |
1732 (pop-to-buffer sc-electric-bufname) | |
1733 (kill-all-local-variables) | |
1734 (let ((sc-mail-info info) | |
1735 (buffer-read-only t) | |
1736 (mode-name "SC Electric Refs") | |
1737 (major-mode 'sc-electric-mode)) | |
1738 (use-local-map sc-electric-mode-map) | |
1739 (sc-eref-show sc-eref-style) | |
1740 (run-hooks 'sc-electric-mode-hook) | |
1741 (recursive-edit) | |
1742 ))) | |
1743 | |
1744 (and sc-eref-style | |
1745 (sc-eref-insert-selected)) | |
1746 (kill-buffer sc-electric-bufname) | |
1747 )) | |
1748 | |
1749 ;; functions for electric reference mode | |
1750 (defun sc-eref-show (index) | |
1751 "Show reference INDEX in `sc-rewrite-header-list'." | |
1752 (let ((msg "No %ing reference headers in list.") | |
1753 (last (length sc-rewrite-header-list))) | |
1754 (setq sc-eref-style | |
1755 (cond | |
1756 ((sc-valid-index-p index) index) | |
1757 ((< index 0) | |
1758 (if sc-electric-circular-p | |
1759 (1- last) | |
1760 (progn (error msg "preced") 0))) | |
1761 ((>= index last) | |
1762 (if sc-electric-circular-p | |
1763 0 | |
1764 (progn (error msg "follow") (1- last)))) | |
1765 )) | |
1766 (save-excursion | |
1767 (set-buffer sc-electric-bufname) | |
1768 (let ((buffer-read-only nil)) | |
1769 (erase-buffer) | |
1770 (goto-char (point-min)) | |
1771 (sc-eref-insert-selected) | |
1772 ;; now shrink the window to just contain the electric reference | |
1773 ;; header. | |
1774 (let ((hdrlines (count-lines (point-min) (point-max))) | |
1775 (winlines (1- (window-height)))) | |
1776 (if (/= hdrlines winlines) | |
1777 (if (> hdrlines winlines) | |
1778 ;; we have to enlarge the window | |
1779 (enlarge-window (- hdrlines winlines)) | |
1780 ;; we have to shrink the window | |
1781 (shrink-window (- winlines (max hdrlines window-min-height))) | |
1782 ))) | |
1783 )))) | |
1784 | |
1785 (defun sc-eref-next () | |
1786 "Display next reference in other buffer." | |
1787 (interactive) | |
1788 (sc-eref-show (1+ sc-eref-style))) | |
1789 | |
1790 (defun sc-eref-prev () | |
1791 "Display previous reference in other buffer." | |
1792 (interactive) | |
1793 (sc-eref-show (1- sc-eref-style))) | |
1794 | |
1795 (defun sc-eref-setn () | |
1796 "Set reference header selected as preferred." | |
1797 (interactive) | |
1798 (setq sc-preferred-header-style sc-eref-style) | |
1799 (message "Preferred reference style set to header %d." sc-eref-style)) | |
1800 | |
1801 (defun sc-eref-goto (refnum) | |
1802 "Show reference style indexed by REFNUM. | |
1803 If REFNUM is an invalid index, don't go to that reference and return | |
1804 nil." | |
1805 (interactive "NGoto Reference: ") | |
1806 (if (sc-valid-index-p refnum) | |
1807 (sc-eref-show refnum) | |
1808 (error "Invalid reference: %d. (Range: [%d .. %d])" | |
1809 refnum 0 (1- (length sc-rewrite-header-list))) | |
1810 )) | |
1811 | |
1812 (defun sc-eref-jump () | |
1813 "Set reference header to preferred header." | |
1814 (interactive) | |
1815 (sc-eref-show sc-preferred-header-style)) | |
1816 | |
1817 (defun sc-eref-abort () | |
1818 "Exit from electric reference mode without inserting reference." | |
1819 (interactive) | |
1820 (setq sc-eref-style nil) | |
1821 (exit-recursive-edit)) | |
1822 | |
1823 (defun sc-eref-exit () | |
1824 "Exit from electric reference mode and insert selected reference." | |
1825 (interactive) | |
1826 (exit-recursive-edit)) | |
1827 | |
1828 (defun sc-insert-reference (arg) | |
1829 "Insert, at point, a reference header in the body of the reply. | |
1830 Numeric ARG indicates which header style from `sc-rewrite-header-list' | |
1831 to use when rewriting the header. No supplied ARG indicates use of | |
1832 `sc-preferred-header-style'. | |
1833 | |
1834 With just `\\[universal-argument]', electric reference insert mode is | |
1835 entered, regardless of the value of `sc-electric-references-p'. See | |
1836 `sc-electric-mode' for more information." | |
1837 (interactive "P") | |
1838 (if (consp arg) | |
1839 (sc-electric-mode) | |
1840 (let ((preference (or (sc-valid-index-p arg) | |
1841 (sc-valid-index-p sc-preferred-header-style) | |
1842 sc-preferred-header-style | |
1843 0))) | |
1844 (if sc-electric-references-p | |
1845 (sc-electric-mode preference) | |
1846 (sc-eref-insert-selected t) | |
1847 )))) | |
1848 | |
1849 | |
1850 ;; ====================================================================== | |
1851 ;; variable toggling | |
1852 | |
1853 (defun sc-raw-mode-toggle () | |
1854 "Toggle, in one fell swoop, two important SC variables: | |
1855 `sc-fixup-whitespace-p' and `sc-auto-fill-region-p'" | |
1856 (interactive) | |
1857 (setq sc-fixup-whitespace-p (not sc-fixup-whitespace-p) | |
1858 sc-auto-fill-region-p (not sc-auto-fill-region-p)) | |
1859 (sc-set-mode-string) | |
11571
771bd7ddd4cc
(sc-raw-mode-toggle): Use force-mode-line-update.
Karl Heuer <kwzh@gnu.org>
parents:
11556
diff
changeset
|
1860 (force-mode-line-update)) |
4850 | 1861 |
1862 (defun sc-toggle-var (variable) | |
1863 "Boolean toggle VARIABLE's value. | |
1864 VARIABLE must be a bound symbol. Nil values change to t, non-nil | |
1865 values are changed to nil." | |
1866 (message "%s changed from %s to %s" | |
1867 variable (symbol-value variable) | |
1868 (set-variable variable (not (eval-expression variable)))) | |
1869 (sc-set-mode-string)) | |
1870 | |
1871 (defun sc-set-variable (var) | |
1872 "Set the Supercite VARIABLE. | |
1873 This function mimics `set-variable', except that the variable to set | |
1874 is determined non-interactively. The value is queried for in the | |
1875 minibuffer exactly the same way that `set-variable' does it. | |
1876 | |
1877 You can see the current value of the variable when the minibuffer is | |
1878 querying you by typing `C-h'. Note that the format is changed | |
1879 slightly from that used by `set-variable' -- the current value is | |
1880 printed just after the variable's name instead of at the bottom of the | |
1881 help window." | |
1882 (let* ((minibuffer-help-form | |
1883 '(funcall myhelp)) | |
1884 (myhelp | |
1885 (function | |
1886 (lambda () | |
1887 (with-output-to-temp-buffer "*Help*" | |
1888 (prin1 var) | |
1889 (if (boundp var) | |
1890 (let ((print-length 20)) | |
1891 (princ "\t(Current value: ") | |
1892 (prin1 (symbol-value var)) | |
1893 (princ ")"))) | |
1894 (princ "\n\nDocumentation:\n") | |
1895 (princ (substring (documentation-property | |
1896 var | |
1897 'variable-documentation) | |
1898 1)) | |
9845
17734f1247d0
(sc-set-variable): Set help-mode in *Help* buffer.
Karl Heuer <kwzh@gnu.org>
parents:
7639
diff
changeset
|
1899 (save-excursion |
17734f1247d0
(sc-set-variable): Set help-mode in *Help* buffer.
Karl Heuer <kwzh@gnu.org>
parents:
7639
diff
changeset
|
1900 (set-buffer standard-output) |
17734f1247d0
(sc-set-variable): Set help-mode in *Help* buffer.
Karl Heuer <kwzh@gnu.org>
parents:
7639
diff
changeset
|
1901 (help-mode)) |
4850 | 1902 nil))))) |
1903 (set var (eval-minibuffer (format "Set %s to value: " var)))) | |
1904 (sc-set-mode-string)) | |
1905 | |
1906 (defmacro sc-toggle-symbol (rootname) | |
1907 (list 'defun (intern (concat "sc-T-" rootname)) '() | |
1908 (list 'interactive) | |
1909 (list 'sc-toggle-var | |
1910 (list 'quote (intern (concat "sc-" rootname "-p")))))) | |
1911 | |
1912 (defmacro sc-setvar-symbol (rootname) | |
1913 (list 'defun (intern (concat "sc-S-" rootname)) '() | |
1914 (list 'interactive) | |
1915 (list 'sc-set-variable | |
1916 (list 'quote (intern (concat "sc-" rootname)))))) | |
1917 | |
1918 (sc-toggle-symbol "confirm-always") | |
1919 (sc-toggle-symbol "downcase") | |
1920 (sc-toggle-symbol "electric-references") | |
1921 (sc-toggle-symbol "auto-fill-region") | |
1922 (sc-toggle-symbol "mail-nuke-blank-lines") | |
1923 (sc-toggle-symbol "nested-citation") | |
1924 (sc-toggle-symbol "electric-circular") | |
1925 (sc-toggle-symbol "use-only-preferences") | |
1926 (sc-toggle-symbol "fixup-whitespace") | |
1927 | |
1928 (sc-setvar-symbol "preferred-attribution-list") | |
1929 (sc-setvar-symbol "preferred-header-style") | |
1930 (sc-setvar-symbol "mail-nuke-mail-headers") | |
1931 (sc-setvar-symbol "mail-header-nuke-list") | |
1932 (sc-setvar-symbol "cite-region-limit") | |
1933 | |
1934 (defun sc-T-describe () | |
1935 " | |
1936 | |
1937 Supercite provides a number of key bindings which simplify the process | |
1938 of setting or toggling certain variables controlling its operation. | |
1939 | |
1940 Note on function names in this list: all functions of the form | |
1941 `sc-S-<name>' actually call `sc-set-variable' on the corresponding | |
1942 `sc-<name>' variable. All functions of the form `sc-T-<name>' call | |
1943 `sc-toggle-var' on the corresponding `sc-<name>-p' variable. | |
1944 | |
1945 \\{sc-T-keymap}" | |
1946 (interactive) | |
1947 (describe-function 'sc-T-describe)) | |
1948 | |
1949 (defun sc-set-mode-string () | |
1950 "Update the minor mode string to show state of Supercite." | |
1951 (setq sc-mode-string | |
1952 (concat " SC" | |
1953 (if (or sc-auto-fill-region-p | |
1954 sc-fixup-whitespace-p) | |
1955 ":" "") | |
1956 (if sc-auto-fill-region-p "f" "") | |
1957 (if sc-fixup-whitespace-p "w" "") | |
1958 ))) | |
1959 | |
1960 | |
1961 ;; ====================================================================== | |
1962 ;; published interface to mail and news readers | |
1963 | |
7370
ecb09a00d330
(sc-cite-original): Add autoload.
Richard M. Stallman <rms@gnu.org>
parents:
5286
diff
changeset
|
1964 ;;;###autoload |
4850 | 1965 (defun sc-cite-original () |
1966 "Workhorse citing function which performs the initial citation. | |
1967 This is callable from the various mail and news readers' reply | |
1968 function according to the agreed upon standard. See `\\[sc-describe]' | |
1969 for more details. `sc-cite-original' does not do any yanking of the | |
1970 original message but it does require a few things: | |
1971 | |
1972 1) The reply buffer is the current buffer. | |
1973 | |
1974 2) The original message has been yanked and inserted into the | |
1975 reply buffer. | |
1976 | |
1977 3) Verbose mail headers from the original message have been | |
1978 inserted into the reply buffer directly before the text of the | |
1979 original message. | |
1980 | |
1981 4) Point is at the beginning of the verbose headers. | |
1982 | |
1983 5) Mark is at the end of the body of text to be cited. | |
1984 | |
1985 For Emacs 19's, the region need not be active (and typically isn't | |
1986 when this function is called. Also, the hook `sc-pre-hook' is run | |
1987 before, and `sc-post-hook' is run after the guts of this function." | |
1988 (run-hooks 'sc-pre-hook) | |
1989 | |
1990 ;; before we do anything, we want to insert the supercite keymap so | |
1991 ;; we can proceed from here | |
1992 (and sc-mode-map-prefix | |
1993 (local-set-key sc-mode-map-prefix sc-mode-map)) | |
1994 | |
1995 ;; hack onto the minor mode alist, if it hasn't been done before, | |
1996 ;; then turn on the minor mode. also, set the minor mode string with | |
1997 ;; the values of fill and fixup whitespace variables | |
1998 (if (not (get 'minor-mode-alist 'sc-minor-mode)) | |
1999 (progn | |
2000 (put 'minor-mode-alist 'sc-minor-mode 'sc-minor-mode) | |
2001 (setq minor-mode-alist | |
2002 (cons '(sc-minor-mode sc-mode-string) minor-mode-alist)) | |
2003 )) | |
2004 (setq sc-minor-mode t) | |
2005 (sc-set-mode-string) | |
2006 | |
2007 (undo-boundary) | |
2008 | |
2009 ;; grab point and mark since the region is probably not active when | |
2010 ;; this function gets automatically called. we want point to be a | |
2011 ;; mark so any deleting before point works properly | |
2012 (let* ((zmacs-regions nil) ; for Lemacs | |
2013 (mark-active t) ; for FSFmacs | |
2014 (point (point-marker)) | |
2015 (mark (copy-marker (mark-marker)))) | |
2016 | |
2017 ;; make sure point comes before mark, not all functions are | |
2018 ;; interactive "r" | |
2019 (if (< mark point) | |
2020 (let ((tmp point)) | |
2021 (setq point mark | |
2022 mark tmp))) | |
2023 | |
2024 ;; first process mail headers, and populate sc-mail-info | |
2025 (sc-mail-process-headers point mark) | |
2026 | |
2027 ;; now get possible attributions | |
2028 (sc-attribs-chop-address (or (sc-mail-field "from") | |
2029 (sc-mail-field "reply") | |
2030 (sc-mail-field "reply-to") | |
2031 (sc-mail-field "sender"))) | |
2032 ;; select the attribution | |
2033 (sc-select-attribution) | |
2034 | |
2035 ;; cite the region, but first check the value of sc-cite-region-limit | |
2036 (let ((linecnt (count-lines point mark))) | |
2037 (and sc-cite-region-limit | |
2038 (if (or (not (numberp sc-cite-region-limit)) | |
2039 (<= linecnt sc-cite-region-limit)) | |
2040 (progn | |
2041 ;; cite the region and insert the header rewrite | |
2042 (sc-cite-region point mark) | |
2043 (goto-char point) | |
2044 (let ((sc-eref-style (or sc-preferred-header-style 0))) | |
2045 (if sc-electric-references-p | |
2046 (sc-electric-mode sc-eref-style) | |
2047 (sc-eref-insert-selected t)))) | |
2048 (beep) | |
2049 (message | |
2050 "Region not cited. %d lines exceeds sc-cite-region-limit: %d" | |
2051 linecnt sc-cite-region-limit)))) | |
2052 | |
2053 ;; finally, free the point-marker | |
2054 (set-marker point nil) | |
2055 (set-marker mark nil) | |
2056 ) | |
2057 (run-hooks 'sc-post-hook) | |
2058 ;; post hook could have changed the variables | |
2059 (sc-set-mode-string)) | |
2060 | |
2061 | |
2062 ;; ====================================================================== | |
2063 ;; bug reporting and miscellaneous commands | |
2064 | |
2065 (defun sc-open-line (arg) | |
2066 "Like `open-line', but insert the citation prefix at the front of the line. | |
2067 With numeric ARG, inserts that many new lines." | |
2068 (interactive "p") | |
2069 (save-excursion | |
2070 (let ((start (point)) | |
2071 (prefix (or (progn (beginning-of-line) | |
2072 (if (looking-at (sc-cite-regexp)) | |
2073 (sc-submatch 0))) | |
2074 ""))) | |
2075 (goto-char start) | |
2076 (open-line arg) | |
2077 (forward-line 1) | |
2078 (while (< 0 arg) | |
2079 (insert prefix) | |
2080 (forward-line 1) | |
2081 (setq arg (1- arg)) | |
2082 )))) | |
2083 | |
2084 (defun sc-insert-citation (arg) | |
2085 "Insert citation string at beginning of current line if not already cited. | |
2086 With `\\[universal-argument]' insert citation even if line is already | |
2087 cited." | |
2088 (interactive "P") | |
2089 (save-excursion | |
2090 (beginning-of-line) | |
2091 (if (or (not (looking-at (sc-cite-regexp))) | |
2092 (looking-at "^[ \t]*$") | |
2093 (consp arg)) | |
2094 (insert (sc-mail-field "sc-citation")) | |
2095 (error "Line is already cited.")))) | |
2096 | |
2097 (defun sc-version (arg) | |
2098 "Echo the current version of Supercite in the minibuffer. | |
2099 With \\[universal-argument] (universal-argument), or if run non-interactively, | |
2100 inserts the version string in the current buffer instead." | |
2101 (interactive "P") | |
2102 (let ((verstr (format "Using Supercite.el %s" sc-version))) | |
2103 (if (or (consp arg) | |
2104 (not (interactive-p))) | |
2105 (insert "`sc-version' says: " verstr) | |
2106 (message verstr)))) | |
2107 | |
2108 (defun sc-describe () | |
2109 " | |
2110 Supercite is a package which provides a flexible mechanism for citing | |
2111 email and news replies. Please see the associated texinfo file for | |
2112 more information." | |
2113 (interactive) | |
2114 (describe-function 'sc-describe)) | |
2115 | |
2116 (defun sc-submit-bug-report () | |
2117 "Submit a bug report on Supercite via mail." | |
2118 (interactive) | |
2119 (require 'reporter) | |
2120 (and | |
2121 (y-or-n-p "Do you want to submit a report on Supercite? ") | |
2122 (reporter-submit-bug-report | |
2123 sc-help-address | |
2124 (concat "Supercite version " sc-version) | |
2125 (list | |
2126 'sc-attrib-selection-list | |
2127 'sc-auto-fill-region-p | |
2128 'sc-blank-lines-after-headers | |
2129 'sc-citation-leader | |
2130 'sc-citation-delimiter | |
2131 'sc-citation-separator | |
2132 'sc-citation-leader-regexp | |
2133 'sc-citation-root-regexp | |
2134 'sc-citation-nonnested-root-regexp | |
2135 'sc-citation-delimiter-regexp | |
2136 'sc-citation-separator-regexp | |
2137 'sc-cite-region-limit | |
2138 'sc-confirm-always-p | |
2139 'sc-default-attribution | |
2140 'sc-default-author-name | |
2141 'sc-downcase-p | |
2142 'sc-electric-circular-p | |
2143 'sc-electric-references-p | |
2144 'sc-fixup-whitespace-p | |
2145 'sc-mail-warn-if-non-rfc822-p | |
2146 'sc-mumble | |
2147 'sc-name-filter-alist | |
2148 'sc-nested-citation-p | |
2149 'sc-nuke-mail-headers | |
2150 'sc-nuke-mail-header-list | |
2151 'sc-preferred-attribution-list | |
2152 'sc-preferred-header-style | |
2153 'sc-reference-tag-string | |
2154 'sc-rewrite-header-list | |
2155 'sc-titlecue-regexp | |
2156 'sc-use-only-preference-p | |
2157 )))) | |
2158 | |
2159 | |
2160 ;; useful stuff | |
2161 (provide 'supercite) | |
2162 (run-hooks 'sc-load-hook) | |
2163 | |
2164 ;;; supercite.el ends here |