| blob | 347db281f1a229909f7b95024503caab336b848d |
1 ;;; iso-acc.el --- minor mode providing electric accent keys
3 ;; Copyright (C) 1993-1994, 1996, 2001-2011 Free Software Foundation, Inc.
5 ;; Author: Johan Vromans
6 ;; Maintainer: FSF
7 ;; Keywords: i18n
8 ;; Obsolete-since: 22.1
10 ;; This file is part of GNU Emacs.
12 ;; GNU Emacs is free software: you can redistribute it and/or modify
13 ;; it under the terms of the GNU General Public License as published by
14 ;; the Free Software Foundation, either version 3 of the License, or
15 ;; (at your option) any later version.
17 ;; GNU Emacs is distributed in the hope that it will be useful,
18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 ;; GNU General Public License for more details.
22 ;; You should have received a copy of the GNU General Public License
23 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
25 ;;; Commentary:
27 ;; Function `iso-accents-mode' activates a minor mode in which
28 ;; typewriter "dead keys" are emulated. The purpose of this emulation
29 ;; is to provide a simple means for inserting accented characters
30 ;; according to the ISO-8859-1...3 character sets.
31 ;;
32 ;; In `iso-accents-mode', pseudo accent characters are used to
33 ;; introduce accented keys. The pseudo-accent characters are:
34 ;;
35 ;; ' (minute) -> acute accent
36 ;; ` (backtick) -> grave accent
37 ;; " (second) -> diaeresis
38 ;; ^ (caret) -> circumflex
39 ;; ~ (tilde) -> tilde over the character
40 ;; / (slash) -> slash through the character.
41 ;; Also: /A is A-with-ring and /E is AE ligature.
42 ;; These two are enabled only if you set iso-accents-enable
43 ;; to include them:
44 ;; . (period) -> dot over the character (some languages only)
45 ;; , (cedilla) -> cedilla under the character (some languages only)
46 ;;
47 ;; The action taken depends on the key that follows the pseudo accent.
48 ;; In general:
49 ;;
50 ;; pseudo-accent + appropriate letter -> accented letter
51 ;; pseudo-accent + space -> pseudo-accent (except comma and period)
52 ;; pseudo-accent + pseudo-accent -> accent (if available)
53 ;; pseudo-accent + other -> pseudo-accent + other
54 ;;
55 ;; If the pseudo-accent is followed by anything else than a
56 ;; self-insert-command, the dead-key code is terminated, the
57 ;; pseudo-accent inserted 'as is' and the bell is rung to signal this.
58 ;;
59 ;; Function `iso-accents-mode' can be used to enable the iso accents
60 ;; minor mode, or disable it.
62 ;; If you want only some of these characters to serve as accents,
63 ;; add a language to `iso-languages' which specifies the accent characters
64 ;; that you want, then select the language with `iso-accents-customize'.
65 \f
66 ;;; Code:
71 "Minor mode providing electric accent keys."
76 "*Offset added by ISO Accents mode to character codes 0200 and above."
82 ;; Note this includes some extra characters used in Spanish,
83 ;; on the idea that someone who uses Catalan is likely to use Spanish
84 ;; as well.
238 "List of language-specific customizations for the ISO Accents mode.
240 Each element of the list is of the form
242 (LANGUAGE [CHARSET]
243 (PSEUDO-ACCENT MAPPINGS)
244 (PSEUDO-ACCENT MAPPINGS)
245 ...)
247 LANGUAGE is a string naming the language.
248 CHARSET (which may be omitted) is the symbol name
249 of the character set used in this language.
250 If CHARSET is omitted, latin-iso8859-1 is the default.
251 PSEUDO-ACCENT is a char specifying an accent key.
252 MAPPINGS are cons cells of the form (CHAR . ISO-CHAR).
254 The net effect is that the key sequence PSEUDO-ACCENT CHAR is mapped
258 "Language for which ISO Accents mode is currently customized.
265 "*Non-nil enables ISO Accents mode.
266 Setting this variable makes it local to the current buffer.
267 See the function `iso-accents-mode'."
273 "*List of accent keys that become prefixes in ISO Accents mode.
275 accent keys. If you set this variable to a list in which some of those
276 characters are missing, the missing ones do not act as accents.
278 Note that if you specify a language with `iso-accents-customize',
279 that can also turn off certain prefixes (whichever ones are not needed in
280 the language you choose)."
285 "Modify the following character by adding an accent to it."
286 ;; Pick up the accent character.
293 ;; The iso-accents-compose function is called deep inside Emacs' read
294 ;; key sequence machinery, so the call to read-event below actually
295 ;; recurses into that machinery. Doing that does not cause any
296 ;; problem on its own, but read-event will have marked the window's
297 ;; display matrix to be accurate -- which is broken by the subsequent
298 ;; call to delete-region. Therefore, we must call force-window-update
299 ;; after delete-region to explicitly clear the accurate state of the
300 ;; window's display matrix.
305 ;; Wait for the second key and look up the combination.
309 ;; Not at start of a key sequence.
311 ;; Called from anything but the command loop.
312 this-command)
316 first-char)
321 ;; Display is no longer up-to-date.
325 ;; Found it: return the mapped char
330 entry))
331 ;; Otherwise, advance and schedule the second key for execution.
335 ;; It is a matter of taste if you want the minor mode indicated
336 ;; in the mode line...
337 ;; If so, uncomment the next four lines.
338 ;; (or (assq 'iso-accents-mode minor-mode-alist)
339 ;; (setq minor-mode-alist
340 ;; (append minor-mode-alist
341 ;; '((iso-accents-mode " ISO-Acc")))))
343 ;;;###autoload
345 "Toggle ISO Accents mode, in which accents modify the following letter.
346 This permits easy insertion of accented characters according to ISO-8859-1.
347 When Iso-accents mode is enabled, accent character keys
349 letter key so that it inserts an ISO accented letter.
351 You can customize ISO Accents mode to a particular language
352 with the command `iso-accents-customize'.
354 Special combinations: ~c gives a c with cedilla,
355 ~d gives an Icelandic eth (d with dash).
356 ~t gives an Icelandic thorn.
358 /a gives a with ring.
359 /e gives an a-e ligature.
360 ~< and ~> give guillemots.
361 ~! gives an inverted exclamation mark.
362 ~? gives an inverted question mark.
364 With an argument, a positive argument enables ISO Accents mode,
365 and a negative argument disables it."
370 ;; Negative arg means switch it off.
372 ;; No arg means toggle.
373 iso-accents-mode)
376 ;; Enable electric accents.
380 "Customize the ISO accents machinery for a particular language.
381 It selects the customization based on the specifications in the
382 `iso-languages' variable."
385 all-accents tail)
395 iso-accents-list table)
400 ;; Set up translations for all the characters that are used as
401 ;; accent prefixes in this language.
409 "Convert two-character sequences in region into accented characters.
410 Noninteractively, this operates on text from START to END.
411 This uses the same conversion that ISO Accents mode uses for type-in."
439 "Convert accented characters in the region into two-character sequences.
440 Noninteractively, this operates on text from START to END.
441 This uses the opposite of the conversion done by ISO Accents mode for type-in."
451 iso-accents-list)))
459 "Convert accented characters in the region into unaccented characters.
460 Noninteractively, this operates on text from START to END."
470 iso-accents-list)))
476 ;; Set up the default settings.
479 ;; Use Iso-Accents mode in the minibuffer
480 ;; if it was in use in the previous buffer.
484 iso-accents-mode)))
488 ;;; iso-acc.el ends here