1 ;;; mule.el --- basic commands for mulitilingual environment
3 ;; Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007
4 ;; Free Software Foundation, Inc.
5 ;; Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
7 ;; National Institute of Advanced Industrial Science and Technology (AIST)
8 ;; Registration Number H14PRO021
10 ;; Keywords: mule, multilingual, character set, coding system
12 ;; This file is part of GNU Emacs.
14 ;; GNU Emacs is free software; you can redistribute it and/or modify
15 ;; it under the terms of the GNU General Public License as published by
16 ;; the Free Software Foundation; either version 2, or (at your option)
19 ;; GNU Emacs is distributed in the hope that it will be useful,
20 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
21 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 ;; GNU General Public License for more details.
24 ;; You should have received a copy of the GNU General Public License
25 ;; along with GNU Emacs; see the file COPYING. If not, write to the
26 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
27 ;; Boston, MA 02110-1301, USA.
33 (defconst mule-version
"5.0 (SAKAKI)" "\
34 Version number and name of this version of MULE (multilingual environment).")
36 (defconst mule-version-date
"1999.12.7" "\
37 Distribution date of this version of MULE (multilingual environment).")
39 (defun load-with-code-conversion (fullname file
&optional noerror nomessage
)
40 "Execute a file of Lisp code named FILE whose absolute name is FULLNAME.
41 The file contents are decoded before evaluation if necessary.
42 If optional third arg NOERROR is non-nil,
43 report no error if FILE doesn't exist.
44 Print messages at start and end of loading unless
45 optional fourth arg NOMESSAGE is non-nil.
46 Return t if file exists."
47 (if (null (file-readable-p fullname
))
49 (signal 'file-error
(list "Cannot open load file" file
)))
50 ;; Read file with code conversion, and then eval.
52 ;; To avoid any autoloading, set default-major-mode to
54 ;; So that we don't get completely screwed if the
55 ;; file is encoded in some complicated character set,
56 ;; read it with real decoding, as a multibyte buffer,
57 ;; even if this is a --unibyte Emacs session.
58 (let ((default-major-mode 'fundamental-mode
)
59 (default-enable-multibyte-characters t
))
60 ;; We can't use `generate-new-buffer' because files.el
62 (get-buffer-create (generate-new-buffer-name " *load*"))))
64 (source (save-match-data (string-match "\\.el\\'" fullname
))))
67 (message "Loading %s (source)..." file
)
68 (message "Loading %s..." file
)))
70 (push file preloaded-file-list
))
72 (let ((load-file-name fullname
)
73 (set-auto-coding-for-load t
)
74 (inhibit-file-name-operation nil
))
75 (with-current-buffer buffer
76 ;; Don't let deactivate-mark remain set.
77 (let (deactivate-mark)
78 (insert-file-contents fullname
))
79 ;; If the loaded file was inserted with no-conversion or
80 ;; raw-text coding system, make the buffer unibyte.
81 ;; Otherwise, eval-buffer might try to interpret random
82 ;; binary junk as multibyte characters.
83 (if (and enable-multibyte-characters
84 (or (eq (coding-system-type last-coding-system-used
) 5)
85 (eq last-coding-system-used
'no-conversion
)))
86 (set-buffer-multibyte nil
))
87 ;; Make `kill-buffer' quiet.
88 (set-buffer-modified-p nil
))
89 ;; Have the original buffer current while we eval.
90 (eval-buffer buffer nil
91 ;; This is compatible with what `load' does.
92 (if purify-flag file fullname
)
93 ;; If this Emacs is running with --unibyte,
94 ;; convert multibyte strings to unibyte
95 ;; after reading them.
96 ;; (not default-enable-multibyte-characters)
99 (let (kill-buffer-hook kill-buffer-query-functions
)
100 (kill-buffer buffer
)))
102 (do-after-load-evaluation fullname
))
104 (unless (or nomessage noninteractive
)
106 (message "Loading %s (source)...done" file
)
107 (message "Loading %s...done" file
)))
110 ;; API (Application Program Interface) for charsets.
112 (defsubst charset-quoted-standard-p
(obj)
113 "Return t if OBJ is a quoted symbol, and is the name of a standard charset."
114 (and (listp obj
) (eq (car obj
) 'quote
)
115 (symbolp (car-safe (cdr obj
)))
116 (let ((vector (get (car-safe (cdr obj
)) 'charset
)))
117 (and (vectorp vector
)
118 (< (aref vector
0) 160)))))
120 (defsubst charsetp
(object)
121 "Return t if OBJECT is a charset."
122 (and (symbolp object
) (vectorp (get object
'charset
))))
124 (defsubst charset-info
(charset)
125 "Return a vector of information of CHARSET.
126 The elements of the vector are:
127 CHARSET-ID, BYTES, DIMENSION, CHARS, WIDTH, DIRECTION,
128 LEADING-CODE-BASE, LEADING-CODE-EXT,
129 ISO-FINAL-CHAR, ISO-GRAPHIC-PLANE,
130 REVERSE-CHARSET, SHORT-NAME, LONG-NAME, DESCRIPTION,
133 CHARSET-ID (integer) is the identification number of the charset.
134 BYTES (integer) is the length of multi-byte form of a character in
135 the charset: one of 1, 2, 3, and 4.
136 DIMENSION (integer) is the number of bytes to represent a character of
138 CHARS (integer) is the number of characters in a dimension: 94 or 96.
139 WIDTH (integer) is the number of columns a character in the charset
140 occupies on the screen: one of 0, 1, and 2.
141 DIRECTION (integer) is the rendering direction of characters in the
142 charset when rendering. If 0, render from left to right, else
143 render from right to left.
144 LEADING-CODE-BASE (integer) is the base leading-code for the
146 LEADING-CODE-EXT (integer) is the extended leading-code for the
147 charset. All charsets of less than 0xA0 has the value 0.
148 ISO-FINAL-CHAR (character) is the final character of the
149 corresponding ISO 2022 charset. If the charset is not assigned
150 any final character, the value is -1.
151 ISO-GRAPHIC-PLANE (integer) is the graphic plane to be invoked
152 while encoding to variants of ISO 2022 coding system, one of the
153 following: 0/graphic-plane-left(GL), 1/graphic-plane-right(GR).
154 If the charset is not assigned any final character, the value is -1.
155 REVERSE-CHARSET (integer) is the charset which differs only in
156 LEFT-TO-RIGHT value from the charset. If there's no such a
157 charset, the value is -1.
158 SHORT-NAME (string) is the short name to refer to the charset.
159 LONG-NAME (string) is the long name to refer to the charset
160 DESCRIPTION (string) is the description string of the charset.
161 PLIST (property list) may contain any type of information a user
162 want to put and get by functions `put-charset-property' and
163 `get-charset-property' respectively."
164 (get charset
'charset
))
166 ;; It is better not to use backquote in this file,
167 ;; because that makes a bootstrapping problem
168 ;; if you need to recompile all the Lisp files using interpreted code.
170 (defmacro charset-id
(charset)
171 "Return charset identification number of CHARSET."
172 (if (charset-quoted-standard-p charset
)
173 (aref (charset-info (nth 1 charset
)) 0)
174 (list 'aref
(list 'charset-info charset
) 0)))
176 (defmacro charset-bytes
(charset)
177 "Return bytes of CHARSET.
178 See the function `charset-info' for more detail."
179 (if (charset-quoted-standard-p charset
)
180 (aref (charset-info (nth 1 charset
)) 1)
181 (list 'aref
(list 'charset-info charset
) 1)))
183 (defmacro charset-dimension
(charset)
184 "Return dimension of CHARSET.
185 See the function `charset-info' for more detail."
186 (if (charset-quoted-standard-p charset
)
187 (aref (charset-info (nth 1 charset
)) 2)
188 (list 'aref
(list 'charset-info charset
) 2)))
190 (defmacro charset-chars
(charset)
191 "Return character numbers contained in a dimension of CHARSET.
192 See the function `charset-info' for more detail."
193 (if (charset-quoted-standard-p charset
)
194 (aref (charset-info (nth 1 charset
)) 3)
195 (list 'aref
(list 'charset-info charset
) 3)))
197 (defmacro charset-width
(charset)
198 "Return width (how many column occupied on a screen) of CHARSET.
199 See the function `charset-info' for more detail."
200 (if (charset-quoted-standard-p charset
)
201 (aref (charset-info (nth 1 charset
)) 4)
202 (list 'aref
(list 'charset-info charset
) 4)))
204 (defmacro charset-direction
(charset)
205 "Return direction of CHARSET.
206 See the function `charset-info' for more detail."
207 (if (charset-quoted-standard-p charset
)
208 (aref (charset-info (nth 1 charset
)) 5)
209 (list 'aref
(list 'charset-info charset
) 5)))
211 (defmacro charset-iso-final-char
(charset)
212 "Return final char of CHARSET.
213 See the function `charset-info' for more detail."
214 (if (charset-quoted-standard-p charset
)
215 (aref (charset-info (nth 1 charset
)) 8)
216 (list 'aref
(list 'charset-info charset
) 8)))
218 (defmacro charset-iso-graphic-plane
(charset)
219 "Return graphic plane of CHARSET.
220 See the function `charset-info' for more detail."
221 (if (charset-quoted-standard-p charset
)
222 (aref (charset-info (nth 1 charset
)) 9)
223 (list 'aref
(list 'charset-info charset
) 9)))
225 (defmacro charset-reverse-charset
(charset)
226 "Return reverse charset of CHARSET.
227 See the function `charset-info' for more detail."
228 (if (charset-quoted-standard-p charset
)
229 (aref (charset-info (nth 1 charset
)) 10)
230 (list 'aref
(list 'charset-info charset
) 10)))
232 (defmacro charset-short-name
(charset)
233 "Return short name of CHARSET.
234 See the function `charset-info' for more detail."
235 (if (charset-quoted-standard-p charset
)
236 (aref (charset-info (nth 1 charset
)) 11)
237 (list 'aref
(list 'charset-info charset
) 11)))
239 (defmacro charset-long-name
(charset)
240 "Return long name of CHARSET.
241 See the function `charset-info' for more detail."
242 (if (charset-quoted-standard-p charset
)
243 (aref (charset-info (nth 1 charset
)) 12)
244 (list 'aref
(list 'charset-info charset
) 12)))
246 (defmacro charset-description
(charset)
247 "Return description of CHARSET.
248 See the function `charset-info' for more detail."
249 (if (charset-quoted-standard-p charset
)
250 (aref (charset-info (nth 1 charset
)) 13)
251 (list 'aref
(list 'charset-info charset
) 13)))
253 (defmacro charset-plist
(charset)
254 "Return list charset property of CHARSET.
255 See the function `charset-info' for more detail."
257 (if (charset-quoted-standard-p charset
)
258 (charset-info (nth 1 charset
))
259 (list 'charset-info charset
))
262 (defun set-charset-plist (charset plist
)
263 "Set CHARSET's property list to PLIST, and return PLIST."
264 (aset (charset-info charset
) 14 plist
))
266 (defun make-char (charset &optional code1 code2
)
267 "Return a character of CHARSET whose position codes are CODE1 and CODE2.
268 CODE1 and CODE2 are optional, but if you don't supply
269 sufficient position codes, return a generic character which stands for
270 all characters or group of characters in the character set.
271 A generic character can be used to index a char table (e.g. `syntax-table').
273 Such character sets as ascii, eight-bit-control, and eight-bit-graphic
274 don't have corresponding generic characters. If CHARSET is one of
275 them and you don't supply CODE1, return the character of the smallest
278 If CODE1 or CODE2 are invalid (out of range), this function signals an
279 error. However, the eighth bit of both CODE1 and CODE2 is zeroed
280 before they are used to index CHARSET. Thus you may use, say, the
281 actual ISO 8859 character code rather than subtracting 128, as you
282 would need to index the corresponding Emacs charset."
283 (make-char-internal (charset-id charset
) code1 code2
))
285 (put 'make-char
'byte-compile
287 (let ((charset (nth 1 form
)))
288 (byte-compile-normal-call
289 (cons 'make-char-internal
290 (cons (if (charset-quoted-standard-p charset
)
291 (charset-id (nth 1 charset
))
292 (list 'charset-id charset
))
293 (nthcdr 2 form
)))))))
295 (defun charset-list ()
296 "Return list of charsets ever defined.
298 This function is provided for backward compatibility.
299 Now we have the variable `charset-list'."
302 (defsubst generic-char-p
(char)
303 "Return t if and only if CHAR is a generic character.
304 See also the documentation of `make-char'."
306 (let ((l (split-char char
)))
307 (and (or (= (nth 1 l
) 0) (eq (nth 2 l
) 0))
308 (not (eq (car l
) 'composition
))))))
310 (defun decode-char (ccs code-point
&optional restriction
)
311 "Return character specified by coded character set CCS and CODE-POINT in it.
312 Return nil if such a character is not supported.
313 Currently the only supported coded character set is `ucs' (ISO/IEC
314 10646: Universal Multi-Octet Coded Character Set), and the result is
315 translated through the translation-table named
316 `utf-translation-table-for-decode', or through the
317 translation-hash-table named `utf-subst-table-for-decode'
318 \(if `utf-translate-cjk-mode' is non-nil).
320 Optional argument RESTRICTION specifies a way to map the pair of CCS
321 and CODE-POINT to a character. Currently not supported and just ignored."
324 (or (and utf-translate-cjk-mode
325 (utf-lookup-subst-table-for-decode code-point
))
330 (make-char 'latin-iso8859-1 code-point
))
331 ((< code-point
#x2500
)
332 (setq code-point
(- code-point
#x0100
))
333 (make-char 'mule-unicode-0100-24ff
334 (+ (/ code-point
96) 32) (+ (% code-point
96) 32)))
335 ((< code-point
#x3400
)
336 (setq code-point
(- code-point
#x2500
))
337 (make-char 'mule-unicode-2500-33ff
338 (+ (/ code-point
96) 32) (+ (% code-point
96) 32)))
339 ((and (>= code-point
#xe000
) (< code-point
#x10000
))
340 (setq code-point
(- code-point
#xe000
))
341 (make-char 'mule-unicode-e000-ffff
342 (+ (/ code-point
96) 32)
343 (+ (% code-point
96) 32))))))
345 (or (aref (get 'utf-translation-table-for-decode
346 'translation-table
) c
)
349 (defun encode-char (char ccs
&optional restriction
)
350 "Return code-point in coded character set CCS that corresponds to CHAR.
351 Return nil if CHAR is not included in CCS.
352 Currently the only supported coded character set is `ucs' (ISO/IEC
353 10646: Universal Multi-Octet Coded Character Set), and CHAR is first
354 translated through the translation-table named
355 `utf-translation-table-for-encode', or through the
356 translation-hash-table named `utf-subst-table-for-encode' \(if
357 `utf-translate-cjk-mode' is non-nil).
359 CHAR should be in one of these charsets:
360 ascii, latin-iso8859-1, mule-unicode-0100-24ff, mule-unicode-2500-33ff,
361 mule-unicode-e000-ffff, eight-bit-control
362 Otherwise, return nil.
364 Optional argument RESTRICTION specifies a way to map CHAR to a
365 code-point in CCS. Currently not supported and just ignored."
366 (let* ((split (split-char char
))
367 (charset (car split
))
370 (or (and utf-translate-cjk-mode
371 (utf-lookup-subst-table-for-encode char
))
372 (let ((table (get 'utf-translation-table-for-encode
373 'translation-table
)))
374 (setq trans
(aref table char
))
376 (setq split
(split-char trans
)
377 charset
(car split
)))
378 (cond ((eq charset
'ascii
)
380 ((eq charset
'latin-iso8859-1
)
381 (+ (nth 1 split
) 128))
382 ((eq charset
'mule-unicode-0100-24ff
)
383 (+ #x0100
(+ (* (- (nth 1 split
) 32) 96)
384 (- (nth 2 split
) 32))))
385 ((eq charset
'mule-unicode-2500-33ff
)
386 (+ #x2500
(+ (* (- (nth 1 split
) 32) 96)
387 (- (nth 2 split
) 32))))
388 ((eq charset
'mule-unicode-e000-ffff
)
389 (+ #xe000
(+ (* (- (nth 1 split
) 32) 96)
390 (- (nth 2 split
) 32))))
391 ((eq charset
'eight-bit-control
)
395 ;; Save the ASCII case table in case we need it later. Some locales
396 ;; (such as Turkish) modify the case behavior of ASCII characters,
397 ;; which can interfere with networking code that uses ASCII strings.
399 (defvar ascii-case-table
400 ;; Code copied from copy-case-table to avoid requiring case-table.el
401 (let ((tbl (copy-sequence (standard-case-table)))
402 (up (char-table-extra-slot (standard-case-table) 0)))
403 (if up
(set-char-table-extra-slot tbl
0 (copy-sequence up
)))
404 (set-char-table-extra-slot tbl
1 nil
)
405 (set-char-table-extra-slot tbl
2 nil
)
407 "Case table for the ASCII character set.")
409 ;; Coding system stuff
411 ;; Coding system is a symbol that has the property `coding-system'.
413 ;; The value of the property `coding-system' is a vector of the
415 ;; [TYPE MNEMONIC DOC-STRING PLIST FLAGS]
416 ;; We call this vector as coding-spec. See comments in src/coding.c
419 (defconst coding-spec-type-idx
0)
420 (defconst coding-spec-mnemonic-idx
1)
421 (defconst coding-spec-doc-string-idx
2)
422 (defconst coding-spec-plist-idx
3)
423 (defconst coding-spec-flags-idx
4)
425 ;; PLIST is a property list of a coding system. To share PLIST among
426 ;; alias coding systems, a coding system has PLIST in coding-spec
427 ;; instead of having it in normal property list of Lisp symbol.
428 ;; Here's a list of coding system properties currently being used.
432 ;; The value is a coding category the coding system belongs to. The
433 ;; function `make-coding-system' sets this value automatically
434 ;; unless its argument PROPERTIES specifies this property.
436 ;; o alias-coding-systems
438 ;; The value is a list of coding systems of the same alias group. The
439 ;; first element is the coding system made at first, which we call as
440 ;; `base coding system'. The function `make-coding-system' sets this
441 ;; value automatically and `define-coding-system-alias' updates it.
443 ;; See the documentation of make-coding-system for the meanings of the
444 ;; following properties.
446 ;; o post-read-conversion
447 ;; o pre-write-conversion
448 ;; o translation-table-for-decode
449 ;; o translation-table-for-encode
453 ;; o valid-codes (meaningful only for a coding system based on CCL)
456 (defsubst coding-system-spec
(coding-system)
457 "Return coding-spec of CODING-SYSTEM."
458 (get (check-coding-system coding-system
) 'coding-system
))
460 (defun coding-system-type (coding-system)
461 "Return the coding type of CODING-SYSTEM.
462 A coding type is an integer value indicating the encoding method
463 of CODING-SYSTEM. See the function `make-coding-system' for more detail."
464 (aref (coding-system-spec coding-system
) coding-spec-type-idx
))
466 (defun coding-system-mnemonic (coding-system)
467 "Return the mnemonic character of CODING-SYSTEM.
468 The mnemonic character of a coding system is used in mode line
469 to indicate the coding system. If the arg is nil, return ?-."
470 (let ((spec (coding-system-spec coding-system
)))
471 (if spec
(aref spec coding-spec-mnemonic-idx
) ?-
)))
473 (defun coding-system-doc-string (coding-system)
474 "Return the documentation string for CODING-SYSTEM."
475 (aref (coding-system-spec coding-system
) coding-spec-doc-string-idx
))
477 (defun coding-system-plist (coding-system)
478 "Return the property list of CODING-SYSTEM."
479 (aref (coding-system-spec coding-system
) coding-spec-plist-idx
))
481 (defun coding-system-flags (coding-system)
482 "Return `flags' of CODING-SYSTEM.
483 A `flags' of a coding system is a vector of length 32 indicating detailed
484 information of a coding system. See the function `make-coding-system'
486 (aref (coding-system-spec coding-system
) coding-spec-flags-idx
))
488 (defun coding-system-get (coding-system prop
)
489 "Extract a value from CODING-SYSTEM's property list for property PROP."
490 (plist-get (coding-system-plist coding-system
) prop
))
492 (defun coding-system-put (coding-system prop val
)
493 "Change value in CODING-SYSTEM's property list PROP to VAL."
494 (let ((plist (coding-system-plist coding-system
)))
496 (plist-put plist prop val
)
497 (aset (coding-system-spec coding-system
) coding-spec-plist-idx
500 (defun coding-system-category (coding-system)
501 "Return the coding category of CODING-SYSTEM.
502 See also `coding-category-list'."
503 (coding-system-get coding-system
'coding-category
))
505 (defun coding-system-base (coding-system)
506 "Return the base coding system of CODING-SYSTEM.
507 A base coding system is what made by `make-coding-system'.
508 Any alias nor subsidiary coding systems are not base coding system."
509 (car (coding-system-get coding-system
'alias-coding-systems
)))
511 ;; Coding system also has a property `eol-type'.
513 ;; This property indicates how the coding system handles end-of-line
514 ;; format. The value is integer 0, 1, 2, or a vector of three coding
515 ;; systems. Each integer value 0, 1, and 2 indicates the format of
516 ;; end-of-line LF, CRLF, and CR respectively. A vector value
517 ;; indicates that the format of end-of-line should be detected
518 ;; automatically. Nth element of the vector is the subsidiary coding
519 ;; system whose `eol-type' property is N.
521 (defun coding-system-eol-type (coding-system)
522 "Return eol-type of CODING-SYSTEM.
523 An eol-type is integer 0, 1, 2, or a vector of coding systems.
525 Integer values 0, 1, and 2 indicate a format of end-of-line; LF,
526 CRLF, and CR respectively.
528 A vector value indicates that a format of end-of-line should be
529 detected automatically. Nth element of the vector is the subsidiary
530 coding system whose eol-type is N."
531 (get coding-system
'eol-type
))
533 (defun coding-system-eol-type-mnemonic (coding-system)
534 "Return the string indicating end-of-line format of CODING-SYSTEM."
535 (let* ((eol-type (coding-system-eol-type coding-system
))
536 (val (cond ((eq eol-type
0) eol-mnemonic-unix
)
537 ((eq eol-type
1) eol-mnemonic-dos
)
538 ((eq eol-type
2) eol-mnemonic-mac
)
539 (t eol-mnemonic-undecided
))))
542 (char-to-string val
))))
544 (defun coding-system-lessp (x y
)
545 (cond ((eq x
'no-conversion
) t
)
546 ((eq y
'no-conversion
) nil
)
547 ((eq x
'emacs-mule
) t
)
548 ((eq y
'emacs-mule
) nil
)
549 ((eq x
'undecided
) t
)
550 ((eq y
'undecided
) nil
)
551 (t (let ((c1 (coding-system-mnemonic x
))
552 (c2 (coding-system-mnemonic y
)))
553 (or (< (downcase c1
) (downcase c2
))
554 (and (not (> (downcase c1
) (downcase c2
)))
557 (defun coding-system-equal (coding-system-1 coding-system-2
)
558 "Return t if and only if CODING-SYSTEM-1 and CODING-SYSTEM-2 are identical.
559 Two coding systems are identical if two symbols are equal
560 or one is an alias of the other."
561 (or (eq coding-system-1 coding-system-2
)
562 (and (equal (coding-system-spec coding-system-1
)
563 (coding-system-spec coding-system-2
))
564 (let ((eol-type-1 (coding-system-eol-type coding-system-1
))
565 (eol-type-2 (coding-system-eol-type coding-system-2
)))
566 (or (eq eol-type-1 eol-type-2
)
567 (and (vectorp eol-type-1
) (vectorp eol-type-2
)))))))
569 (defun add-to-coding-system-list (coding-system)
570 "Add CODING-SYSTEM to `coding-system-list' while keeping it sorted."
571 (if (or (null coding-system-list
)
572 (coding-system-lessp coding-system
(car coding-system-list
)))
573 (setq coding-system-list
(cons coding-system coding-system-list
))
574 (let ((len (length coding-system-list
))
575 mid
(tem coding-system-list
))
577 (setq mid
(nthcdr (/ len
2) tem
))
578 (if (coding-system-lessp (car mid
) coding-system
)
580 len
(- len
(/ len
2)))
581 (setq len
(/ len
2))))
582 (setcdr tem
(cons coding-system
(cdr tem
))))))
584 (defun coding-system-list (&optional base-only
)
585 "Return a list of all existing non-subsidiary coding systems.
586 If optional arg BASE-ONLY is non-nil, only base coding systems are listed.
587 The value doesn't include subsidiary coding systems which are what
588 made from bases and aliases automatically for various end-of-line
589 formats (e.g. iso-latin-1-unix, koi8-r-dos)."
590 (let* ((codings (copy-sequence coding-system-list
))
591 (tail (cons nil codings
)))
592 ;; Remove subsidiary coding systems (eol variants) and alias
593 ;; coding systems (if necessary).
595 (let* ((coding (car (cdr tail
)))
596 (aliases (coding-system-get coding
'alias-coding-systems
)))
598 ;; CODING is an eol variant if not in ALIASES.
599 (not (memq coding aliases
))
600 ;; CODING is an alias if it is not car of ALIASES.
601 (and base-only
(not (eq coding
(car aliases
)))))
602 (setcdr tail
(cdr (cdr tail
)))
603 (setq tail
(cdr tail
)))))
606 (defun map-charset-chars (func charset
)
607 "Use FUNC to map over all characters in CHARSET for side effects.
608 FUNC is a function of two args, the start and end (inclusive) of a
609 character code range. Thus FUNC should iterate over [START, END]."
610 (let* ((dim (charset-dimension charset
))
611 (chars (charset-chars charset
))
612 (start (if (= chars
94)
617 (make-char charset start
)
618 (make-char charset
(+ start chars -
1)))
621 (make-char charset
(+ i start
) start
)
622 (make-char charset
(+ i start
) (+ start chars -
1)))))))
624 (defalias 'register-char-codings
'ignore
"")
625 (make-obsolete 'register-char-codings
626 "it exists just for backward compatibility, and does nothing."
629 (defconst char-coding-system-table nil
630 "This is an obsolete variable.
631 It exists just for backward compatibility, and the value is always nil.")
633 (defun make-subsidiary-coding-system (coding-system)
634 "Make subsidiary coding systems (eol-type variants) of CODING-SYSTEM."
635 (let ((coding-spec (coding-system-spec coding-system
))
636 (subsidiaries (vector (intern (format "%s-unix" coding-system
))
637 (intern (format "%s-dos" coding-system
))
638 (intern (format "%s-mac" coding-system
))))
641 (setq elt
(aref subsidiaries i
))
642 (put elt
'coding-system coding-spec
)
643 (put elt
'eol-type i
)
644 (put elt
'coding-system-define-form nil
)
645 (add-to-coding-system-list elt
)
646 (or (assoc (symbol-name elt
) coding-system-alist
)
647 (setq coding-system-alist
648 (cons (list (symbol-name elt
)) coding-system-alist
))))
651 (defun transform-make-coding-system-args (name type
&optional doc-string props
)
652 "For internal use only.
653 Transform XEmacs style args for `make-coding-system' to Emacs style.
654 Value is a list of transformed arguments."
655 (let ((mnemonic (string-to-char (or (plist-get props
'mnemonic
) "?")))
656 (eol-type (plist-get props
'eol-type
))
659 ((eq eol-type
'lf
) (setq eol-type
'unix
))
660 ((eq eol-type
'crlf
) (setq eol-type
'dos
))
661 ((eq eol-type
'cr
) (setq eol-type
'mac
)))
662 (if (setq tmp
(plist-get props
'post-read-conversion
))
663 (setq properties
(plist-put properties
'post-read-conversion tmp
)))
664 (if (setq tmp
(plist-get props
'pre-write-conversion
))
665 (setq properties
(plist-put properties
'pre-write-conversion tmp
)))
667 ((eq type
'shift-jis
)
668 `(,name
1 ,mnemonic
,doc-string
() ,properties
,eol-type
))
669 ((eq type
'iso2022
) ; This is not perfect.
670 (if (plist-get props
'escape-quoted
)
671 (error "escape-quoted is not supported: %S"
672 `(,name
,type
,doc-string
,props
)))
673 (let ((g0 (plist-get props
'charset-g0
))
674 (g1 (plist-get props
'charset-g1
))
675 (g2 (plist-get props
'charset-g2
))
676 (g3 (plist-get props
'charset-g3
))
679 (eq (cadr (assoc 'latin-jisx0201
680 (plist-get props
'input-charset-conversion
)))
682 (eq (cadr (assoc 'ascii
683 (plist-get props
'output-charset-conversion
)))
687 (eq (cadr (assoc 'japanese-jisx0208-1978
688 (plist-get props
'input-charset-conversion
)))
690 (eq (cadr (assoc 'japanese-jisx0208
691 (plist-get props
'output-charset-conversion
)))
692 'japanese-jisx0208-1978
))))
694 (if (plist-get props
'force-g0-on-output
)
698 (if (plist-get props
'force-g1-on-output
)
702 (if (plist-get props
'force-g2-on-output
)
706 (if (plist-get props
'force-g3-on-output
)
709 `(,name
2 ,mnemonic
,doc-string
711 ,(plist-get props
'short
)
712 ,(not (plist-get props
'no-ascii-eol
))
713 ,(not (plist-get props
'no-ascii-cntl
))
714 ,(plist-get props
'seven
)
716 ,(not (plist-get props
'lock-shift
))
719 ,(plist-get props
'no-iso6429
)
721 ,properties
,eol-type
)))
723 `(,name
3 ,mnemonic
,doc-string
() ,properties
,eol-type
))
725 `(,name
4 ,mnemonic
,doc-string
726 (,(plist-get props
'decode
) .
,(plist-get props
'encode
))
727 ,properties
,eol-type
))
729 (error "unsupported XEmacs style make-coding-style arguments: %S"
730 `(,name
,type
,doc-string
,props
))))))
732 (defun make-coding-system (coding-system type mnemonic doc-string
737 "Define a new coding system CODING-SYSTEM (symbol).
738 Remaining arguments are TYPE, MNEMONIC, DOC-STRING, FLAGS (optional),
739 and PROPERTIES (optional) which construct a coding-spec of CODING-SYSTEM
740 in the following format:
741 [TYPE MNEMONIC DOC-STRING PLIST FLAGS]
743 TYPE is an integer value indicating the type of the coding system as follows:
744 0: Emacs internal format,
745 1: Shift-JIS (or MS-Kanji) used mainly on Japanese PCs,
746 2: ISO-2022 including many variants,
747 3: Big5 used mainly on Chinese PCs,
748 4: private, CCL programs provide encoding/decoding algorithm,
749 5: Raw-text, which means that text contains random 8-bit codes.
751 MNEMONIC is a character to be displayed on mode line for the coding system.
753 DOC-STRING is a documentation string for the coding system.
755 FLAGS specifies more detailed information of the coding system as follows:
757 If TYPE is 2 (ISO-2022), FLAGS is a list of these elements:
758 CHARSET0, CHARSET1, CHARSET2, CHARSET3, SHORT-FORM,
759 ASCII-EOL, ASCII-CNTL, SEVEN, LOCKING-SHIFT, SINGLE-SHIFT,
760 USE-ROMAN, USE-OLDJIS, NO-ISO6429, INIT-BOL, DESIGNATION-BOL,
761 SAFE, ACCEPT-LATIN-EXTRA-CODE.
762 CHARSETn are character sets initially designated to Gn graphic registers.
763 If CHARSETn is nil, Gn is never used.
764 If CHARSETn is t, Gn can be used but nothing designated initially.
765 If CHARSETn is a list of character sets, those character sets are
766 designated to Gn on output, but nothing designated to Gn initially.
767 But, character set `ascii' can be designated only to G0.
768 SHORT-FORM non-nil means use short designation sequence on output.
769 ASCII-EOL non-nil means designate ASCII to g0 at end of line on output.
770 ASCII-CNTL non-nil means designate ASCII to g0 before control codes and
772 SEVEN non-nil means use 7-bit code only on output.
773 LOCKING-SHIFT non-nil means use locking-shift.
774 SINGLE-SHIFT non-nil means use single-shift.
775 USE-ROMAN non-nil means designate JIS0201-1976-Roman instead of ASCII.
776 USE-OLDJIS non-nil means designate JIS0208-1976 instead of JIS0208-1983.
777 NO-ISO6429 non-nil means not use ISO6429's direction specification.
778 INIT-BOL non-nil means any designation state is assumed to be reset
779 to initial at each beginning of line on output.
780 DESIGNATION-BOL non-nil means designation sequences should be placed
781 at beginning of line on output.
782 SAFE non-nil means convert unsafe characters to `?' on output.
783 Characters not specified in the property `safe-charsets' nor
784 `safe-chars' are unsafe.
785 ACCEPT-LATIN-EXTRA-CODE non-nil means code-detection routine accepts
786 a code specified in `latin-extra-code-table' (which see) as a valid
787 code of the coding system.
789 If TYPE is 4 (private), FLAGS should be a cons of CCL programs, for
790 decoding and encoding. CCL programs should be specified by their
793 PROPERTIES is an alist of properties vs the corresponding values. The
794 following properties are recognized:
796 o post-read-conversion
798 The value is a function to call after some text is inserted and
799 decoded by the coding system itself and before any functions in
800 `after-insert-functions' are called. The argument of this
801 function is the same as for a function in
802 `after-insert-file-functions', i.e. LENGTH of the text inserted,
803 with point at the head of the text to be decoded.
805 o pre-write-conversion
807 The value is a function to call after all functions in
808 `write-region-annotate-functions' and `buffer-file-format' are
809 called, and before the text is encoded by the coding system itself.
810 The arguments to this function are the same as those of a function
811 in `write-region-annotate-functions', i.e. FROM and TO, specifying
814 o translation-table-for-decode
816 The value is a translation table to be applied on decoding. See
817 the function `make-translation-table' for the format of translation
818 table. This is not applicable to type 4 (CCL-based) coding systems.
820 o translation-table-for-encode
822 The value is a translation table to be applied on encoding. This is
823 not applicable to type 4 (CCL-based) coding systems.
827 The value is a char table. If a character has non-nil value in it,
828 the character is safely supported by the coding system. This
829 overrides the specification of safe-charsets.
833 The value is a list of charsets safely supported by the coding
834 system. The value t means that all charsets Emacs handles are
835 supported. Even if some charset is not in this list, it doesn't
836 mean that the charset can't be encoded in the coding system;
837 it just means that some other receiver of text encoded
838 in the coding system won't be able to handle that charset.
842 The value is a symbol whose name is the `MIME-charset' parameter of
845 o mime-text-unsuitable
847 A non-nil value means the `mime-charset' property names a charset
848 which is unsuitable for the top-level media type \"text\".
850 o valid-codes (meaningful only for a coding system based on CCL)
852 The value is a list to indicate valid byte ranges of the encoded
853 file. Each element of the list is an integer or a cons of integer.
854 In the former case, the integer value is a valid byte code. In the
855 latter case, the integers specify the range of valid byte codes.
857 o composition (meaningful only when TYPE is 0 or 2)
859 If the value is non-nil, the coding system preserves composition
864 If the value is non-nil, the coding system is not compatible
865 with ASCII, which means it encodes or decodes ASCII character
866 string to the different byte sequence.
868 These properties are set in PLIST, a property list. This function
869 also sets properties `coding-category' and `alias-coding-systems'
872 EOL-TYPE specifies the EOL type of the coding-system in one of the
875 o symbol (unix, dos, or mac)
877 The symbol `unix' means Unix-like EOL (LF), `dos' means
878 DOS-like EOL (CRLF), and `mac' means MAC-like EOL (CR).
880 o number (0, 1, or 2)
882 The number 0, 1, and 2 mean UNIX, DOS, and MAC-like EOL
885 o vector of coding-systems of length 3
887 The EOL type is detected automatically for the coding system.
888 And, according to the detected EOL type, one of the coding
889 systems in the vector is selected. Elements of the vector
890 corresponds to Unix-like EOL, DOS-like EOL, and Mac-like EOL
893 Kludgy features for backward compatibility:
895 1. If TYPE is 4 and car or cdr of FLAGS is a vector, the vector is
896 treated as a compiled CCL code.
898 2. If PROPERTIES is just a list of character sets, the list is set as
899 a value of `safe-charsets' in PLIST."
901 ;; For compatiblity with XEmacs, we check the type of TYPE. If it
902 ;; is a symbol, perhaps, this function is called with XEmacs-style
903 ;; arguments. Here, try to transform that kind of arguments to
906 (let ((args (transform-make-coding-system-args coding-system type
907 mnemonic doc-string
)))
908 (setq coding-system
(car args
)
910 mnemonic
(nth 2 args
)
911 doc-string
(nth 3 args
)
913 properties
(nth 5 args
)
914 eol-type
(nth 6 args
))))
916 ;; Set a value of `coding-system' property.
917 (let ((coding-spec (make-vector 5 nil
))
918 (no-initial-designation t
)
919 (no-alternative-designation t
)
920 (accept-latin-extra-code nil
)
922 (if (or (not (integerp type
)) (< type
0) (> type
5))
923 (error "TYPE argument must be 0..5"))
924 (if (or (not (integerp mnemonic
)) (<= mnemonic ?
) (> mnemonic
127))
925 (error "MNEMONIC argument must be an ASCII printable character"))
926 (aset coding-spec coding-spec-type-idx type
)
927 (aset coding-spec coding-spec-mnemonic-idx mnemonic
)
928 (aset coding-spec coding-spec-doc-string-idx
929 (purecopy (if (stringp doc-string
) doc-string
"")))
931 (setq coding-category
'coding-category-emacs-mule
))
933 (setq coding-category
'coding-category-sjis
))
934 ((= type
2) ; ISO2022
936 (vec (make-vector 32 nil
))
940 (let ((charset (car fl
)))
941 (if (and no-initial-designation
943 (or (charsetp charset
)
945 (charsetp (car charset
)))))
946 (setq no-initial-designation nil
))
947 (if (charsetp charset
)
948 (if (= i
1) (setq g1-designation charset
))
953 (setq elt
(car tail
))
955 (setq no-alternative-designation nil
)
956 (if (and elt
(not (charsetp elt
)))
957 (error "Invalid charset: %s" elt
)))
958 (setq tail
(cdr tail
)))
959 (setq g1-designation
(car charset
)))
962 (setq no-alternative-designation nil
)
963 (error "Invalid charset: %s" charset
)))))
964 (aset vec i charset
))
965 (setq fl
(cdr fl
) i
(1+ i
)))
966 (while (and (< i
32) fl
)
967 (aset vec i
(car fl
))
968 (if (and (= i
16) ; ACCEPT-LATIN-EXTRA-CODE
970 (setq accept-latin-extra-code t
))
971 (setq fl
(cdr fl
) i
(1+ i
)))
972 (aset coding-spec
4 vec
)
973 (setq coding-category
974 (if (aref vec
8) ; Use locking-shift.
975 (or (and (aref vec
7) 'coding-category-iso-7-else
)
976 'coding-category-iso-8-else
)
977 (if (aref vec
7) ; 7-bit only.
978 (if (aref vec
9) ; Use single-shift.
979 'coding-category-iso-7-else
980 (if no-alternative-designation
981 'coding-category-iso-7-tight
982 'coding-category-iso-7
))
983 (if (or no-initial-designation
984 (not no-alternative-designation
))
985 'coding-category-iso-8-else
986 (if (and (charsetp g1-designation
)
987 (= (charset-dimension g1-designation
) 2))
988 'coding-category-iso-8-2
989 'coding-category-iso-8-1
)))))))
991 (setq coding-category
'coding-category-big5
))
992 ((= type
4) ; private
993 (setq coding-category
'coding-category-ccl
)
994 (if (not (consp flags
))
995 (error "Invalid FLAGS argument for TYPE 4 (CCL)")
996 (let ((decoder (check-ccl-program
998 (intern (format "%s-decoder" coding-system
))))
999 (encoder (check-ccl-program
1001 (intern (format "%s-encoder" coding-system
)))))
1002 (if (and decoder encoder
)
1003 (aset coding-spec
4 (cons decoder encoder
))
1004 (error "Invalid FLAGS argument for TYPE 4 (CCL)")))))
1005 (t ; i.e. (= type 5)
1006 (setq coding-category
'coding-category-raw-text
)))
1008 (let ((plist (list 'coding-category coding-category
1009 'alias-coding-systems
(list coding-system
))))
1010 (if no-initial-designation
1011 (plist-put plist
'no-initial-designation t
))
1013 (or (eq properties t
)
1014 (not (consp (car properties
)))))
1015 ;; In the old version, the arg PROPERTIES is a list to be
1016 ;; set in PLIST as a value of property `safe-charsets'.
1017 (setq properties
(list (cons 'safe-charsets properties
))))
1018 ;; In the current version PROPERTIES is a property list.
1019 ;; Reflect it into PLIST one by one while handling safe-chars
1021 (let ((safe-charsets (cdr (assq 'safe-charsets properties
)))
1022 (safe-chars (cdr (assq 'safe-chars properties
)))
1025 ;; If only safe-charsets is specified, make a char-table from
1026 ;; it, and store that char-table as the value of `safe-chars'.
1027 (if (and (not safe-chars
) safe-charsets
)
1029 (if (eq safe-charsets t
)
1031 (setq safe-chars
(make-char-table 'safe-chars
))
1032 (while safe-charsets
1033 (setq charset
(car safe-charsets
)
1034 safe-charsets
(cdr safe-charsets
))
1035 (cond ((eq charset
'ascii
)) ; just ignore
1036 ((eq charset
'eight-bit-control
)
1039 (aset safe-chars i t
)
1041 ((eq charset
'eight-bit-graphic
)
1044 (aset safe-chars i t
)
1047 (aset safe-chars
(make-char charset
) t
))))
1048 (if accept-latin-extra-code
1051 (if (aref latin-extra-code-table i
)
1052 (aset safe-chars i t
))
1054 (setq l
(cons (cons 'safe-chars safe-chars
) l
))))
1056 (setq prop
(car (car l
)) val
(cdr (car l
)) l
(cdr l
))
1057 (if (eq prop
'safe-chars
)
1059 (if (and (symbolp val
)
1060 (get val
'translation-table
))
1061 (setq safe-chars
(get val
'translation-table
)))
1062 (setq val safe-chars
)))
1063 (plist-put plist prop val
)))
1064 ;; The property `coding-category' may have been set differently
1065 ;; through PROPERTIES.
1066 (setq coding-category
(plist-get plist
'coding-category
))
1067 (aset coding-spec coding-spec-plist-idx plist
))
1068 (put coding-system
'coding-system coding-spec
)
1069 (put coding-system
'coding-system-define-form nil
)
1070 (put coding-category
'coding-systems
1071 (cons coding-system
(get coding-category
'coding-systems
))))
1073 ;; Next, set a value of `eol-type' property.
1075 ;; If EOL-TYPE is nil, set a vector of subsidiary coding
1076 ;; systems, each corresponds to a coding system for the detected
1078 (setq eol-type
(make-subsidiary-coding-system coding-system
)))
1080 (cond ((or (eq eol-type
'unix
) (null eol-type
))
1086 ((or (and (vectorp eol-type
)
1087 (= (length eol-type
) 3))
1088 (and (numberp eol-type
)
1089 (and (>= eol-type
0)
1093 (error "Invalid EOL-TYPE spec:%S" eol-type
))))
1094 (put coding-system
'eol-type eol-type
)
1096 (define-coding-system-internal coding-system
)
1098 ;; At last, register CODING-SYSTEM in `coding-system-list' and
1099 ;; `coding-system-alist'.
1100 (add-to-coding-system-list coding-system
)
1101 (or (assoc (symbol-name coding-system
) coding-system-alist
)
1102 (setq coding-system-alist
(cons (list (symbol-name coding-system
))
1103 coding-system-alist
)))
1105 ;; For a coding system of cateogory iso-8-1 and iso-8-2, create
1106 ;; XXX-with-esc variants.
1107 (let ((coding-category (coding-system-category coding-system
)))
1108 (if (or (eq coding-category
'coding-category-iso-8-1
)
1109 (eq coding-category
'coding-category-iso-8-2
))
1110 (let ((esc (intern (concat (symbol-name coding-system
) "-with-esc")))
1111 (doc (format "Same as %s but can handle any charsets by ISO's escape sequences." coding-system
))
1112 (safe-charsets (assq 'safe-charsets properties
))
1113 (mime-charset (assq 'mime-charset properties
)))
1115 (setcdr safe-charsets t
)
1116 (setq properties
(cons (cons 'safe-charsets t
) properties
)))
1118 (setcdr mime-charset nil
))
1119 (make-coding-system esc type mnemonic doc
1120 (if (listp (car flags
))
1121 (cons (append (car flags
) '(t)) (cdr flags
))
1122 (cons (list (car flags
) t
) (cdr flags
)))
1127 (put 'safe-chars
'char-table-extra-slots
0)
1129 (defun define-coding-system-alias (alias coding-system
)
1130 "Define ALIAS as an alias for coding system CODING-SYSTEM."
1131 (put alias
'coding-system
(coding-system-spec coding-system
))
1132 (put alias
'coding-system-define-form nil
)
1133 (add-to-coding-system-list alias
)
1134 (or (assoc (symbol-name alias
) coding-system-alist
)
1135 (setq coding-system-alist
(cons (list (symbol-name alias
))
1136 coding-system-alist
)))
1137 (let ((eol-type (coding-system-eol-type coding-system
)))
1138 (if (vectorp eol-type
)
1140 (nconc (coding-system-get alias
'alias-coding-systems
) (list alias
))
1141 (put alias
'eol-type
(make-subsidiary-coding-system alias
)))
1142 (put alias
'eol-type eol-type
))))
1144 (defun merge-coding-systems (first second
)
1145 "Fill in any unspecified aspects of coding system FIRST from SECOND.
1146 Return the resulting coding system."
1147 (let ((base (coding-system-base second
))
1148 (eol (coding-system-eol-type second
)))
1149 ;; If FIRST doesn't specify text conversion, merge with that of SECOND.
1150 (if (eq (coding-system-base first
) 'undecided
)
1151 (setq first
(coding-system-change-text-conversion first base
)))
1152 ;; If FIRST doesn't specify eol conversion, merge with that of SECOND.
1153 (if (and (vectorp (coding-system-eol-type first
))
1154 (numberp eol
) (>= eol
0) (<= eol
2))
1155 (setq first
(coding-system-change-eol-conversion
1159 (defun autoload-coding-system (symbol form
)
1160 "Define SYMBOL as a coding-system that is defined on demand.
1162 FROM is a form to evaluate to define the coding-system."
1163 (put symbol
'coding-system-define-form form
)
1164 (setq coding-system-alist
(cons (list (symbol-name symbol
))
1165 coding-system-alist
))
1166 (dolist (elt '("-unix" "-dos" "-mac"))
1167 (let ((name (concat (symbol-name symbol
) elt
)))
1168 (put (intern name
) 'coding-system-define-form form
)
1169 (setq coding-system-alist
(cons (list name
) coding-system-alist
)))))
1171 (defun set-buffer-file-coding-system (coding-system &optional force nomodify
)
1172 "Set the file coding-system of the current buffer to CODING-SYSTEM.
1173 This means that when you save the buffer, it will be converted
1174 according to CODING-SYSTEM. For a list of possible values of CODING-SYSTEM,
1175 use \\[list-coding-systems].
1177 If CODING-SYSTEM leaves the text conversion unspecified, or if it
1178 leaves the end-of-line conversion unspecified, FORCE controls what to
1179 do. If FORCE is nil, get the unspecified aspect (or aspects) from the
1180 buffer's previous `buffer-file-coding-system' value (if it is
1181 specified there). Otherwise, leave it unspecified.
1183 This marks the buffer modified so that the succeeding \\[save-buffer]
1184 surely saves the buffer with CODING-SYSTEM. From a program, if you
1185 don't want to mark the buffer modified, specify t for NOMODIFY.
1186 If you know exactly what coding system you want to use,
1187 just set the variable `buffer-file-coding-system' directly."
1188 (interactive "zCoding system for saving file (default nil): \nP")
1189 (check-coding-system coding-system
)
1190 (if (and coding-system buffer-file-coding-system
(null force
))
1192 (merge-coding-systems coding-system buffer-file-coding-system
)))
1193 (setq buffer-file-coding-system coding-system
)
1194 ;; This is in case of an explicit call. Normally, `normal-mode' and
1195 ;; `set-buffer-major-mode-hook' take care of setting the table.
1196 (if (fboundp 'ucs-set-table-for-input
) ; don't lose when building
1197 (ucs-set-table-for-input))
1199 (set-buffer-modified-p t
))
1200 (force-mode-line-update))
1202 (defun revert-buffer-with-coding-system (coding-system &optional force
)
1203 "Visit the current buffer's file again using coding system CODING-SYSTEM.
1204 For a list of possible values of CODING-SYSTEM, use \\[list-coding-systems].
1206 If CODING-SYSTEM leaves the text conversion unspecified, or if it
1207 leaves the end-of-line conversion unspecified, FORCE controls what to
1208 do. If FORCE is nil, get the unspecified aspect (or aspects) from the
1209 buffer's previous `buffer-file-coding-system' value (if it is
1210 specified there). Otherwise, determine it from the file contents as
1211 usual for visiting a file."
1212 (interactive "zCoding system for visited file (default nil): \nP")
1213 (check-coding-system coding-system
)
1214 (if (and coding-system buffer-file-coding-system
(null force
))
1216 (merge-coding-systems coding-system buffer-file-coding-system
)))
1217 (let ((coding-system-for-read coding-system
))
1220 (defun set-file-name-coding-system (coding-system)
1221 "Set coding system for decoding and encoding file names to CODING-SYSTEM.
1222 It actually just set the variable `file-name-coding-system' (which
1223 see) to CODING-SYSTEM."
1224 (interactive "zCoding system for file names (default nil): ")
1225 (check-coding-system coding-system
)
1226 (if (and coding-system
1227 (coding-system-get coding-system
'ascii-incompatible
))
1228 (error "%s is not ASCII-compatible" coding-system
))
1229 (setq file-name-coding-system coding-system
))
1231 (defvar default-terminal-coding-system nil
1232 "Default value for the terminal coding system.
1233 This is normally set according to the selected language environment.
1234 See also the command `set-terminal-coding-system'.")
1236 (defun set-terminal-coding-system (coding-system)
1237 "Set coding system of your terminal to CODING-SYSTEM.
1238 All text output to the terminal will be encoded
1239 with the specified coding system.
1240 For a list of possible values of CODING-SYSTEM, use \\[list-coding-systems].
1241 The default is determined by the selected language environment
1242 or by the previous use of this command."
1244 (list (let ((default (if (and (not (terminal-coding-system))
1245 default-terminal-coding-system
)
1246 default-terminal-coding-system
)))
1248 (format "Coding system for terminal display (default %s): "
1251 (if (and (not coding-system
)
1252 (not (terminal-coding-system)))
1253 (setq coding-system default-terminal-coding-system
))
1255 (setq default-terminal-coding-system coding-system
))
1256 (set-terminal-coding-system-internal coding-system
)
1257 (redraw-frame (selected-frame)))
1259 (defvar default-keyboard-coding-system nil
1260 "Default value of the keyboard coding system.
1261 This is normally set according to the selected language environment.
1262 See also the command `set-keyboard-coding-system'.")
1264 (defun set-keyboard-coding-system (coding-system)
1265 "Set coding system for keyboard input to CODING-SYSTEM.
1266 In addition, this command enables Encoded-kbd minor mode.
1267 \(If CODING-SYSTEM is nil, Encoded-kbd mode is turned off -- see
1268 `encoded-kbd-mode'.)
1269 For a list of possible values of CODING-SYSTEM, use \\[list-coding-systems].
1270 The default is determined by the selected language environment
1271 or by the previous use of this command."
1273 (list (let ((default (if (and (not (keyboard-coding-system))
1274 default-keyboard-coding-system
)
1275 default-keyboard-coding-system
)))
1277 (format "Coding system for keyboard input (default %s): "
1280 (if (and (not coding-system
)
1281 (not (keyboard-coding-system)))
1282 (setq coding-system default-keyboard-coding-system
))
1284 (setq default-keyboard-coding-system coding-system
))
1285 (if (and coding-system
1286 (coding-system-get coding-system
'ascii-incompatible
))
1287 (error "%s is not ASCII-compatible" coding-system
))
1288 (set-keyboard-coding-system-internal coding-system
)
1289 (setq keyboard-coding-system coding-system
)
1290 (encoded-kbd-mode (if coding-system
1 0)))
1292 (defcustom keyboard-coding-system nil
1293 "Specify coding system for keyboard input.
1294 If you set this on a terminal which can't distinguish Meta keys from
1295 8-bit characters, you will have to use ESC to type Meta characters.
1296 See Info node `Terminal Coding' and Info node `Unibyte Mode'.
1298 On non-windowing terminals, this is set from the locale by default.
1300 Setting this variable directly does not take effect;
1301 use either \\[customize] or \\[set-keyboard-coding-system]."
1302 :type
'(coding-system :tag
"Coding system")
1303 :link
'(info-link "(emacs)Terminal Coding")
1304 :link
'(info-link "(emacs)Unibyte Mode")
1305 :set
(lambda (symbol value
)
1306 ;; Don't load encoded-kbd-mode unnecessarily.
1307 (if (or value
(boundp 'encoded-kbd-mode
))
1308 (set-keyboard-coding-system value
)
1309 (set-default 'keyboard-coding-system nil
))) ; must initialize
1314 (defun set-buffer-process-coding-system (decoding encoding
)
1315 "Set coding systems for the process associated with the current buffer.
1316 DECODING is the coding system to be used to decode input from the process,
1317 ENCODING is the coding system to be used to encode output to the process.
1319 For a list of possible values of CODING-SYSTEM, use \\[list-coding-systems]."
1321 "zCoding-system for output from the process: \nzCoding-system for input to the process: ")
1322 (let ((proc (get-buffer-process (current-buffer))))
1324 (error "No process")
1325 (check-coding-system decoding
)
1326 (check-coding-system encoding
)
1327 (set-process-coding-system proc decoding encoding
)))
1328 (force-mode-line-update))
1330 (defalias 'set-clipboard-coding-system
'set-selection-coding-system
)
1332 (defun set-selection-coding-system (coding-system)
1333 "Make CODING-SYSTEM used for communicating with other X clients.
1334 When sending or receiving text via cut_buffer, selection, and clipboard,
1335 the text is encoded or decoded by CODING-SYSTEM."
1336 (interactive "zCoding system for X selection: ")
1337 (check-coding-system coding-system
)
1338 (setq selection-coding-system coding-system
))
1340 ;; Coding system lastly specified by the command
1341 ;; set-next-selection-coding-system.
1342 (defvar last-next-selection-coding-system nil
)
1344 (defun set-next-selection-coding-system (coding-system)
1345 "Make CODING-SYSTEM used for the next communication with other X clients.
1346 This setting is effective for the next communication only."
1348 (list (read-coding-system
1349 (if last-next-selection-coding-system
1350 (format "Coding system for the next X selection (default %S): "
1351 last-next-selection-coding-system
)
1352 "Coding system for the next X selection: ")
1353 last-next-selection-coding-system
)))
1355 (setq last-next-selection-coding-system coding-system
)
1356 (setq coding-system last-next-selection-coding-system
))
1357 (check-coding-system coding-system
)
1359 (setq next-selection-coding-system coding-system
))
1361 (defun set-coding-priority (arg)
1362 "Set priority of coding categories according to ARG.
1363 ARG is a list of coding categories ordered by priority."
1365 (current-list (copy-sequence coding-category-list
)))
1366 ;; Check the validity of ARG while deleting coding categories in
1367 ;; ARG from CURRENT-LIST. We assume that CODING-CATEGORY-LIST
1368 ;; contains all coding categories.
1370 (if (or (null (get (car l
) 'coding-category-index
))
1371 (null (memq (car l
) current-list
)))
1372 (error "Invalid or duplicated element in argument: %s" arg
))
1373 (setq current-list
(delq (car l
) current-list
))
1375 ;; Update `coding-category-list' and return it.
1376 (setq coding-category-list
(append arg current-list
))
1377 (set-coding-priority-internal)))
1381 (defvar ctext-non-standard-encodings-alist
1382 '(("big5-0" big5
2 (chinese-big5-1 chinese-big5-2
))
1383 ("ISO8859-14" iso-8859-14
1 latin-iso8859-14
)
1384 ("ISO8859-15" iso-8859-15
1 latin-iso8859-15
))
1385 "Alist of non-standard encoding names vs the corresponding usages in CTEXT.
1387 It controls how extended segments of a compound text are handled
1388 by the coding system `compound-text-with-extensions'.
1390 Each element has the form (ENCODING-NAME CODING-SYSTEM N-OCTET CHARSET).
1392 ENCODING-NAME is an encoding name of an \"extended segments\".
1394 CODING-SYSTEM is the coding-system to encode (or decode) the
1395 characters into (or from) the extended segment.
1397 N-OCTET is the number of octets (bytes) that encodes a character
1398 in the segment. It can be 0 (meaning the number of octets per
1399 character is variable), 1, 2, 3, or 4.
1401 CHARSET is a charater set containing characters that are encoded
1402 in the segment. It can be a list of character sets. It can also
1403 be a char-table, in which case characters that have non-nil value
1404 in the char-table are the target.
1406 On decoding CTEXT, all encoding names listed here are recognized.
1408 On encoding CTEXT, encoding names in the variable
1409 `ctext-non-standard-encodings' (which see) and in the information
1410 listed for the current language environment under the key
1411 `ctext-non-standard-encodings' are used.")
1413 (defvar ctext-non-standard-encodings
1415 "List of non-standard encoding names used in extended segments of CTEXT.
1416 Each element must be one of the names listed in the variable
1417 `ctext-non-standard-encodings-alist' (which see).")
1419 (defvar ctext-non-standard-encodings-regexp
1420 (string-to-multibyte
1422 ;; For non-standard encodings.
1423 "\\(\e%/[0-4][\200-\377][\200-\377]\\([^\002]+\\)\002\\)"
1425 ;; For UTF-8 encoding.
1426 "\\(\e%G[^\e]*\e%@\\)")))
1428 ;; Functions to support "Non-Standard Character Set Encodings" defined
1429 ;; by the COMPOUND-TEXT spec. They also support "The UTF-8 encoding"
1430 ;; described in the section 7 of the documentation of COMPOUND-TEXT
1431 ;; distributed with XFree86.
1433 (defun ctext-post-read-conversion (len)
1434 "Decode LEN characters encoded as Compound Text with Extended Segments."
1437 (let ((case-fold-search nil
)
1438 (in-workbuf (string= (buffer-name) " *code-converting-work*"))
1439 last-coding-system-used
1442 (narrow-to-region (point) (+ (point) len
)))
1444 (set-buffer-multibyte t
))
1445 (while (re-search-forward ctext-non-standard-encodings-regexp
1447 (setq pos
(match-beginning 0))
1448 (if (match-beginning 1)
1449 ;; ESC % / [0-4] M L --ENCODING-NAME-- \002 --BYTES--
1450 (let* ((M (char-after (+ pos
4)))
1451 (L (char-after (+ pos
5)))
1452 (encoding (match-string 2))
1453 (encoding-info (assoc-string
1455 ctext-non-standard-encodings-alist t
))
1456 (coding (if encoding-info
1457 (nth 1 encoding-info
)
1458 (setq encoding
(intern (downcase encoding
)))
1459 (and (coding-system-p encoding
)
1461 (setq bytes
(- (+ (* (- M
128) 128) (- L
128))
1462 (- (point) (+ pos
6))))
1464 (delete-region pos
(point))
1465 (forward-char bytes
)
1466 (decode-coding-region (- (point) bytes
) (point) coding
)))
1467 ;; ESC % G --UTF-8-BYTES-- ESC % @
1469 (delete-region pos
(+ pos
3))
1470 (decode-coding-region pos
(point) 'utf-8
))))
1471 (goto-char (point-min))
1472 (- (point-max) (point)))))
1474 ;; Return a char table of extended segment usage for each character.
1475 ;; Each value of the char table is nil, one of the elements of
1476 ;; `ctext-non-standard-encodings-alist', or the symbol `utf-8'.
1478 (defun ctext-non-standard-encodings-table ()
1479 (let ((table (make-char-table 'translation-table
)))
1480 (aset table
(make-char 'mule-unicode-0100-24ff
) 'utf-8
)
1481 (aset table
(make-char 'mule-unicode-2500-33ff
) 'utf-8
)
1482 (aset table
(make-char 'mule-unicode-e000-ffff
) 'utf-8
)
1483 (dolist (encoding (reverse
1485 (get-language-info current-language-environment
1486 'ctext-non-standard-encodings
)
1487 ctext-non-standard-encodings
)))
1488 (let* ((slot (assoc encoding ctext-non-standard-encodings-alist
))
1489 (charset (nth 3 slot
)))
1491 (cond ((charsetp charset
)
1492 (aset table
(make-char charset
) slot
))
1494 (dolist (elt charset
)
1495 (aset table
(make-char elt
) slot
)))
1496 ((char-table-p charset
)
1497 (map-char-table #'(lambda (k v
)
1498 (if (and v
(> k
128)) (aset table k slot
)))
1502 (defun ctext-pre-write-conversion (from to
)
1503 "Encode characters between FROM and TO as Compound Text w/Extended Segments.
1505 If FROM is a string, or if the current buffer is not the one set up for us
1506 by encode-coding-string, generate a new temp buffer, insert the
1507 text, and convert it in the temporary buffer. Otherwise, convert in-place."
1509 (let ((workbuf (get-buffer-create " *code-conversion-work*")))
1510 ;; Setup a working buffer if necessary.
1511 (cond ((stringp from
)
1512 (set-buffer workbuf
)
1514 (set-buffer-multibyte (multibyte-string-p from
))
1516 ((not (eq (current-buffer) workbuf
))
1517 (let ((buf (current-buffer))
1518 (multibyte enable-multibyte-characters
))
1519 (set-buffer workbuf
)
1521 (set-buffer-multibyte multibyte
)
1522 (insert-buffer-substring buf from to
)))))
1524 ;; Now we can encode the whole buffer.
1525 (let ((encoding-table (ctext-non-standard-encodings-table))
1526 last-coding-system-used
1527 last-pos last-encoding-info
1528 encoding-info end-pos
)
1529 (goto-char (setq last-pos
(point-min)))
1530 (setq end-pos
(point-marker))
1531 (while (re-search-forward "[^\000-\177]+" nil t
)
1532 ;; Found a sequence of non-ASCII characters.
1533 (setq last-pos
(match-beginning 0)
1534 last-encoding-info
(aref encoding-table
(char-after last-pos
)))
1535 (set-marker end-pos
(match-end 0))
1536 (goto-char (1+ last-pos
))
1540 (if (< (point) end-pos
)
1541 (aref encoding-table
(following-char))))
1542 (unless (eq last-encoding-info encoding-info
)
1543 (cond ((consp last-encoding-info
)
1544 ;; Encode the previous range using an extended
1546 (let ((encoding-name (car last-encoding-info
))
1547 (coding-system (nth 1 last-encoding-info
))
1548 (noctets (nth 2 last-encoding-info
))
1550 (encode-coding-region last-pos
(point) coding-system
)
1551 (setq len
(+ (length encoding-name
) 1
1552 (- (point) last-pos
)))
1554 (goto-char last-pos
)
1555 (insert (string-to-multibyte
1556 (format "\e%%/%d%c%c%s\x02"
1561 ((eq last-encoding-info
'utf-8
)
1562 ;; Encode the previous range using UTF-8 encoding
1564 (encode-coding-region last-pos
(point) 'mule-utf-8
)
1566 (goto-char last-pos
)
1569 (setq last-pos
(point)
1570 last-encoding-info encoding-info
))
1571 (if (< (point) end-pos
)
1573 (throw 'tag nil
)))))
1574 (set-marker end-pos nil
)
1575 (goto-char (point-min))))
1576 ;; Must return nil, as build_annotations_2 expects that.
1581 (defcustom auto-coding-alist
1582 '(("\\.\\(arc\\|zip\\|lzh\\|lha\\|zoo\\|[jew]ar\\|xpi\\)\\'" . no-conversion
)
1583 ("\\.\\(ARC\\|ZIP\\|LZH\\|LHA\\|ZOO\\|[JEW]AR\\|XPI\\)\\'" . no-conversion
)
1584 ("\\.\\(sx[dmicw]\\|odt\\|tar\\|tgz\\)\\'" . no-conversion
)
1585 ("\\.\\(gz\\|Z\\|bz\\|bz2\\|gpg\\)\\'" . no-conversion
)
1586 ("\\.\\(jpe?g\\|png\\|gif\\|tiff?\\|p[bpgn]m\\)\\'" . no-conversion
)
1587 ("/#[^/]+#\\'" . emacs-mule
))
1588 "Alist of filename patterns vs corresponding coding systems.
1589 Each element looks like (REGEXP . CODING-SYSTEM).
1590 A file whose name matches REGEXP is decoded by CODING-SYSTEM on reading.
1592 The settings in this alist take priority over `coding:' tags
1593 in the file (see the function `set-auto-coding')
1594 and the contents of `file-coding-system-alist'."
1597 :type
'(repeat (cons (regexp :tag
"File name regexp")
1598 (symbol :tag
"Coding system"))))
1600 (defcustom auto-coding-regexp-alist
1601 '(("^BABYL OPTIONS:[ \t]*-\\*-[ \t]*rmail[ \t]*-\\*-" . no-conversion
)
1602 ("\\`\xFE\xFF" . utf-16be-with-signature
)
1603 ("\\`\xFF\xFE" . utf-16le-with-signature
)
1604 ("\\`\xEF\xBB\xBF" . utf-8
))
1605 "Alist of patterns vs corresponding coding systems.
1606 Each element looks like (REGEXP . CODING-SYSTEM).
1607 A file whose first bytes match REGEXP is decoded by CODING-SYSTEM on reading.
1609 The settings in this alist take priority over `coding:' tags
1610 in the file (see the function `set-auto-coding')
1611 and the contents of `file-coding-system-alist'."
1614 :type
'(repeat (cons (regexp :tag
"Regexp")
1615 (symbol :tag
"Coding system"))))
1617 (defun auto-coding-regexp-alist-lookup (from to
)
1618 "Lookup `auto-coding-regexp-alist' for the contents of the current buffer.
1619 The value is a coding system is specified for the region FROM and TO,
1623 (let ((alist auto-coding-regexp-alist
)
1625 (while (and alist
(not coding-system
))
1626 (let ((regexp (car (car alist
))))
1627 (if enable-multibyte-characters
1628 (setq regexp
(string-to-multibyte regexp
)))
1629 (if (re-search-forward regexp to t
)
1630 (setq coding-system
(cdr (car alist
)))
1631 (setq alist
(cdr alist
)))))
1634 ;; See the bottom of this file for built-in auto coding functions.
1635 (defcustom auto-coding-functions
'(sgml-xml-auto-coding-function
1636 sgml-html-meta-auto-coding-function
)
1637 "A list of functions which attempt to determine a coding system.
1639 Each function in this list should be written to operate on the
1640 current buffer, but should not modify it in any way. The buffer
1641 will contain undecoded text of parts of the file. Each function
1642 should take one argument, SIZE, which says how many
1643 characters (starting from point) it should look at.
1645 If one of these functions succeeds in determining a coding
1646 system, it should return that coding system. Otherwise, it
1649 If a file has a `coding:' tag, that takes precedence over these
1650 functions, so they won't be called at all."
1653 :type
'(repeat function
))
1655 (defvar set-auto-coding-for-load nil
1656 "Non-nil means look for `load-coding' property instead of `coding'.
1657 This is used for loading and byte-compiling Emacs Lisp files.")
1659 (defun auto-coding-alist-lookup (filename)
1660 "Return the coding system specified by `auto-coding-alist' for FILENAME."
1661 (let ((alist auto-coding-alist
)
1662 (case-fold-search (memq system-type
'(vax-vms windows-nt ms-dos cygwin
)))
1664 (while (and alist
(not coding-system
))
1665 (if (string-match (car (car alist
)) filename
)
1666 (setq coding-system
(cdr (car alist
)))
1667 (setq alist
(cdr alist
))))
1670 (put 'enable-character-translation
'permanent-local t
)
1671 (put 'enable-character-translation
'safe-local-variable
'booleanp
)
1673 (defun find-auto-coding (filename size
)
1674 "Find a coding system for a file FILENAME of which SIZE bytes follow point.
1675 These bytes should include at least the first 1k of the file
1676 and the last 3k of the file, but the middle may be omitted.
1678 The function checks FILENAME against the variable `auto-coding-alist'.
1679 If FILENAME doesn't match any entries in the variable, it checks the
1680 contents of the current buffer following point against
1681 `auto-coding-regexp-alist'. If no match is found, it checks for a
1682 `coding:' tag in the first one or two lines following point. If no
1683 `coding:' tag is found, it checks any local variables list in the last
1684 3K bytes out of the SIZE bytes. Finally, if none of these methods
1685 succeed, it checks to see if any function in `auto-coding-functions'
1688 If a coding system is specifed, the return value is a
1689 cons (CODING . SOURCE), where CODING is the specified coding
1690 system and SOURCE is a symbol `auto-coding-alist',
1691 `auto-coding-regexp-alist', `coding:', or `auto-coding-functions'
1692 indicating by what CODING is specified. Note that the validity
1693 of CODING is not checked; it's the caller's responsibility to check it.
1695 If nothing is specified, the return value is nil."
1696 (or (let ((coding-system (auto-coding-alist-lookup filename
)))
1698 (cons coding-system
'auto-coding-alist
)))
1699 ;; Try using `auto-coding-regexp-alist'.
1700 (let ((coding-system (auto-coding-regexp-alist-lookup (point)
1703 (cons coding-system
'auto-coding-regexp-alist
)))
1704 (let* ((case-fold-search t
)
1705 (head-start (point))
1706 (head-end (+ head-start
(min size
1024)))
1707 (tail-start (+ head-start
(max (- size
3072) 0)))
1708 (tail-end (+ head-start size
))
1709 coding-system head-found tail-found pos char-trans
)
1710 ;; Try a short cut by searching for the string "coding:"
1711 ;; and for "unibyte:" at the head and tail of SIZE bytes.
1712 (setq head-found
(or (search-forward "coding:" head-end t
)
1713 (search-forward "unibyte:" head-end t
)
1714 (search-forward "enable-character-translation:"
1716 (if (and head-found
(> head-found tail-start
))
1717 ;; Head and tail are overlapped.
1718 (setq tail-found head-found
)
1719 (goto-char tail-start
)
1720 (setq tail-found
(or (search-forward "coding:" tail-end t
)
1721 (search-forward "unibyte:" tail-end t
)
1722 (search-forward "enable-character-translation:"
1725 ;; At first check the head.
1727 (goto-char head-start
)
1728 (setq head-end
(set-auto-mode-1))
1729 (setq head-start
(point))
1730 (when (and head-end
(< head-found head-end
))
1731 (goto-char head-start
)
1732 (when (and set-auto-coding-for-load
1734 "\\(.*;\\)?[ \t]*unibyte:[ \t]*\\([^ ;]+\\)"
1736 (setq coding-system
'raw-text
))
1737 (when (and (not coding-system
)
1739 "\\(.*;\\)?[ \t]*coding:[ \t]*\\([^ ;]+\\)"
1741 (setq coding-system
(intern (match-string 2))))
1742 (when (re-search-forward
1743 "\\(.*;\\)?[ \t]*enable-character-translation:[ \t]*\\([^ ;]+\\)"
1745 (setq char-trans
(match-string 2)))))
1747 ;; If no coding: tag in the head, check the tail.
1748 ;; Here we must pay attention to the case that the end-of-line
1749 ;; is just "\r" and we can't use "^" nor "$" in regexp.
1750 (when (and tail-found
(or (not coding-system
) (not char-trans
)))
1751 (goto-char tail-start
)
1752 (re-search-forward "[\r\n]\^L" tail-end t
)
1753 (if (re-search-forward
1754 "[\r\n]\\([^[\r\n]*\\)[ \t]*Local Variables:[ \t]*\\([^\r\n]*\\)[\r\n]"
1756 ;; The prefix is what comes before "local variables:" in its
1757 ;; line. The suffix is what comes after "local variables:"
1759 (let* ((prefix (regexp-quote (match-string 1)))
1760 (suffix (regexp-quote (match-string 2)))
1764 ;; N.B. without the \n below, the regexp can
1766 "[ \t]*coding[ \t]*:[ \t]*\\([^ \t\r\n]+\\)[ \t]*"
1771 "[ \t]*unibyte[ \t]*:[ \t]*\\([^ \t\r\n]+\\)[ \t]*"
1776 "[ \t]*enable-character-translation[ \t]*:[ \t]*\\([^ \t\r\n]+\\)[ \t]*"
1779 (concat "[\r\n]" prefix
"[ \t]*End *:[ \t]*" suffix
1782 (forward-char -
1) ; skip back \r or \n.
1783 (re-search-forward re-end tail-end
'move
)
1784 (setq tail-end
(point))
1786 (when (and set-auto-coding-for-load
1787 (re-search-forward re-unibyte tail-end t
))
1788 (setq coding-system
'raw-text
))
1789 (when (and (not coding-system
)
1790 (re-search-forward re-coding tail-end t
))
1791 (setq coding-system
(intern (match-string 1))))
1792 (when (and (not char-trans
)
1793 (re-search-forward re-char-trans tail-end t
))
1794 (setq char-trans
(match-string 1))))))
1796 ;; If the coding-system name ends with "!", remove it and
1797 ;; set char-trans to "nil".
1798 (let ((name (symbol-name coding-system
)))
1799 (if (= (aref name
(1- (length name
))) ?
!)
1800 (setq coding-system
(intern (substring name
0 -
1))
1801 char-trans
"nil"))))
1802 (when (and char-trans
1803 (not (setq char-trans
(intern char-trans
))))
1804 (make-local-variable 'enable-character-translation
)
1805 (setq enable-character-translation nil
))
1807 (cons coding-system
:coding
)))
1808 ;; Finally, try all the `auto-coding-functions'.
1809 (let ((funcs auto-coding-functions
)
1810 (coding-system nil
))
1811 (while (and funcs
(not coding-system
))
1812 (setq coding-system
(condition-case e
1814 (goto-char (point-min))
1815 (funcall (pop funcs
) size
))
1818 (cons coding-system
'auto-coding-functions
)))))
1820 (defun set-auto-coding (filename size
)
1821 "Return coding system for a file FILENAME of which SIZE bytes follow point.
1822 See `find-auto-coding' for how the coding system is found.
1823 Return nil if an invalid coding system is found.
1825 The variable `set-auto-coding-function' (which see) is set to this
1826 function by default."
1827 (let ((found (find-auto-coding filename size
)))
1828 (if (and found
(coding-system-p (car found
)))
1831 (setq set-auto-coding-function
'set-auto-coding
)
1833 ;; This variable is set in these two cases:
1834 ;; (1) A file is read by a coding system specified explicitly.
1835 ;; after-insert-file-set-coding sets this value to
1836 ;; coding-system-for-read.
1837 ;; (2) A buffer is saved.
1838 ;; After writing, basic-save-buffer-1 sets this value to
1839 ;; last-coding-system-used.
1840 ;; This variable is used for decoding in revert-buffer.
1841 (defvar buffer-file-coding-system-explicit nil
1842 "The file coding system explicitly specified for the current buffer.
1843 Internal use only.")
1844 (make-variable-buffer-local 'buffer-file-coding-system-explicit
)
1845 (put 'buffer-file-coding-system-explicit
'permanent-local t
)
1847 (defun after-insert-file-set-coding (inserted &optional visit
)
1848 "Set `buffer-file-coding-system' of current buffer after text is inserted.
1849 INSERTED is the number of characters that were inserted, as figured
1850 in the situation before this function. Return the number of characters
1851 inserted, as figured in the situation after. The two numbers can be
1852 different if the buffer has become unibyte.
1853 The optional second arg VISIT non-nil means that we are visiting a file."
1855 coding-system-for-read
1856 (not (eq coding-system-for-read
'auto-save-coding
)))
1857 (setq buffer-file-coding-system-explicit coding-system-for-read
))
1858 (if last-coding-system-used
1859 (let ((coding-system
1860 (find-new-buffer-file-coding-system last-coding-system-used
))
1861 (modified-p (buffer-modified-p)))
1863 ;; Tell set-buffer-file-coding-system not to mark the file
1864 ;; as modified; we just read it, and it's supposed to be unmodified.
1865 ;; Marking it modified would try to lock it, which would
1866 ;; check the modtime, and we don't want to do that again now.
1867 (set-buffer-file-coding-system coding-system t t
)
1868 (if (and enable-multibyte-characters
1869 (or (eq coding-system
'no-conversion
)
1870 (eq (coding-system-type coding-system
) 5))
1871 ;; If buffer was unmodified and the size is the
1872 ;; same as INSERTED, we must be visiting it.
1874 (= (buffer-size) inserted
))
1875 ;; For coding systems no-conversion and raw-text...,
1876 ;; edit the buffer as unibyte.
1877 (let ((pos-marker (copy-marker (+ (point) inserted
)))
1879 (buffer-file-name nil
))
1881 ;; If we're doing this for find-file,
1882 ;; don't record undo info; this counts as
1883 ;; part of producing the buffer's initial contents.
1884 (let ((buffer-undo-list t
))
1885 (set-buffer-multibyte nil
))
1886 (set-buffer-multibyte nil
))
1887 (setq inserted
(- pos-marker
(point)))))
1888 (restore-buffer-modified-p modified-p
))))
1891 ;; The coding-spec and eol-type of coding-system returned is decided
1892 ;; independently in the following order.
1893 ;; 1. That of buffer-file-coding-system locally bound.
1894 ;; 2. That of CODING.
1896 (defun find-new-buffer-file-coding-system (coding)
1897 "Return a coding system for a buffer when a file of CODING is inserted.
1898 The local variable `buffer-file-coding-system' of the current buffer
1899 is set to the returned value.
1900 Return nil if there's no need to set `buffer-file-coding-system'."
1901 (let (local-coding local-eol
1902 found-coding found-eol
1905 ;; Nothing found about coding.
1908 ;; Get information of `buffer-file-coding-system' in LOCAL-EOL
1909 ;; and LOCAL-CODING.
1910 (setq local-eol
(coding-system-eol-type buffer-file-coding-system
))
1911 (if (null (numberp local-eol
))
1912 ;; But eol-type is not yet set.
1913 (setq local-eol nil
))
1914 (if (and buffer-file-coding-system
1915 (not (eq (coding-system-type buffer-file-coding-system
) t
)))
1916 ;; This is not `undecided'.
1917 (setq local-coding
(coding-system-base buffer-file-coding-system
)))
1919 (if (and (local-variable-p 'buffer-file-coding-system
)
1920 local-eol local-coding
)
1921 ;; The current buffer has already set full coding-system, we
1922 ;; had better not change it.
1925 (setq found-eol
(coding-system-eol-type coding
))
1926 (if (null (numberp found-eol
))
1927 ;; But eol-type is not found.
1928 ;; If EOL conversions are inhibited, force unix eol-type.
1929 (setq found-eol
(if inhibit-eol-conversion
0)))
1930 (if (eq (coding-system-type coding
) t
)
1931 (setq found-coding
'undecided
)
1932 (setq found-coding
(coding-system-base coding
)))
1934 (if (and (not found-eol
) (eq found-coding
'undecided
))
1935 ;; No valid coding information found.
1938 ;; Some coding information (eol or text) found.
1940 ;; The local setting takes precedence over the found one.
1941 (setq new-coding
(if (local-variable-p 'buffer-file-coding-system
)
1942 (or local-coding found-coding
)
1943 (or found-coding local-coding
)))
1944 (setq new-eol
(if (local-variable-p 'buffer-file-coding-system
)
1945 (or local-eol found-eol
)
1946 (or found-eol local-eol
)))
1948 (let ((eol-type (coding-system-eol-type new-coding
)))
1949 (if (and (numberp new-eol
) (vectorp eol-type
))
1950 (aref eol-type new-eol
)
1953 (defun modify-coding-system-alist (target-type regexp coding-system
)
1954 "Modify one of look up tables for finding a coding system on I/O operation.
1955 There are three of such tables, `file-coding-system-alist',
1956 `process-coding-system-alist', and `network-coding-system-alist'.
1958 TARGET-TYPE specifies which of them to modify.
1959 If it is `file', it affects `file-coding-system-alist' (which see).
1960 If it is `process', it affects `process-coding-system-alist' (which see).
1961 If it is `network', it affects `network-coding-system-alist' (which see).
1963 REGEXP is a regular expression matching a target of I/O operation.
1964 The target is a file name if TARGET-TYPE is `file', a program name if
1965 TARGET-TYPE is `process', or a network service name or a port number
1966 to connect to if TARGET-TYPE is `network'.
1968 CODING-SYSTEM is a coding system to perform code conversion on the I/O
1969 operation, or a cons cell (DECODING . ENCODING) specifying the coding systems
1970 for decoding and encoding respectively,
1971 or a function symbol which, when called, returns such a cons cell."
1972 (or (memq target-type
'(file process network
))
1973 (error "Invalid target type: %s" target-type
))
1974 (or (stringp regexp
)
1975 (and (eq target-type
'network
) (integerp regexp
))
1976 (error "Invalid regular expression: %s" regexp
))
1977 (if (symbolp coding-system
)
1978 (if (not (fboundp coding-system
))
1980 (check-coding-system coding-system
)
1981 (setq coding-system
(cons coding-system coding-system
))))
1982 (check-coding-system (car coding-system
))
1983 (check-coding-system (cdr coding-system
)))
1984 (cond ((eq target-type
'file
)
1985 (let ((slot (assoc regexp file-coding-system-alist
)))
1987 (setcdr slot coding-system
)
1988 (setq file-coding-system-alist
1989 (cons (cons regexp coding-system
)
1990 file-coding-system-alist
)))))
1991 ((eq target-type
'process
)
1992 (let ((slot (assoc regexp process-coding-system-alist
)))
1994 (setcdr slot coding-system
)
1995 (setq process-coding-system-alist
1996 (cons (cons regexp coding-system
)
1997 process-coding-system-alist
)))))
1999 (let ((slot (assoc regexp network-coding-system-alist
)))
2001 (setcdr slot coding-system
)
2002 (setq network-coding-system-alist
2003 (cons (cons regexp coding-system
)
2004 network-coding-system-alist
)))))))
2006 (defun decode-coding-inserted-region (from to filename
2007 &optional visit beg end replace
)
2008 "Decode the region between FROM and TO as if it is read from file FILENAME.
2009 The idea is that the text between FROM and TO was just inserted somehow.
2010 Optional arguments VISIT, BEG, END, and REPLACE are the same as those
2011 of the function `insert-file-contents'.
2012 Part of the job of this function is setting `buffer-undo-list' appropriately."
2015 (let ((coding coding-system-for-read
)
2018 ;; Temporarily turn off undo recording, if we're decoding the
2019 ;; text of a visited file.
2020 (setq buffer-undo-list t
)
2021 ;; Otherwise, if we can recognize the undo elt for the insertion,
2022 ;; remove it and get ready to replace it later.
2023 ;; In the mean time, turn off undo recording.
2024 (let ((last (car-safe buffer-undo-list
)))
2025 (if (and (consp last
) (eql (car last
) from
) (eql (cdr last
) to
))
2026 (setq undo-list-saved
(cdr buffer-undo-list
)
2027 buffer-undo-list t
))))
2028 (narrow-to-region from to
)
2029 (goto-char (point-min))
2031 (setq coding
(funcall set-auto-coding-function
2032 filename
(- (point-max) (point-min)))))
2034 (setq coding
(car (find-operation-coding-system
2035 'insert-file-contents
2036 (cons filename
(current-buffer))
2037 visit beg end replace
))))
2038 (if (coding-system-p coding
)
2039 (or enable-multibyte-characters
2041 (coding-system-change-text-conversion coding
'raw-text
)))
2044 (decode-coding-region (point-min) (point-max) coding
)
2045 (setq last-coding-system-used coding
))
2046 ;; If we're decoding the text of a visited file,
2047 ;; the undo list should start out empty.
2049 (setq buffer-undo-list nil
)
2050 ;; If we decided to replace the undo entry for the insertion,
2053 (setq buffer-undo-list
2054 (cons (cons from
(point-max)) undo-list-saved
))))))))
2056 (defun recode-region (start end new-coding coding
)
2057 "Re-decode the region (previously decoded by CODING) by NEW-CODING."
2059 (list (region-beginning) (region-end)
2060 (read-coding-system "Text was really in: ")
2061 (let ((coding (or buffer-file-coding-system last-coding-system-used
)))
2063 (concat "But was interpreted as"
2064 (if coding
(format " (default %S): " coding
) ": "))
2066 (or (and new-coding coding
)
2067 (error "Coding system not specified"))
2068 ;; Check it before we encode the region.
2069 (check-coding-system new-coding
)
2071 (narrow-to-region start end
)
2072 (encode-coding-region (point-min) (point-max) coding
)
2073 (decode-coding-region (point-min) (point-max) new-coding
)))
2075 (defun make-translation-table (&rest args
)
2076 "Make a translation table from arguments.
2077 A translation table is a char table intended for character
2078 translation in CCL programs.
2080 Each argument is a list of elements of the form (FROM . TO), where FROM
2081 is a character to be translated to TO.
2083 FROM can be a generic character (see `make-char'). In this case, TO is
2084 a generic character containing the same number of characters, or an
2085 ordinary character. If FROM and TO are both generic characters, all
2086 characters belonging to FROM are translated to characters belonging to TO
2087 without changing their position code(s).
2089 The arguments and forms in each argument are processed in the given
2090 order, and if a previous form already translates TO to some other
2091 character, say TO-ALT, FROM is also translated to TO-ALT."
2092 (let ((table (make-char-table 'translation-table
))
2095 (let ((elts (car args
)))
2097 (let* ((from (car (car elts
)))
2098 (from-i 0) ; degree of freedom of FROM
2099 (from-rev (nreverse (split-char from
)))
2100 (to (cdr (car elts
)))
2101 (to-i 0) ; degree of freedom of TO
2102 (to-rev (nreverse (split-char to
))))
2103 ;; Check numbers of heading 0s in FROM-REV and TO-REV.
2104 (while (eq (car from-rev
) 0)
2105 (setq from-i
(1+ from-i
) from-rev
(cdr from-rev
)))
2106 (while (eq (car to-rev
) 0)
2107 (setq to-i
(1+ to-i
) to-rev
(cdr to-rev
)))
2108 (if (and (/= from-i to-i
) (/= to-i
0))
2109 (error "Invalid character pair (%d . %d)" from to
))
2110 ;; If we have already translated TO to TO-ALT, FROM should
2111 ;; also be translated to TO-ALT. But, this is only if TO
2112 ;; is a generic character or TO-ALT is not a generic
2114 (let ((to-alt (aref table to
)))
2116 (or (> to-i
0) (not (generic-char-p to-alt
))))
2119 (set-char-table-default table from to
)
2120 (aset table from to
))
2121 ;; If we have already translated some chars to FROM, they
2122 ;; should also be translated to TO.
2123 (let ((l (assq from revlist
)))
2130 (setq l
(cdr l
)) ))))
2131 ;; Now update REVLIST.
2132 (let ((l (assq to revlist
)))
2134 (setcdr l
(cons from
(cdr l
)))
2135 (setq revlist
(cons (list to from
) revlist
)))))
2136 (setq elts
(cdr elts
))))
2137 (setq args
(cdr args
)))
2138 ;; Return TABLE just created.
2141 (defun make-translation-table-from-vector (vec)
2142 "Make translation table from decoding vector VEC.
2143 VEC is an array of 256 elements to map unibyte codes to multibyte
2144 characters. Elements may be nil for undefined code points.
2145 See also the variable `nonascii-translation-table'."
2146 (let ((table (make-char-table 'translation-table
))
2147 (rev-table (make-char-table 'translation-table
))
2150 (setq ch
(aref vec i
))
2154 (aset rev-table ch i
))))
2155 (set-char-table-extra-slot table
0 rev-table
)
2158 (defun define-translation-table (symbol &rest args
)
2159 "Define SYMBOL as the name of translation table made by ARGS.
2160 This sets up information so that the table can be used for
2161 translations in a CCL program.
2163 If the first element of ARGS is a char-table whose purpose is
2164 `translation-table', just define SYMBOL to name it. (Note that this
2165 function does not bind SYMBOL.)
2167 Any other ARGS should be suitable as arguments of the function
2168 `make-translation-table' (which see).
2170 This function sets properties `translation-table' and
2171 `translation-table-id' of SYMBOL to the created table itself and the
2172 identification number of the table respectively. It also registers
2173 the table in `translation-table-vector'."
2174 (let ((table (if (and (char-table-p (car args
))
2175 (eq (char-table-subtype (car args
))
2176 'translation-table
))
2178 (apply 'make-translation-table args
)))
2179 (len (length translation-table-vector
))
2182 (put symbol
'translation-table table
)
2185 (setq translation-table-vector
2186 (vconcat translation-table-vector
(make-vector len nil
))))
2187 (let ((slot (aref translation-table-vector id
)))
2189 (eq (car slot
) symbol
))
2191 (aset translation-table-vector id
(cons symbol table
))
2193 (setq id
(1+ id
)))))
2194 (put symbol
'translation-table-id id
)
2197 (defun translate-region (start end table
)
2198 "From START to END, translate characters according to TABLE.
2199 TABLE is a string or a char-table.
2200 If TABLE is a string, the Nth character in it is the mapping
2201 for the character with code N.
2202 If TABLE is a char-table, the element for character N is the mapping
2203 for the character with code N.
2204 It returns the number of characters changed."
2206 (list (region-beginning)
2209 (dotimes (i (length translation-table-vector
))
2210 (if (consp (aref translation-table-vector i
))
2211 (push (list (symbol-name
2212 (car (aref translation-table-vector i
)))) l
)))
2214 (error "No translation table defined"))
2216 (setq table
(completing-read "Translation table: " l nil t
)))
2219 (let ((val (get table
'translation-table
)))
2220 (or (char-table-p val
)
2221 (error "Invalid translation table name: %s" table
))
2223 (translate-region-internal start end table
))
2225 (put 'with-category-table
'lisp-indent-function
1)
2227 (defmacro with-category-table
(table &rest body
)
2228 "Evaluate BODY with category table of current buffer set to TABLE.
2229 The category table of the current buffer is saved, BODY is evaluated,
2230 then the saved table is restored, even in case of an abnormal exit.
2231 Value is what BODY returns."
2232 (let ((old-table (make-symbol "old-table"))
2233 (old-buffer (make-symbol "old-buffer")))
2234 `(let ((,old-table
(category-table))
2235 (,old-buffer
(current-buffer)))
2238 (set-category-table ,table
)
2240 (with-current-buffer ,old-buffer
2241 (set-category-table ,old-table
))))))
2243 (defun define-translation-hash-table (symbol table
)
2244 "Define SYMBOL as the name of the hash translation TABLE for use in CCL.
2246 Analogous to `define-translation-table', but updates
2247 `translation-hash-table-vector' and the table is for use in the CCL
2248 `lookup-integer' and `lookup-character' functions."
2249 (unless (and (symbolp symbol
)
2250 (hash-table-p table
))
2251 (error "Bad args to define-translation-hash-table"))
2252 (let ((len (length translation-hash-table-vector
))
2255 (put symbol
'translation-hash-table table
)
2258 (setq translation-hash-table-vector
2259 (vconcat translation-hash-table-vector
[nil])))
2260 (let ((slot (aref translation-hash-table-vector id)))
2262 (eq (car slot) symbol))
2264 (aset translation-hash-table-vector id (cons symbol table))
2266 (setq id (1+ id)))))
2267 (put symbol 'translation-hash-table-id id)
2270 ;;; Initialize some variables.
2272 (put 'use-default-ascent 'char-table-extra-slots 0)
2273 (setq use-default-ascent (make-char-table 'use-default-ascent))
2274 (put 'ignore-relative-composition 'char-table-extra-slots 0)
2275 (setq ignore-relative-composition
2276 (make-char-table 'ignore-relative-composition))
2279 ;;; Built-in auto-coding-functions:
2281 (defun sgml-xml-auto-coding-function (size)
2282 "Determine whether the buffer is XML, and if so, its encoding.
2283 This function is intended to be added to `auto-coding-functions'."
2284 (setq size (+ (point) size))
2285 (when (re-search-forward "\\`[[:space:]\n]*<\\?xml" size t)
2286 (let ((end (save-excursion
2288 (re-search-forward "[\"']\\s-*\\?>" size t))))
2290 (if (re-search-forward "encoding=[\"']\\(.+?\\)[\"']" end t)
2291 (let* ((match (match-string 1))
2292 (sym (intern (downcase match))))
2293 (if (coding-system-p sym)
2295 (message "Warning: unknown coding system \"%s\"" match)
2299 (defun sgml-html-meta-auto-coding-function (size)
2300 "If the buffer has an HTML meta tag, use it to determine encoding.
2301 This function is intended to be added to `auto-coding-functions'."
2302 (setq size (min (+ (point) size)
2304 ;; Limit the search by the end of the HTML header.
2305 (or (search-forward "</head>" size t)
2306 ;; In case of no header, search only 10 lines.
2309 ;; Make sure that the buffer really contains an HTML document, by
2310 ;; checking that it starts with a doctype or a <HTML> start tag
2311 ;; (allowing for whitespace at bob). Note: 'DOCTYPE NETSCAPE' is
2312 ;; useful for Mozilla bookmark files.
2313 (when (and (re-search-forward "\\`[[:space:]\n]*\\(<!doctype[[:space:]\n]+\\(html\\|netscape\\)\\|<html\\)" size t)
2314 (re-search-forward "<meta\\s-+http-equiv=[\"']?content-type[\"']?\\s-+content=[\"']text/\\sw+;\\s-*charset=\\(.+?\\)[\"']" size t))
2315 (let* ((match (match-string 1))
2316 (sym (intern (downcase match))))
2317 (if (coding-system-p sym)
2319 (message "Warning: unknown coding system \"%s\"" match)
2325 ;; arch-tag: 9aebaa6e-0e8a-40a9-b857-cb5d04a39e7c
2326 ;;; mule.el ends here