(Vafter_insert_file_adjust_coding_function): Delete
[bpt/emacs.git] / lisp / international / mule.el
CommitLineData
4ed46869
KH
1;;; mule.el --- basic commands for mulitilingual environment
2
4ed46869 3;; Copyright (C) 1995 Electrotechnical Laboratory, JAPAN.
58cfed09 4;; Licensed to the Free Software Foundation.
32db08f1 5;; Copyright (C) 2001, 2002 Free Software Foundation, Inc.
4ed46869
KH
6
7;; Keywords: mule, multilingual, character set, coding system
8
9;; This file is part of GNU Emacs.
10
11;; GNU Emacs is free software; you can redistribute it and/or modify
12;; it under the terms of the GNU General Public License as published by
13;; the Free Software Foundation; either version 2, or (at your option)
14;; any later version.
15
16;; GNU Emacs is distributed in the hope that it will be useful,
17;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19;; GNU General Public License for more details.
20
21;; You should have received a copy of the GNU General Public License
369314dc
KH
22;; along with GNU Emacs; see the file COPYING. If not, write to the
23;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
24;; Boston, MA 02111-1307, USA.
4ed46869 25
60370d40
PJ
26;;; Commentary:
27
4ed46869
KH
28;;; Code:
29
d2542b42 30(defconst mule-version "5.0 (SAKAKI)" "\
4ed46869
KH
31Version number and name of this version of MULE (multilingual environment).")
32
35554641 33(defconst mule-version-date "1999.12.7" "\
4ed46869
KH
34Distribution date of this version of MULE (multilingual environment).")
35
36(defun load-with-code-conversion (fullname file &optional noerror nomessage)
0f69cb38
KH
37 "Execute a file of Lisp code named FILE whose absolute name is FULLNAME.
38The file contents are decoded before evaluation if necessary.
4ed46869
KH
39If optional second arg NOERROR is non-nil,
40 report no error if FILE doesn't exist.
41Print messages at start and end of loading unless
42 optional third arg NOMESSAGE is non-nil.
43Return t if file exists."
44 (if (null (file-readable-p fullname))
45 (and (null noerror)
46 (signal 'file-error (list "Cannot open load file" file)))
47 ;; Read file with code conversion, and then eval.
48 (let* ((buffer
49 ;; To avoid any autoloading, set default-major-mode to
50 ;; fundamental-mode.
88162676
RS
51 ;; So that we don't get completely screwed if the
52 ;; file is encoded in some complicated character set,
53 ;; read it with real decoding, as a multibyte buffer,
54 ;; even if this is a --unibyte Emacs session.
55 (let ((default-major-mode 'fundamental-mode)
56 (default-enable-multibyte-characters t))
4ed46869
KH
57 ;; We can't use `generate-new-buffer' because files.el
58 ;; is not yet loaded.
59 (get-buffer-create (generate-new-buffer-name " *load*"))))
db5cae4b
SM
60 (load-in-progress t)
61 (source (save-match-data (string-match "\\.el\\'" fullname))))
62 (unless nomessage
63 (if source
64 (message "Loading %s (source)..." file)
65 (message "Loading %s..." file)))
66 (when purify-flag
4c86cca0 67 (push file preloaded-file-list))
4ed46869 68 (unwind-protect
a6acd8a2 69 (let ((load-file-name fullname)
1c4cc63a 70 (set-auto-coding-for-load t)
a6acd8a2 71 (inhibit-file-name-operation nil))
4ed46869
KH
72 (save-excursion
73 (set-buffer buffer)
74 (insert-file-contents fullname)
7d276780
EZ
75 ;; If the loaded file was inserted with no-conversion or
76 ;; raw-text coding system, make the buffer unibyte.
77 ;; Otherwise, eval-buffer might try to interpret random
78 ;; binary junk as multibyte characters.
79 (if (and enable-multibyte-characters
80 (or (eq (coding-system-type last-coding-system-used) 5)
81 (eq last-coding-system-used 'no-conversion)))
82 (set-buffer-multibyte nil))
4ed46869
KH
83 ;; Make `kill-buffer' quiet.
84 (set-buffer-modified-p nil))
0f69cb38 85 ;; Have the original buffer current while we eval.
88162676
RS
86 (eval-buffer buffer nil file
87 ;; If this Emacs is running with --unibyte,
88 ;; convert multibyte strings to unibyte
89 ;; after reading them.
ba74e833 90;; (not default-enable-multibyte-characters)
8dd08b5b 91 nil t
ba74e833 92 ))
cfc70cdf
RS
93 (let (kill-buffer-hook kill-buffer-query-functions)
94 (kill-buffer buffer)))
4ed46869 95 (let ((hook (assoc file after-load-alist)))
db5cae4b
SM
96 (when hook
97 (mapcar (function eval) (cdr hook))))
98 (unless (or nomessage noninteractive)
99 (if source
100 (message "Loading %s (source)...done" file)
101 (message "Loading %s...done" file)))
4ed46869
KH
102 t)))
103
104;; API (Application Program Interface) for charsets.
105
2e02a76f 106(defsubst charset-quoted-standard-p (obj)
521d4010 107 "Return t if OBJ is a quoted symbol, and is the name of a standard charset."
2e02a76f
RS
108 (and (listp obj) (eq (car obj) 'quote)
109 (symbolp (car-safe (cdr obj)))
110 (let ((vector (get (car-safe (cdr obj)) 'charset)))
111 (and (vectorp vector)
112 (< (aref vector 0) 160)))))
4ed46869
KH
113
114(defsubst charsetp (object)
e4a7fdfc 115 "T if OBJECT is a charset."
4ed46869
KH
116 (and (symbolp object) (vectorp (get object 'charset))))
117
118(defsubst charset-info (charset)
119 "Return a vector of information of CHARSET.
120The elements of the vector are:
121 CHARSET-ID, BYTES, DIMENSION, CHARS, WIDTH, DIRECTION,
122 LEADING-CODE-BASE, LEADING-CODE-EXT,
123 ISO-FINAL-CHAR, ISO-GRAPHIC-PLANE,
124 REVERSE-CHARSET, SHORT-NAME, LONG-NAME, DESCRIPTION,
125 PLIST,
126where
127CHARSET-ID (integer) is the identification number of the charset.
aa8bb645
KH
128BYTES (integer) is the length of multi-byte form of a character in
129 the charset: one of 1, 2, 3, and 4.
4ed46869
KH
130DIMENSION (integer) is the number of bytes to represent a character of
131the charset: 1 or 2.
132CHARS (integer) is the number of characters in a dimension: 94 or 96.
4ed46869
KH
133WIDTH (integer) is the number of columns a character in the charset
134 occupies on the screen: one of 0, 1, and 2.
135DIRECTION (integer) is the rendering direction of characters in the
08b4ace5
KH
136 charset when rendering. If 0, render from left to right, else
137 render from right to left.
4ed46869
KH
138LEADING-CODE-BASE (integer) is the base leading-code for the
139 charset.
140LEADING-CODE-EXT (integer) is the extended leading-code for the
141 charset. All charsets of less than 0xA0 has the value 0.
142ISO-FINAL-CHAR (character) is the final character of the
7dd4c92d
KH
143 corresponding ISO 2022 charset. If the charset is not assigned
144 any final character, the value is -1.
4ed46869
KH
145ISO-GRAPHIC-PLANE (integer) is the graphic plane to be invoked
146 while encoding to variants of ISO 2022 coding system, one of the
147 following: 0/graphic-plane-left(GL), 1/graphic-plane-right(GR).
7dd4c92d 148 If the charset is not assigned any final character, the value is -1.
4ed46869
KH
149REVERSE-CHARSET (integer) is the charset which differs only in
150 LEFT-TO-RIGHT value from the charset. If there's no such a
151 charset, the value is -1.
152SHORT-NAME (string) is the short name to refer to the charset.
153LONG-NAME (string) is the long name to refer to the charset
154DESCRIPTION (string) is the description string of the charset.
155PLIST (property list) may contain any type of information a user
156 want to put and get by functions `put-charset-property' and
157 `get-charset-property' respectively."
158 (get charset 'charset))
159
40c81f74
PE
160;; It is better not to use backquote in this file,
161;; because that makes a bootstrapping problem
162;; if you need to recompile all the Lisp files using interpreted code.
163
4ed46869
KH
164(defmacro charset-id (charset)
165 "Return charset identification number of CHARSET."
2e02a76f 166 (if (charset-quoted-standard-p charset)
4ed46869 167 (aref (charset-info (nth 1 charset)) 0)
40c81f74 168 (list 'aref (list 'charset-info charset) 0)))
4ed46869
KH
169
170(defmacro charset-bytes (charset)
900dc6e3
KH
171 "Return bytes of CHARSET.
172See the function `charset-info' for more detail."
2e02a76f 173 (if (charset-quoted-standard-p charset)
4ed46869 174 (aref (charset-info (nth 1 charset)) 1)
40c81f74 175 (list 'aref (list 'charset-info charset) 1)))
4ed46869
KH
176
177(defmacro charset-dimension (charset)
900dc6e3
KH
178 "Return dimension of CHARSET.
179See the function `charset-info' for more detail."
2e02a76f 180 (if (charset-quoted-standard-p charset)
4ed46869 181 (aref (charset-info (nth 1 charset)) 2)
40c81f74 182 (list 'aref (list 'charset-info charset) 2)))
4ed46869
KH
183
184(defmacro charset-chars (charset)
900dc6e3
KH
185 "Return character numbers contained in a dimension of CHARSET.
186See the function `charset-info' for more detail."
2e02a76f 187 (if (charset-quoted-standard-p charset)
4ed46869 188 (aref (charset-info (nth 1 charset)) 3)
40c81f74 189 (list 'aref (list 'charset-info charset) 3)))
4ed46869
KH
190
191(defmacro charset-width (charset)
900dc6e3
KH
192 "Return width (how many column occupied on a screen) of CHARSET.
193See the function `charset-info' for more detail."
2e02a76f 194 (if (charset-quoted-standard-p charset)
4ed46869 195 (aref (charset-info (nth 1 charset)) 4)
40c81f74 196 (list 'aref (list 'charset-info charset) 4)))
4ed46869
KH
197
198(defmacro charset-direction (charset)
900dc6e3
KH
199 "Return direction of CHARSET.
200See the function `charset-info' for more detail."
2e02a76f 201 (if (charset-quoted-standard-p charset)
4ed46869 202 (aref (charset-info (nth 1 charset)) 5)
40c81f74 203 (list 'aref (list 'charset-info charset) 5)))
4ed46869
KH
204
205(defmacro charset-iso-final-char (charset)
900dc6e3
KH
206 "Return final char of CHARSET.
207See the function `charset-info' for more detail."
2e02a76f 208 (if (charset-quoted-standard-p charset)
4ed46869 209 (aref (charset-info (nth 1 charset)) 8)
40c81f74 210 (list 'aref (list 'charset-info charset) 8)))
4ed46869
KH
211
212(defmacro charset-iso-graphic-plane (charset)
900dc6e3
KH
213 "Return graphic plane of CHARSET.
214See the function `charset-info' for more detail."
2e02a76f 215 (if (charset-quoted-standard-p charset)
4ed46869 216 (aref (charset-info (nth 1 charset)) 9)
40c81f74 217 (list 'aref (list 'charset-info charset) 9)))
4ed46869
KH
218
219(defmacro charset-reverse-charset (charset)
900dc6e3
KH
220 "Return reverse charset of CHARSET.
221See the function `charset-info' for more detail."
2e02a76f 222 (if (charset-quoted-standard-p charset)
4ed46869 223 (aref (charset-info (nth 1 charset)) 10)
40c81f74 224 (list 'aref (list 'charset-info charset) 10)))
4ed46869
KH
225
226(defmacro charset-short-name (charset)
900dc6e3
KH
227 "Return short name of CHARSET.
228See the function `charset-info' for more detail."
2e02a76f 229 (if (charset-quoted-standard-p charset)
4ed46869 230 (aref (charset-info (nth 1 charset)) 11)
40c81f74 231 (list 'aref (list 'charset-info charset) 11)))
4ed46869
KH
232
233(defmacro charset-long-name (charset)
900dc6e3
KH
234 "Return long name of CHARSET.
235See the function `charset-info' for more detail."
2e02a76f 236 (if (charset-quoted-standard-p charset)
4ed46869 237 (aref (charset-info (nth 1 charset)) 12)
40c81f74 238 (list 'aref (list 'charset-info charset) 12)))
4ed46869
KH
239
240(defmacro charset-description (charset)
0611934b 241 "Return description of CHARSET.
900dc6e3 242See the function `charset-info' for more detail."
2e02a76f 243 (if (charset-quoted-standard-p charset)
4ed46869 244 (aref (charset-info (nth 1 charset)) 13)
40c81f74 245 (list 'aref (list 'charset-info charset) 13)))
4ed46869
KH
246
247(defmacro charset-plist (charset)
900dc6e3
KH
248 "Return list charset property of CHARSET.
249See the function `charset-info' for more detail."
40c81f74
PE
250 (list 'aref
251 (if (charset-quoted-standard-p charset)
252 (charset-info (nth 1 charset))
253 (list 'charset-info charset))
254 14))
4ed46869
KH
255
256(defun set-charset-plist (charset plist)
e8dd0160 257 "Set CHARSET's property list to PLIST, and return PLIST."
4ed46869
KH
258 (aset (charset-info charset) 14 plist))
259
d3e7e7cf
EZ
260(defun make-char (charset &optional code1 code2)
261 "Return a character of CHARSET whose position codes are CODE1 and CODE2.
f98e2797 262CODE1 and CODE2 are optional, but if you don't supply
a9fb0b58
KH
263sufficient position codes, return a generic character which stands for
264all characters or group of characters in the character set.
d3e7e7cf 265A generic character can be used to index a char table (e.g. syntax-table).
9ff05eae
KH
266
267Such character sets as ascii, eight-bit-control, and eight-bit-graphic
268don't have corresponding generic characters. If CHARSET is one of
269them and you don't supply CODE1, return the character of the smallest
270code in CHARSET.
271
6fb7766c
DL
272If CODE1 or CODE2 are invalid (out of range), this function signals an
273error. However, the eighth bit of both CODE1 and CODE2 is zeroed
274before they are used to index CHARSET. Thus you may use, say, the
275actual ISO 8859 character code rather than subtracting 128, as you
276would need to index the corresponding Emacs charset."
636799f2 277 (make-char-internal (charset-id charset) code1 code2))
a6acd8a2
KH
278
279(put 'make-char 'byte-compile
521d4010 280 (function
a6acd8a2
KH
281 (lambda (form)
282 (let ((charset (nth 1 form)))
283 (if (charset-quoted-standard-p charset)
284 (byte-compile-normal-call
285 (cons 'make-char-internal
286 (cons (charset-id (nth 1 charset)) (nthcdr 2 form))))
287 (byte-compile-normal-call
288 (cons 'make-char-internal
289 (cons (list 'charset-id charset) (nthcdr 2 form)))))))))
4ed46869 290
d3675a42 291(defun charset-list ()
900dc6e3
KH
292 "Return list of charsets ever defined.
293
d3675a42 294This function is provided for backward compatibility.
900dc6e3 295Now we have the variable `charset-list'."
d3675a42
KH
296 charset-list)
297
13d5617d
KH
298(defsubst generic-char-p (char)
299 "Return t if and only if CHAR is a generic character.
521d4010 300See also the documentation of `make-char'."
1d935669
KH
301 (and (>= char 0400)
302 (let ((l (split-char char)))
303 (and (or (= (nth 1 l) 0) (eq (nth 2 l) 0))
304 (not (eq (car l) 'composition))))))
69eba008 305
cc57cc54 306(defun decode-char (ccs code-point &optional restriction)
7f341749 307 "Return character specified by coded character set CCS and CODE-POINT in it.
cc57cc54 308Return nil if such a character is not supported.
e76938e7 309Currently the only supported coded character set is `ucs' (ISO/IEC
9fb1b1a8 31010646: Universal Multi-Octet Coded Character Set), and the result is
0c76a98d
KH
311translated through the translation-table named
312`utf-translation-table-for-decode' or the translation-hash-table named
313`utf-subst-table-for-decode'.
cc57cc54
KH
314
315Optional argument RESTRICTION specifies a way to map the pair of CCS
e7fea150 316and CODE-POINT to a character. Currently not supported and just ignored."
9fb1b1a8
DL
317 (cond
318 ((eq ccs 'ucs)
0c76a98d
KH
319 (or (gethash code-point
320 (get 'utf-subst-table-for-decode 'translation-hash-table))
321 (let ((c (cond
322 ((< code-point 160)
323 code-point)
324 ((< code-point 256)
325 (make-char 'latin-iso8859-1 code-point))
326 ((< code-point #x2500)
327 (setq code-point (- code-point #x0100))
328 (make-char 'mule-unicode-0100-24ff
329 (+ (/ code-point 96) 32) (+ (% code-point 96) 32)))
330 ((< code-point #x3400)
331 (setq code-point (- code-point #x2500))
332 (make-char 'mule-unicode-2500-33ff
333 (+ (/ code-point 96) 32) (+ (% code-point 96) 32)))
334 ((and (>= code-point #xe000) (< code-point #x10000))
335 (setq code-point (- code-point #xe000))
336 (make-char 'mule-unicode-e000-ffff
337 (+ (/ code-point 96) 32)
338 (+ (% code-point 96) 32))))))
339 (when c
340 (or (aref (get 'utf-translation-table-for-decode
341 'translation-table) c)
342 c)))))))
cc57cc54
KH
343
344(defun encode-char (char ccs &optional restriction)
7f341749 345 "Return code-point in coded character set CCS that corresponds to CHAR.
cc57cc54 346Return nil if CHAR is not included in CCS.
e76938e7 347Currently the only supported coded character set is `ucs' (ISO/IEC
9fb1b1a8 34810646: Universal Multi-Octet Coded Character Set), and CHAR is first
0c76a98d
KH
349translated through the translation-table named
350`utf-translation-table-for-encode' or the translation-hash-table named
351`utf-subst-table-for-encode'.
7f341749
KH
352
353CHAR should be in one of these charsets:
cc57cc54 354 ascii, latin-iso8859-1, mule-unicode-0100-24ff, mule-unicode-2500-33ff,
6ba9b20b 355 mule-unicode-e000-ffff, eight-bit-control
cc57cc54
KH
356Otherwise, return nil.
357
358Optional argument RESTRICTION specifies a way to map CHAR to a
359code-point in CCS. Currently not supported and just ignored."
360 (let* ((split (split-char char))
9fb1b1a8
DL
361 (charset (car split))
362 trans)
cc57cc54 363 (cond ((eq ccs 'ucs)
0c76a98d
KH
364 (or (gethash char (get 'utf-subst-table-for-encode
365 'translation-hash-table))
366 (let ((table (get 'utf-translation-table-for-encode
367 'translation-table)))
368 (setq trans (aref table char))
369 (if trans
370 (setq split (split-char trans)
371 charset (car split)))
372 (cond ((eq charset 'ascii)
373 char)
374 ((eq charset 'latin-iso8859-1)
375 (+ (nth 1 split) 128))
376 ((eq charset 'mule-unicode-0100-24ff)
377 (+ #x0100 (+ (* (- (nth 1 split) 32) 96)
378 (- (nth 2 split) 32))))
379 ((eq charset 'mule-unicode-2500-33ff)
380 (+ #x2500 (+ (* (- (nth 1 split) 32) 96)
381 (- (nth 2 split) 32))))
382 ((eq charset 'mule-unicode-e000-ffff)
383 (+ #xe000 (+ (* (- (nth 1 split) 32) 96)
384 (- (nth 2 split) 32))))
385 ((eq charset 'eight-bit-control)
386 char))))))))
cc57cc54 387
0269ddfb 388\f
e76938e7 389;; Coding system stuff
4ed46869 390
8057896b 391;; Coding system is a symbol that has the property `coding-system'.
4ed46869 392;;
8057896b
KH
393;; The value of the property `coding-system' is a vector of the
394;; following format:
d3675a42 395;; [TYPE MNEMONIC DOC-STRING PLIST FLAGS]
8057896b 396;; We call this vector as coding-spec. See comments in src/coding.c
521d4010 397;; for more detail.
8057896b
KH
398
399(defconst coding-spec-type-idx 0)
400(defconst coding-spec-mnemonic-idx 1)
401(defconst coding-spec-doc-string-idx 2)
0269ddfb 402(defconst coding-spec-plist-idx 3)
8057896b
KH
403(defconst coding-spec-flags-idx 4)
404
a6acd8a2
KH
405;; PLIST is a property list of a coding system. To share PLIST among
406;; alias coding systems, a coding system has PLIST in coding-spec
407;; instead of having it in normal property list of Lisp symbol.
408;; Here's a list of coding system properties currently being used.
0269ddfb
KH
409;;
410;; o coding-category
411;;
412;; The value is a coding category the coding system belongs to. The
521d4010 413;; function `make-coding-system' sets this value automatically
1b46a680 414;; unless its argument PROPERTIES specifies this property.
4ed46869 415;;
0269ddfb 416;; o alias-coding-systems
4ed46869 417;;
0269ddfb
KH
418;; The value is a list of coding systems of the same alias group. The
419;; first element is the coding system made at first, which we call as
1b46a680
KH
420;; `base coding system'. The function `make-coding-system' sets this
421;; value automatically and `define-coding-system-alias' updates it.
0269ddfb 422;;
3c948dde
KH
423;; See the documentation of make-coding-system for the meanings of the
424;; following properties.
4ed46869 425;;
3c948dde 426;; o post-read-conversion
0269ddfb 427;; o pre-write-conversion
f967223b 428;; o translation-table-for-decode
f967223b 429;; o translation-table-for-encode
c11a8f77 430;; o safe-chars
a6acd8a2 431;; o safe-charsets
b25eef20 432;; o mime-charset
c76b5c99 433;; o valid-codes (meaningful only for a coding system based on CCL)
c76b5c99 434
0269ddfb 435
0269ddfb 436(defsubst coding-system-spec (coding-system)
521d4010 437 "Return coding-spec of CODING-SYSTEM."
0269ddfb 438 (get (check-coding-system coding-system) 'coding-system))
4ed46869 439
4ed46869 440(defun coding-system-type (coding-system)
0269ddfb
KH
441 "Return the coding type of CODING-SYSTEM.
442A coding type is an integer value indicating the encoding method
443of CODING-SYSTEM. See the function `make-coding-system' for more detail."
2653e2a7 444 (aref (coding-system-spec coding-system) coding-spec-type-idx))
4ed46869 445
4ed46869 446(defun coding-system-mnemonic (coding-system)
0269ddfb 447 "Return the mnemonic character of CODING-SYSTEM.
6e2c8840
KH
448The mnemonic character of a coding system is used in mode line
449to indicate the coding system. If the arg is nil, return ?-."
450 (let ((spec (coding-system-spec coding-system)))
451 (if spec (aref spec coding-spec-mnemonic-idx) ?-)))
4ed46869 452
8057896b 453(defun coding-system-doc-string (coding-system)
0269ddfb 454 "Return the documentation string for CODING-SYSTEM."
2653e2a7 455 (aref (coding-system-spec coding-system) coding-spec-doc-string-idx))
4ed46869 456
d3675a42 457(defun coding-system-plist (coding-system)
0269ddfb 458 "Return the property list of CODING-SYSTEM."
2653e2a7 459 (aref (coding-system-spec coding-system) coding-spec-plist-idx))
d3675a42 460
4ed46869 461(defun coding-system-flags (coding-system)
0269ddfb
KH
462 "Return `flags' of CODING-SYSTEM.
463A `flags' of a coding system is a vector of length 32 indicating detailed
464information of a coding system. See the function `make-coding-system'
465for more detail."
2653e2a7 466 (aref (coding-system-spec coding-system) coding-spec-flags-idx))
0269ddfb
KH
467
468(defun coding-system-get (coding-system prop)
469 "Extract a value from CODING-SYSTEM's property list for property PROP."
470 (plist-get (coding-system-plist coding-system) prop))
471
472(defun coding-system-put (coding-system prop val)
473 "Change value in CODING-SYSTEM's property list PROP to VAL."
474 (let ((plist (coding-system-plist coding-system)))
475 (if plist
476 (plist-put plist prop val)
2653e2a7
KH
477 (aset (coding-system-spec coding-system) coding-spec-plist-idx
478 (list prop val)))))
0269ddfb
KH
479
480(defun coding-system-category (coding-system)
72f73748
DL
481 "Return the coding category of CODING-SYSTEM.
482See also `coding-category-list'."
0269ddfb
KH
483 (coding-system-get coding-system 'coding-category))
484
485(defun coding-system-base (coding-system)
486 "Return the base coding system of CODING-SYSTEM.
d9e3229d
KH
487A base coding system is what made by `make-coding-system'.
488Any alias nor subsidiary coding systems are not base coding system."
0269ddfb
KH
489 (car (coding-system-get coding-system 'alias-coding-systems)))
490
491(defalias 'coding-system-parent 'coding-system-base)
2598a293 492(make-obsolete 'coding-system-parent 'coding-system-base "20.3")
0269ddfb
KH
493
494;; Coding system also has a property `eol-type'.
495;;
496;; This property indicates how the coding system handles end-of-line
497;; format. The value is integer 0, 1, 2, or a vector of three coding
498;; systems. Each integer value 0, 1, and 2 indicates the format of
499;; end-of-line LF, CRLF, and CR respectively. A vector value
500;; indicates that the format of end-of-line should be detected
501;; automatically. Nth element of the vector is the subsidiary coding
502;; system whose `eol-type' property is N.
4ed46869 503
8057896b 504(defun coding-system-eol-type (coding-system)
0269ddfb
KH
505 "Return eol-type of CODING-SYSTEM.
506An eol-type is integer 0, 1, 2, or a vector of coding systems.
4ed46869 507
0269ddfb
KH
508Integer values 0, 1, and 2 indicate a format of end-of-line; LF,
509CRLF, and CR respectively.
510
511A vector value indicates that a format of end-of-line should be
512detected automatically. Nth element of the vector is the subsidiary
513coding system whose eol-type is N."
514 (get coding-system 'eol-type))
bd882697 515
2e729bfa
JB
516(defun coding-system-eol-type-mnemonic (coding-system)
517 "Return the string indicating end-of-line format of CODING-SYSTEM."
518 (let* ((eol-type (coding-system-eol-type coding-system))
f4f00827 519 (val (cond ((eq eol-type 0) eol-mnemonic-unix)
2e729bfa
JB
520 ((eq eol-type 1) eol-mnemonic-dos)
521 ((eq eol-type 2) eol-mnemonic-mac)
f4f00827 522 (t eol-mnemonic-undecided))))
2e729bfa
JB
523 (if (stringp val)
524 val
525 (char-to-string val))))
526
857ea15c
AS
527(defun coding-system-lessp (x y)
528 (cond ((eq x 'no-conversion) t)
529 ((eq y 'no-conversion) nil)
530 ((eq x 'emacs-mule) t)
531 ((eq y 'emacs-mule) nil)
532 ((eq x 'undecided) t)
533 ((eq y 'undecided) nil)
534 (t (let ((c1 (coding-system-mnemonic x))
535 (c2 (coding-system-mnemonic y)))
536 (or (< (downcase c1) (downcase c2))
537 (and (not (> (downcase c1) (downcase c2)))
538 (< c1 c2)))))))
539
857ea15c 540(defun add-to-coding-system-list (coding-system)
521d4010 541 "Add CODING-SYSTEM to `coding-system-list' while keeping it sorted."
857ea15c
AS
542 (if (or (null coding-system-list)
543 (coding-system-lessp coding-system (car coding-system-list)))
544 (setq coding-system-list (cons coding-system coding-system-list))
545 (let ((len (length coding-system-list))
546 mid (tem coding-system-list))
547 (while (> len 1)
548 (setq mid (nthcdr (/ len 2) tem))
549 (if (coding-system-lessp (car mid) coding-system)
550 (setq tem mid
551 len (- len (/ len 2)))
552 (setq len (/ len 2))))
553 (setcdr tem (cons coding-system (cdr tem))))))
554
80a7463d 555(defun coding-system-list (&optional base-only)
c11a8f77
KH
556 "Return a list of all existing non-subsidiary coding systems.
557If optional arg BASE-ONLY is non-nil, only base coding systems are listed.
558The value doesn't include subsidiary coding systems which are what
559made from bases and aliases automatically for various end-of-line
560formats (e.g. iso-latin-1-unix, koi8-r-dos)."
80a7463d
KH
561 (let* ((codings (copy-sequence coding-system-list))
562 (tail (cons nil codings)))
563 ;; Remove subsidiary coding systems (eol variants) and alias
564 ;; coding systems (if necessary).
565 (while (cdr tail)
566 (let* ((coding (car (cdr tail)))
567 (aliases (coding-system-get coding 'alias-coding-systems)))
568 (if (or
569 ;; CODING is an eol variant if not in ALIASES.
570 (not (memq coding aliases))
571 ;; CODING is an alias if it is not car of ALIASES.
572 (and base-only (not (eq coding (car aliases)))))
573 (setcdr tail (cdr (cdr tail)))
574 (setq tail (cdr tail)))))
575 codings))
576
6fb7766c
DL
577(defun map-charset-chars (func charset)
578 "Use FUNC to map over all characters in CHARSET for side effects.
579FUNC is a function of two args, the start and end (inclusive) of a
580character code range. Thus FUNC should iterate over [START, END]."
581 (let* ((dim (charset-dimension charset))
582 (chars (charset-chars charset))
583 (start (if (= chars 94)
584 33
585 32)))
586 (if (= dim 1)
587 (funcall func
588 (make-char charset start)
589 (make-char charset (+ start chars -1)))
590 (dotimes (i chars)
591 (funcall func
592 (make-char charset (+ i start) start)
593 (make-char charset (+ i start) (+ start chars -1)))))))
594
c11a8f77 595(defun register-char-codings (coding-system safe-chars)
ef6e365d 596 "This is an obsolete function.
620956ca
KH
597It exists just for backward compatibility, and it does nothing.")
598(make-obsolete 'register-char-codings
599 "Unnecessary function. Calling it has no effect."
600 "21.3")
601
602(defconst char-coding-system-table nil
603 "This is an obsolete variable.
604It exists just for backward compatibility, and the value is always nil.")
c11a8f77 605
6e9722b0 606(defun make-subsidiary-coding-system (coding-system)
521d4010 607 "Make subsidiary coding systems (eol-type variants) of CODING-SYSTEM."
0269ddfb
KH
608 (let ((coding-spec (coding-system-spec coding-system))
609 (subsidiaries (vector (intern (format "%s-unix" coding-system))
8057896b
KH
610 (intern (format "%s-dos" coding-system))
611 (intern (format "%s-mac" coding-system))))
0269ddfb
KH
612 (i 0)
613 temp)
8057896b 614 (while (< i 3)
0269ddfb 615 (put (aref subsidiaries i) 'coding-system coding-spec)
8057896b 616 (put (aref subsidiaries i) 'eol-type i)
857ea15c 617 (add-to-coding-system-list (aref subsidiaries i))
0269ddfb
KH
618 (setq coding-system-alist
619 (cons (list (symbol-name (aref subsidiaries i)))
620 coding-system-alist))
8057896b
KH
621 (setq i (1+ i)))
622 subsidiaries))
4ed46869 623
50c29104
KH
624(defun transform-make-coding-system-args (name type &optional doc-string props)
625 "For internal use only.
626Transform XEmacs style args for `make-coding-system' to Emacs style.
627Value is a list of transformed arguments."
628 (let ((mnemonic (string-to-char (or (plist-get props 'mnemonic) "?")))
629 (eol-type (plist-get props 'eol-type))
630 properties tmp)
631 (cond
632 ((eq eol-type 'lf) (setq eol-type 'unix))
633 ((eq eol-type 'crlf) (setq eol-type 'dos))
634 ((eq eol-type 'cr) (setq eol-type 'mac)))
635 (if (setq tmp (plist-get props 'post-read-conversion))
636 (setq properties (plist-put properties 'post-read-conversion tmp)))
637 (if (setq tmp (plist-get props 'pre-write-conversion))
638 (setq properties (plist-put properties 'pre-write-conversion tmp)))
639 (cond
f4a012a6
KH
640 ((eq type 'shift-jis)
641 `(,name 1 ,mnemonic ,doc-string () ,properties ,eol-type))
642 ((eq type 'iso2022) ; This is not perfect.
643 (if (plist-get props 'escape-quoted)
644 (error "escape-quoted is not supported: %S"
645 `(,name ,type ,doc-string ,props)))
646 (let ((g0 (plist-get props 'charset-g0))
647 (g1 (plist-get props 'charset-g1))
648 (g2 (plist-get props 'charset-g2))
649 (g3 (plist-get props 'charset-g3))
650 (use-roman
651 (and
652 (eq (cadr (assoc 'latin-jisx0201
653 (plist-get props 'input-charset-conversion)))
654 'ascii)
655 (eq (cadr (assoc 'ascii
656 (plist-get props 'output-charset-conversion)))
657 'latin-jisx0201)))
658 (use-oldjis
659 (and
660 (eq (cadr (assoc 'japanese-jisx0208-1978
661 (plist-get props 'input-charset-conversion)))
662 'japanese-jisx0208)
663 (eq (cadr (assoc 'japanese-jisx0208
664 (plist-get props 'output-charset-conversion)))
665 'japanese-jisx0208-1978))))
666 (if (charsetp g0)
667 (if (plist-get props 'force-g0-on-output)
668 (setq g0 `(nil ,g0))
669 (setq g0 `(,g0 t))))
670 (if (charsetp g1)
671 (if (plist-get props 'force-g1-on-output)
672 (setq g1 `(nil ,g1))
673 (setq g1 `(,g1 t))))
674 (if (charsetp g2)
675 (if (plist-get props 'force-g2-on-output)
676 (setq g2 `(nil ,g2))
677 (setq g2 `(,g2 t))))
678 (if (charsetp g3)
679 (if (plist-get props 'force-g3-on-output)
680 (setq g3 `(nil ,g3))
681 (setq g3 `(,g3 t))))
682 `(,name 2 ,mnemonic ,doc-string
683 (,g0 ,g1 ,g2 ,g3
684 ,(plist-get props 'short)
685 ,(not (plist-get props 'no-ascii-eol))
686 ,(not (plist-get props 'no-ascii-cntl))
687 ,(plist-get props 'seven)
688 t
689 ,(not (plist-get props 'lock-shift))
690 ,use-roman
691 ,use-oldjis
692 ,(plist-get props 'no-iso6429)
693 nil nil nil nil)
694 ,properties ,eol-type)))
695 ((eq type 'big5)
696 `(,name 3 ,mnemonic ,doc-string () ,properties ,eol-type))
50c29104 697 ((eq type 'ccl)
f4a012a6 698 `(,name 4 ,mnemonic ,doc-string
50c29104 699 (,(plist-get props 'decode) . ,(plist-get props 'encode))
f4a012a6 700 ,properties ,eol-type))
50c29104 701 (t
f4a012a6 702 (error "unsupported XEmacs style make-coding-style arguments: %S"
50c29104
KH
703 `(,name ,type ,doc-string ,props))))))
704
8057896b 705(defun make-coding-system (coding-system type mnemonic doc-string
1b46a680
KH
706 &optional
707 flags
708 properties
709 eol-type)
3bb1accb 710 "Define a new coding system CODING-SYSTEM (symbol).
521d4010 711Remaining arguments are TYPE, MNEMONIC, DOC-STRING, FLAGS (optional),
d9e3229d 712and PROPERTIES (optional) which construct a coding-spec of CODING-SYSTEM
a6acd8a2 713in the following format:
0269ddfb 714 [TYPE MNEMONIC DOC-STRING PLIST FLAGS]
3bb1accb
KH
715
716TYPE is an integer value indicating the type of the coding system as follows:
4ed46869 717 0: Emacs internal format,
d9f6dfe6 718 1: Shift-JIS (or MS-Kanji) used mainly on Japanese PCs,
4ed46869 719 2: ISO-2022 including many variants,
d9f6dfe6 720 3: Big5 used mainly on Chinese PCs,
cd9c3177 721 4: private, CCL programs provide encoding/decoding algorithm,
521d4010 722 5: Raw-text, which means that text contains random 8-bit codes.
0269ddfb 723
3bb1accb 724MNEMONIC is a character to be displayed on mode line for the coding system.
0269ddfb 725
3bb1accb 726DOC-STRING is a documentation string for the coding system.
0269ddfb 727
3bb1accb 728FLAGS specifies more detailed information of the coding system as follows:
d6d6d592 729
3bb1accb 730 If TYPE is 2 (ISO-2022), FLAGS is a list of these elements:
4ed46869
KH
731 CHARSET0, CHARSET1, CHARSET2, CHARSET3, SHORT-FORM,
732 ASCII-EOL, ASCII-CNTL, SEVEN, LOCKING-SHIFT, SINGLE-SHIFT,
d6d6d592 733 USE-ROMAN, USE-OLDJIS, NO-ISO6429, INIT-BOL, DESIGNATION-BOL,
850101ed 734 SAFE, ACCEPT-LATIN-EXTRA-CODE.
4ed46869
KH
735 CHARSETn are character sets initially designated to Gn graphic registers.
736 If CHARSETn is nil, Gn is never used.
737 If CHARSETn is t, Gn can be used but nothing designated initially.
738 If CHARSETn is a list of character sets, those character sets are
739 designated to Gn on output, but nothing designated to Gn initially.
421e3b4e 740 But, character set `ascii' can be designated only to G0.
4ed46869
KH
741 SHORT-FORM non-nil means use short designation sequence on output.
742 ASCII-EOL non-nil means designate ASCII to g0 at end of line on output.
743 ASCII-CNTL non-nil means designate ASCII to g0 before control codes and
744 SPACE on output.
745 SEVEN non-nil means use 7-bit code only on output.
746 LOCKING-SHIFT non-nil means use locking-shift.
747 SINGLE-SHIFT non-nil means use single-shift.
748 USE-ROMAN non-nil means designate JIS0201-1976-Roman instead of ASCII.
749 USE-OLDJIS non-nil means designate JIS0208-1976 instead of JIS0208-1983.
750 NO-ISO6429 non-nil means not use ISO6429's direction specification.
69eba008
KH
751 INIT-BOL non-nil means any designation state is assumed to be reset
752 to initial at each beginning of line on output.
753 DESIGNATION-BOL non-nil means designation sequences should be placed
754 at beginning of line on output.
a6acd8a2 755 SAFE non-nil means convert unsafe characters to `?' on output.
c11a8f77
KH
756 Characters not specified in the property `safe-charsets' nor
757 `safe-chars' are unsafe.
850101ed
RS
758 ACCEPT-LATIN-EXTRA-CODE non-nil means code-detection routine accepts
759 a code specified in `latin-extra-code-table' (which see) as a valid
760 code of the coding system.
d6d6d592 761
3bb1accb
KH
762 If TYPE is 4 (private), FLAGS should be a cons of CCL programs, for
763 decoding and encoding. CCL programs should be specified by their
764 symbols.
d9e3229d 765
a2852e45
KH
766PROPERTIES is an alist of properties vs the corresponding values. The
767following properties are recognized:
768
769 o post-read-conversion
0bca779a 770
a2852e45
KH
771 The value is a function to call after some text is inserted and
772 decoded by the coding system itself and before any functions in
521d4010
DL
773 `after-insert-functions' are called. The argument of this
774 function is the same as for a function in
775 `after-insert-file-functions', i.e. LENGTH of the text inserted,
776 with point at the head of the text to be decoded.
0bca779a 777
a2852e45 778 o pre-write-conversion
0bca779a 779
a2852e45
KH
780 The value is a function to call after all functions in
781 `write-region-annotate-functions' and `buffer-file-format' are
782 called, and before the text is encoded by the coding system itself.
a284eea3
DL
783 The arguments to this function are the same as those of a function
784 in `write-region-annotate-functions', i.e. FROM and TO, specifying
521d4010 785 a region of text.
0bca779a 786
a2852e45 787 o translation-table-for-decode
0bca779a 788
a2852e45
KH
789 The value is a translation table to be applied on decoding. See
790 the function `make-translation-table' for the format of translation
521d4010 791 table. This is not applicable to type 4 (CCL-based) coding systems.
0bca779a 792
a2852e45 793 o translation-table-for-encode
0bca779a 794
521d4010
DL
795 The value is a translation table to be applied on encoding. This is
796 not applicable to type 4 (CCL-based) coding systems.
0bca779a 797
a2852e45 798 o safe-chars
0bca779a 799
a2852e45
KH
800 The value is a char table. If a character has non-nil value in it,
801 the character is safely supported by the coding system. This
802 overrides the specification of safe-charsets.
803
804 o safe-charsets
521d4010 805
a2852e45
KH
806 The value is a list of charsets safely supported by the coding
807 system. The value t means that all charsets Emacs handles are
808 supported. Even if some charset is not in this list, it doesn't
521d4010
DL
809 mean that the charset can't be encoded in the coding system;
810 it just means that some other receiver of text encoded
a2852e45 811 in the coding system won't be able to handle that charset.
0bca779a 812
a2852e45 813 o mime-charset
0bca779a 814
d9f6dfe6 815 The value is a symbol whose name is the `MIME-charset' parameter of
a2852e45 816 the coding system.
0bca779a 817
a2852e45 818 o valid-codes (meaningful only for a coding system based on CCL)
0bca779a 819
a2852e45
KH
820 The value is a list to indicate valid byte ranges of the encoded
821 file. Each element of the list is an integer or a cons of integer.
822 In the former case, the integer value is a valid byte code. In the
6fb7766c 823 latter case, the integers specify the range of valid byte codes.
a2852e45 824
1e7f6327
KH
825 o composition (meaningful only when TYPE is 0 or 2)
826
0ea0b6d2
DL
827 If the value is non-nil, the coding system preserves composition
828 information.
1e7f6327 829
d9e3229d
KH
830These properties are set in PLIST, a property list. This function
831also sets properties `coding-category' and `alias-coding-systems'
832automatically.
4ed46869 833
1b46a680
KH
834EOL-TYPE specifies the EOL type of the coding-system in one of the
835following formats:
836
837 o symbol (unix, dos, or mac)
838
839 The symbol `unix' means Unix-like EOL (LF), `dos' means
840 DOS-like EOL (CRLF), and `mac' means MAC-like EOL (CR).
841
842 o number (0, 1, or 2)
843
844 The number 0, 1, and 2 mean UNIX, DOS, and MAC-like EOL
845 respectively.
846
847 o vector of coding-systems of length 3
848
849 The EOL type is detected automatically for the coding system.
850 And, according to the detected EOL type, one of the coding
851 systems in the vector is selected. Elements of the vector
4d3a9228 852 corresponds to Unix-like EOL, DOS-like EOL, and Mac-like EOL
1b46a680
KH
853 in this order.
854
3bb1accb
KH
855Kludgy features for backward compatibility:
856
8571. If TYPE is 4 and car or cdr of FLAGS is a vector, the vector is
858treated as a compiled CCL code.
859
8602. If PROPERTIES is just a list of character sets, the list is set as
861a value of `safe-charsets' in PLIST."
50c29104
KH
862
863 ;; For compatiblity with XEmacs, we check the type of TYPE. If it
c3d0ee51
EZ
864 ;; is a symbol, perhaps, this function is called with XEmacs-style
865 ;; arguments. Here, try to transform that kind of arguments to
50c29104
KH
866 ;; Emacs style.
867 (if (symbolp type)
868 (let ((args (transform-make-coding-system-args coding-system type
869 mnemonic doc-string)))
870 (setq coding-system (car args)
1053cc93 871 type (nth 1 args)
50c29104
KH
872 mnemonic (nth 2 args)
873 doc-string (nth 3 args)
874 flags (nth 4 args)
875 properties (nth 5 args)
876 eol-type (nth 6 args))))
877
0269ddfb 878 ;; Set a value of `coding-system' property.
6e9722b0 879 (let ((coding-spec (make-vector 5 nil))
d9e3229d
KH
880 (no-initial-designation t)
881 (no-alternative-designation t)
e6cddb1a 882 (accept-latin-extra-code nil)
6e9722b0 883 coding-category)
cd9c3177 884 (if (or (not (integerp type)) (< type 0) (> type 5))
0269ddfb 885 (error "TYPE argument must be 0..5"))
8057896b 886 (if (or (not (integerp mnemonic)) (<= mnemonic ? ) (> mnemonic 127))
521d4010 887 (error "MNEMONIC argument must be an ASCII printable character"))
0269ddfb
KH
888 (aset coding-spec coding-spec-type-idx type)
889 (aset coding-spec coding-spec-mnemonic-idx mnemonic)
890 (aset coding-spec coding-spec-doc-string-idx
e127a722 891 (purecopy (if (stringp doc-string) doc-string "")))
6e9722b0
KH
892 (cond ((= type 0)
893 (setq coding-category 'coding-category-emacs-mule))
894 ((= type 1)
895 (setq coding-category 'coding-category-sjis))
896 ((= type 2) ; ISO2022
4ed46869 897 (let ((i 0)
6e9722b0 898 (vec (make-vector 32 nil))
05134257
KH
899 (g1-designation nil)
900 (fl flags))
4ed46869 901 (while (< i 4)
05134257 902 (let ((charset (car fl)))
6e9722b0
KH
903 (if (and no-initial-designation
904 (> i 0)
905 (or (charsetp charset)
906 (and (consp charset)
907 (charsetp (car charset)))))
908 (setq no-initial-designation nil))
909 (if (charsetp charset)
910 (if (= i 1) (setq g1-designation charset))
911 (if (consp charset)
912 (let ((tail charset)
913 elt)
914 (while tail
915 (setq elt (car tail))
d9e3229d
KH
916 (if (eq elt t)
917 (setq no-alternative-designation nil)
918 (if (and elt (not (charsetp elt)))
919 (error "Invalid charset: %s" elt)))
6e9722b0
KH
920 (setq tail (cdr tail)))
921 (setq g1-designation (car charset)))
d9e3229d
KH
922 (if charset
923 (if (eq charset t)
924 (setq no-alternative-designation nil)
925 (error "Invalid charset: %s" charset)))))
4ed46869 926 (aset vec i charset))
05134257
KH
927 (setq fl (cdr fl) i (1+ i)))
928 (while (and (< i 32) fl)
929 (aset vec i (car fl))
e6cddb1a
KH
930 (if (and (= i 16) ; ACCEPT-LATIN-EXTRA-CODE
931 (car fl))
932 (setq accept-latin-extra-code t))
05134257 933 (setq fl (cdr fl) i (1+ i)))
6e9722b0 934 (aset coding-spec 4 vec)
6e9722b0
KH
935 (setq coding-category
936 (if (aref vec 8) ; Use locking-shift.
dc64cd19
KH
937 (or (and (aref vec 7) 'coding-category-iso-7-else)
938 'coding-category-iso-8-else)
6e9722b0
KH
939 (if (aref vec 7) ; 7-bit only.
940 (if (aref vec 9) ; Use single-shift.
dc64cd19 941 'coding-category-iso-7-else
d9e3229d
KH
942 (if no-alternative-designation
943 'coding-category-iso-7-tight
944 'coding-category-iso-7))
3ad911d8
KH
945 (if (or no-initial-designation
946 (not no-alternative-designation))
dc64cd19 947 'coding-category-iso-8-else
6e9722b0
KH
948 (if (and (charsetp g1-designation)
949 (= (charset-dimension g1-designation) 2))
950 'coding-category-iso-8-2
951 'coding-category-iso-8-1)))))))
952 ((= type 3)
953 (setq coding-category 'coding-category-big5))
954 ((= type 4) ; private
c76b5c99 955 (setq coding-category 'coding-category-ccl)
3bb1accb
KH
956 (if (not (consp flags))
957 (error "Invalid FLAGS argument for TYPE 4 (CCL)")
958 (let ((decoder (check-ccl-program
959 (car flags)
960 (intern (format "%s-decoder" coding-system))))
961 (encoder (check-ccl-program
962 (cdr flags)
963 (intern (format "%s-encoder" coding-system)))))
964 (if (and decoder encoder)
965 (aset coding-spec 4 (cons decoder encoder))
966 (error "Invalid FLAGS argument for TYPE 4 (CCL)")))))
cd9c3177
KH
967 (t ; i.e. (= type 5)
968 (setq coding-category 'coding-category-raw-text)))
0269ddfb
KH
969
970 (let ((plist (list 'coding-category coding-category
d9e3229d 971 'alias-coding-systems (list coding-system))))
0269ddfb 972 (if no-initial-designation
d9e3229d
KH
973 (plist-put plist 'no-initial-designation t))
974 (if (and properties
975 (or (eq properties t)
976 (not (consp (car properties)))))
977 ;; In the old version, the arg PROPERTIES is a list to be
978 ;; set in PLIST as a value of property `safe-charsets'.
c11a8f77
KH
979 (setq properties (list (cons 'safe-charsets properties))))
980 ;; In the current version PROPERTIES is a property list.
981 ;; Reflect it into PLIST one by one while handling safe-chars
982 ;; specially.
983 (let ((safe-charsets (cdr (assq 'safe-charsets properties)))
984 (safe-chars (cdr (assq 'safe-chars properties)))
985 (l properties)
986 prop val)
987 ;; If only safe-charsets is specified, make a char-table from
988 ;; it, and store that char-table as the value of `safe-chars'.
989 (if (and (not safe-chars) safe-charsets)
990 (let (charset)
991 (if (eq safe-charsets t)
992 (setq safe-chars t)
993 (setq safe-chars (make-char-table 'safe-chars))
994 (while safe-charsets
995 (setq charset (car safe-charsets)
996 safe-charsets (cdr safe-charsets))
997 (cond ((eq charset 'ascii)) ; just ignore
998 ((eq charset 'eight-bit-control)
999 (let ((i 128))
1000 (while (< i 160)
1001 (aset safe-chars i t)
1002 (setq i (1+ i)))))
1003 ((eq charset 'eight-bit-graphic)
1004 (let ((i 160))
1005 (while (< i 256)
1006 (aset safe-chars i t)
1007 (setq i (1+ i)))))
1008 (t
e6cddb1a
KH
1009 (aset safe-chars (make-char charset) t))))
1010 (if accept-latin-extra-code
1011 (let ((i 128))
1012 (while (< i 160)
1013 (if (aref latin-extra-code-table i)
1014 (aset safe-chars i t))
1015 (setq i (1+ i))))))
c11a8f77
KH
1016 (setq l (cons (cons 'safe-chars safe-chars) l))))
1017 (while l
1018 (setq prop (car (car l)) val (cdr (car l)) l (cdr l))
1019 (if (eq prop 'safe-chars)
1020 (progn
cc57cc54
KH
1021 (if (and (symbolp val)
1022 (get val 'translation-table))
1023 (setq safe-chars (get val 'translation-table)))
cc57cc54 1024 (setq val safe-chars)))
c11a8f77 1025 (plist-put plist prop val)))
1b46a680
KH
1026 ;; The property `coding-category' may have been set differently
1027 ;; through PROPERTIES.
1028 (setq coding-category (plist-get plist 'coding-category))
0269ddfb 1029 (aset coding-spec coding-spec-plist-idx plist))
6e9722b0 1030 (put coding-system 'coding-system coding-spec)
6e9722b0
KH
1031 (put coding-category 'coding-systems
1032 (cons coding-system (get coding-category 'coding-systems))))
4ed46869 1033
1b46a680 1034 ;; Next, set a value of `eol-type' property.
af873cd1 1035 (if (not eol-type)
1b46a680
KH
1036 ;; If EOL-TYPE is nil, set a vector of subsidiary coding
1037 ;; systems, each corresponds to a coding system for the detected
1038 ;; EOL format.
1039 (setq eol-type (make-subsidiary-coding-system coding-system)))
1040 (setq eol-type
1041 (cond ((or (eq eol-type 'unix) (null eol-type))
1042 0)
1043 ((eq eol-type 'dos)
1044 1)
1045 ((eq eol-type 'mac)
1046 2)
1047 ((or (and (vectorp eol-type)
1048 (= (length eol-type) 3))
1049 (and (numberp eol-type)
1050 (and (>= eol-type 0)
1051 (<= eol-type 2))))
1052 eol-type)
1053 (t
1054 (error "Invalid EOL-TYPE spec:%S" eol-type))))
1055 (put coding-system 'eol-type eol-type)
0269ddfb 1056
620956ca
KH
1057 (define-coding-system-internal coding-system)
1058
0269ddfb
KH
1059 ;; At last, register CODING-SYSTEM in `coding-system-list' and
1060 ;; `coding-system-alist'.
857ea15c 1061 (add-to-coding-system-list coding-system)
0269ddfb 1062 (setq coding-system-alist (cons (list (symbol-name coding-system))
d9e3229d 1063 coding-system-alist))
05134257
KH
1064
1065 ;; For a coding system of cateogory iso-8-1 and iso-8-2, create
1066 ;; XXX-with-esc variants.
1067 (let ((coding-category (coding-system-category coding-system)))
1068 (if (or (eq coding-category 'coding-category-iso-8-1)
1069 (eq coding-category 'coding-category-iso-8-2))
1070 (let ((esc (intern (concat (symbol-name coding-system) "-with-esc")))
c11a8f77
KH
1071 (doc (format "Same as %s but can handle any charsets by ISO's escape sequences." coding-system))
1072 (safe-charsets (assq 'safe-charsets properties))
1073 (mime-charset (assq 'mime-charset properties)))
1074 (if safe-charsets
1075 (setcdr safe-charsets t)
1076 (setq properties (cons (cons 'safe-charsets t) properties)))
1077 (if mime-charset
1078 (setcdr mime-charset nil))
05134257
KH
1079 (make-coding-system esc type mnemonic doc
1080 (if (listp (car flags))
1081 (cons (append (car flags) '(t)) (cdr flags))
1082 (cons (list (car flags) t) (cdr flags)))
c11a8f77 1083 properties))))
05134257 1084
d9e3229d 1085 coding-system)
8057896b 1086
5470d5b6
KH
1087(put 'safe-chars 'char-table-extra-slots 0)
1088
a42763dc 1089(defun define-coding-system-alias (alias coding-system)
358d28fb 1090 "Define ALIAS as an alias for coding system CODING-SYSTEM."
0269ddfb 1091 (put alias 'coding-system (coding-system-spec coding-system))
857ea15c 1092 (add-to-coding-system-list alias)
0269ddfb
KH
1093 (setq coding-system-alist (cons (list (symbol-name alias))
1094 coding-system-alist))
1095 (let ((eol-type (coding-system-eol-type coding-system)))
1096 (if (vectorp eol-type)
708fc465
KH
1097 (progn
1098 (nconc (coding-system-get alias 'alias-coding-systems) (list alias))
1099 (put alias 'eol-type (make-subsidiary-coding-system alias)))
0269ddfb 1100 (put alias 'eol-type eol-type))))
4ed46869 1101
bbdea948
RS
1102(defun merge-coding-systems (first second)
1103 "Fill in any unspecified aspects of coding system FIRST from SECOND.
1104Return the resulting coding system."
1105 (let ((base (coding-system-base second))
1106 (eol (coding-system-eol-type second)))
1107 ;; If FIRST doesn't specify text conversion, merge with that of SECOND.
1108 (if (eq (coding-system-base first) 'undecided)
1109 (setq first (coding-system-change-text-conversion first base)))
1110 ;; If FIRST doesn't specify eol conversion, merge with that of SECOND.
1111 (if (and (vectorp (coding-system-eol-type first))
1112 (numberp eol) (>= eol 0) (<= eol 2))
1113 (setq first (coding-system-change-eol-conversion
1114 first eol)))
1115 first))
1116
4ed46869 1117(defun set-buffer-file-coding-system (coding-system &optional force)
358d28fb
RS
1118 "Set the file coding-system of the current buffer to CODING-SYSTEM.
1119This means that when you save the buffer, it will be converted
1120according to CODING-SYSTEM. For a list of possible values of CODING-SYSTEM,
1121use \\[list-coding-systems].
1122
bbdea948
RS
1123If CODING-SYSTEM leaves the text conversion unspecified, or if it
1124leaves the end-of-line conversion unspecified, FORCE controls what to
1125do. If FORCE is nil, get the unspecified aspect (or aspects) from the
1126buffer's previous `buffer-file-coding-system' value (if it is
1127specified there). Otherwise, levae it unspecified.
aeef8f07
KH
1128
1129This marks the buffer modified so that the succeeding \\[save-buffer]
1130surely saves the buffer with CODING-SYSTEM. From a program, if you
1131don't want to mark the buffer modified, just set the variable
1132`buffer-file-coding-system' directly."
bbdea948 1133 (interactive "zCoding system for saving file (default, nil): \nP")
4ed46869 1134 (check-coding-system coding-system)
36d455c4 1135 (if (and coding-system buffer-file-coding-system (null force))
bbdea948
RS
1136 (setq coding-system
1137 (merge-coding-systems coding-system buffer-file-coding-system)))
4ed46869 1138 (setq buffer-file-coding-system coding-system)
38a1356d
RS
1139 ;; This is in case of an explicit call. Normally, `normal-mode' and
1140 ;; `set-buffer-major-mode-hook' take care of setting the table.
1141 (if (fboundp 'ucs-set-table-for-input) ; don't lose when building
1142 (ucs-set-table-for-input))
4ed46869
KH
1143 (set-buffer-modified-p t)
1144 (force-mode-line-update))
1145
bbdea948
RS
1146(defun revert-buffer-with-coding-system (coding-system &optional force)
1147 "Visit the current buffer's file again using coding system CODING-SYSTEM.
1148For a list of possible values of CODING-SYSTEM, use \\[list-coding-systems].
1149
1150If CODING-SYSTEM leaves the text conversion unspecified, or if it
1151leaves the end-of-line conversion unspecified, FORCE controls what to
1152do. If FORCE is nil, get the unspecified aspect (or aspects) from the
1153buffer's previous `buffer-file-coding-system' value (if it is
1154specified there). Otherwise, determine it from the file contents as
1155usual for visiting a file."
1156 (interactive "zCoding system for visited file (default, nil): \nP")
1157 (check-coding-system coding-system)
1158 (if (and coding-system buffer-file-coding-system (null force))
1159 (setq coding-system
1160 (merge-coding-systems coding-system buffer-file-coding-system)))
1161 (let ((coding-system-for-read coding-system))
1162 (revert-buffer)))
1163
701414e3
KH
1164(defun set-file-name-coding-system (coding-system)
1165 "Set coding system for decoding and encoding file names to CODING-SYSTEM.
1166It actually just set the variable `file-name-coding-system' (which
1167see) to CODING-SYSTEM."
1168 (interactive "zCoding system for file names (default, nil): ")
1169 (check-coding-system coding-system)
1170 (setq file-name-coding-system coding-system))
1171
358d28fb
RS
1172(defvar default-terminal-coding-system nil
1173 "Default value for the terminal coding system.
1174This is normally set according to the selected language environment.
1175See also the command `set-terminal-coding-system'.")
1176
df100398
KH
1177(defun set-terminal-coding-system (coding-system)
1178 "Set coding system of your terminal to CODING-SYSTEM.
358d28fb
RS
1179All text output to the terminal will be encoded
1180with the specified coding system.
1181For a list of possible values of CODING-SYSTEM, use \\[list-coding-systems].
1182The default is determined by the selected language environment
1183or by the previous use of this command."
1184 (interactive
2e02a76f
RS
1185 (list (let ((default (if (and (not (terminal-coding-system))
1186 default-terminal-coding-system)
1187 default-terminal-coding-system)))
1188 (read-coding-system
1189 (format "Coding system for terminal display (default, %s): "
1190 default)
1191 default))))
358d28fb
RS
1192 (if (and (not coding-system)
1193 (not (terminal-coding-system)))
1194 (setq coding-system default-terminal-coding-system))
1195 (if coding-system
521d4010 1196 (setq default-terminal-coding-system coding-system))
df100398
KH
1197 (set-terminal-coding-system-internal coding-system)
1198 (redraw-frame (selected-frame)))
1199
358d28fb
RS
1200(defvar default-keyboard-coding-system nil
1201 "Default value of the keyboard coding system.
1202This is normally set according to the selected language environment.
1203See also the command `set-keyboard-coding-system'.")
1204
df100398 1205(defun set-keyboard-coding-system (coding-system)
358d28fb
RS
1206 "Set coding system for keyboard input to CODING-SYSTEM.
1207In addition, this command enables Encoded-kbd minor mode.
6d34f495
DL
1208\(If CODING-SYSTEM is nil, Encoded-kbd mode is turned off -- see
1209`encoded-kbd-mode'.)
358d28fb
RS
1210For a list of possible values of CODING-SYSTEM, use \\[list-coding-systems].
1211The default is determined by the selected language environment
1212or by the previous use of this command."
1213 (interactive
2e02a76f
RS
1214 (list (let ((default (if (and (not (keyboard-coding-system))
1215 default-keyboard-coding-system)
1216 default-keyboard-coding-system)))
1217 (read-coding-system
1218 (format "Coding system for keyboard input (default, %s): "
1219 default)
1220 default))))
358d28fb
RS
1221 (if (and (not coding-system)
1222 (not (keyboard-coding-system)))
1223 (setq coding-system default-keyboard-coding-system))
1224 (if coding-system
1225 (setq default-keyboard-coding-system coding-system))
df100398 1226 (set-keyboard-coding-system-internal coding-system)
b23bad0b 1227 (setq keyboard-coding-system coding-system)
df100398
KH
1228 (encoded-kbd-mode (if coding-system 1 0)))
1229
6d34f495
DL
1230(defcustom keyboard-coding-system nil
1231 "Specify coding system for keyboard input.
1232If you set this on a terminal which can't distinguish Meta keys from
12338-bit characters, you will have to use ESC to type Meta characters.
1234See Info node `Specify Coding' and Info node `Single-Byte Character Support'.
1235
237e5993
DL
1236On non-windowing terminals, this is set from the locale by default.
1237
6d34f495
DL
1238Setting this variable directly does not take effect;
1239use either M-x customize or \\[set-keyboard-coding-system]."
1240 :type '(coding-system :tag "Coding system")
1241 :link '(info-link "(emacs)Specify Coding")
1242 :link '(info-link "(emacs)Single-Byte Character Support")
1243 :set (lambda (symbol value)
1244 ;; Don't load encoded-kbd-mode unnecessarily.
1245 (if (or value (boundp 'encoded-kbd-mode))
1246 (set-keyboard-coding-system value)
1247 (set-default 'keyboard-coding-system nil))) ; must initialize
237e5993 1248 :version "21.4"
6d34f495
DL
1249 :group 'keyboard
1250 :group 'mule)
1251
df100398 1252(defun set-buffer-process-coding-system (decoding encoding)
358d28fb 1253 "Set coding systems for the process associated with the current buffer.
df100398 1254DECODING is the coding system to be used to decode input from the process,
358d28fb
RS
1255ENCODING is the coding system to be used to encode output to the process.
1256
1257For a list of possible values of CODING-SYSTEM, use \\[list-coding-systems]."
4ed46869 1258 (interactive
83911021 1259 "zCoding-system for output from the process: \nzCoding-system for input to the process: ")
4ed46869
KH
1260 (let ((proc (get-buffer-process (current-buffer))))
1261 (if (null proc)
521d4010 1262 (error "No process")
df100398
KH
1263 (check-coding-system decoding)
1264 (check-coding-system encoding)
1265 (set-process-coding-system proc decoding encoding)))
4ed46869
KH
1266 (force-mode-line-update))
1267
d0b99881
RS
1268(defalias 'set-clipboard-coding-system 'set-selection-coding-system)
1269
14915c37 1270(defun set-selection-coding-system (coding-system)
8c52d564 1271 "Make CODING-SYSTEM used for communicating with other X clients.
b25eef20
KH
1272When sending or receiving text via cut_buffer, selection, and clipboard,
1273the text is encoded or decoded by CODING-SYSTEM."
a03b3ce1 1274 (interactive "zCoding system for X selection: ")
b25eef20 1275 (check-coding-system coding-system)
14915c37 1276 (setq selection-coding-system coding-system))
b25eef20 1277
e8dd0160 1278;; Coding system lastly specified by the command
a03b3ce1
KH
1279;; set-next-selection-coding-system.
1280(defvar last-next-selection-coding-system nil)
1281
1282(defun set-next-selection-coding-system (coding-system)
1283 "Make CODING-SYSTEM used for the next communication with other X clients.
1284This setting is effective for the next communication only."
1285 (interactive
1286 (list (read-coding-system
1287 (if last-next-selection-coding-system
1288 (format "Coding system for the next X selection (default, %S): "
1289 last-next-selection-coding-system)
1290 "Coding system for the next X selection: ")
1291 last-next-selection-coding-system)))
1292 (if coding-system
1293 (setq last-next-selection-coding-system coding-system)
1294 (setq coding-system last-next-selection-coding-system))
1295 (check-coding-system coding-system)
1296
1297 (setq next-selection-coding-system coding-system))
1298
4ed46869 1299(defun set-coding-priority (arg)
521d4010
DL
1300 "Set priority of coding categories according to ARG.
1301ARG is a list of coding categories ordered by priority."
d9e3229d
KH
1302 (let ((l arg)
1303 (current-list (copy-sequence coding-category-list)))
e8dd0160 1304 ;; Check the validity of ARG while deleting coding categories in
d9e3229d
KH
1305 ;; ARG from CURRENT-LIST. We assume that CODING-CATEGORY-LIST
1306 ;; contains all coding categories.
1307 (while l
1308 (if (or (null (get (car l) 'coding-category-index))
1309 (null (memq (car l) current-list)))
1310 (error "Invalid or duplicated element in argument: %s" arg))
1311 (setq current-list (delq (car l) current-list))
1312 (setq l (cdr l)))
4ed46869 1313 ;; Update `coding-category-list' and return it.
2feaf204
KH
1314 (setq coding-category-list (append arg current-list))
1315 (set-coding-priority-internal)))
4ed46869 1316
835cbadb
EZ
1317;;; X selections
1318
1319(defvar non-standard-icccm-encodings-alist
1320 '(("ISO8859-15" . latin-iso8859-15)
1321 ("ISO8859-14" . latin-iso8859-14)
1322 ("KOI8-R" . koi8-r)
1323 ("BIG5-0" . big5))
7f1cdd46
RS
1324 "Alist of font charset names defined by XLFD.
1325The cdr of each element is the corresponding Emacs charset or coding system.")
835cbadb
EZ
1326
1327;; Functions to support "Non-Standard Character Set Encodings" defined
5c88a01e
KH
1328;; by the COMPOUND-TEXT spec.
1329;; We support that by converting the leading sequence of the
1330;; ``extended segment'' to the corresponding ISO-2022 sequences (if
1331;; the leading sequence names an Emacs charset), or decode the segment
1332;; (if it names a coding system). Encoding does the reverse.
1333;; This function also supports "The UTF-8 encoding" described in the
1334;; section 7 of the documentation fo COMPOUND-TEXT distributed with
1335;; XFree86.
1336
835cbadb
EZ
1337(defun ctext-post-read-conversion (len)
1338 "Decode LEN characters encoded as Compound Text with Extended Segments."
1339 (buffer-disable-undo) ; minimize consing due to insertions and deletions
1340 (narrow-to-region (point) (+ (point) len))
1341 (save-match-data
1342 (let ((pt (point-marker))
1343 (oldpt (point-marker))
1344 (newpt (make-marker))
1345 (modified-p (buffer-modified-p))
1346 (case-fold-search nil)
58b8be1c
KH
1347 ;; We need multibyte conversion of "TO" type because the
1348 ;; buffer may be multibyte, and, in that case, the pattern
1349 ;; must contain eight-bit-control/graphic characters.
1350 (pattern (string-to-multibyte "\\(\e\\)%/[0-4]\\([\200-\377][\200-\377]\\)\\([^\002]+\\)\002\\|\e%G[^\e]+\e%@"))
835cbadb
EZ
1351 last-coding-system-used
1352 encoding textlen chset)
58b8be1c 1353 (while (re-search-forward pattern nil 'move)
835cbadb
EZ
1354 (set-marker newpt (point))
1355 (set-marker pt (match-beginning 0))
5c88a01e
KH
1356 (if (= (preceding-char) ?@)
1357 ;; We found embedded utf-8 sequence.
1358 (progn
1359 (delete-char -3) ; delete ESC % @ at the tail
1360 (goto-char pt)
1361 (delete-char 3) ; delete ESC % G at the head
1362 (if (> pt oldpt)
1363 (decode-coding-region oldpt pt 'ctext-no-compositions))
1364 (decode-coding-region pt newpt 'mule-utf-8)
1365 (goto-char newpt)
1366 (set-marker oldpt newpt))
1367 (setq encoding (match-string 3))
1368 (setq textlen (- (+ (* (- (aref (match-string 2) 0) 128) 128)
1369 (- (aref (match-string 2) 1) 128))
1370 (1+ (length encoding))))
1371 (setq
1372 chset (cdr (assoc-ignore-case encoding
1373 non-standard-icccm-encodings-alist)))
1374 (cond ((null chset)
1375 ;; This charset is not supported--leave this extended
1376 ;; segment unaltered and skip over it.
1377 (goto-char (+ (point) textlen)))
1378 ((charsetp chset)
1379 ;; If it's a charset, replace the leading escape sequence
1380 ;; with a standard ISO-2022 sequence. We will decode all
1381 ;; such segments later, in one go, when we exit the loop
1382 ;; or find an extended segment that names a coding
1383 ;; system, not a charset.
1384 (replace-match
1385 (concat "\\1"
1386 (if (= 0 (charset-iso-graphic-plane chset))
1387 ;; GL charsets
1388 (if (= 1 (charset-dimension chset)) "(" "$(")
1389 ;; GR charsets
1390 (if (= 96 (charset-chars chset))
1391 "-"
1392 (if (= 1 (charset-dimension chset)) ")" "$)")))
1393 (string (charset-iso-final-char chset)))
1394 t)
1395 (goto-char (+ (point) textlen)))
1396 ((coding-system-p chset)
1397 ;; If it's a coding system, we need to decode the segment
1398 ;; right away. But first, decode what we've skipped
1399 ;; across until now.
1400 (when (> pt oldpt)
1401 (decode-coding-region oldpt pt 'ctext-no-compositions))
1402 (delete-region pt newpt)
1403 (set-marker newpt (+ newpt textlen))
1404 (decode-coding-region pt newpt chset)
1405 (goto-char newpt)
1406 (set-marker oldpt newpt)))))
835cbadb
EZ
1407 ;; Decode what's left.
1408 (when (> (point) oldpt)
1409 (decode-coding-region oldpt (point) 'ctext-no-compositions))
5c88a01e 1410 ;; This buffer started as unibyte, because the string we get from
835cbadb
EZ
1411 ;; the X selection is a unibyte string. We must now make it
1412 ;; multibyte, so that the decoded text is inserted as multibyte
1413 ;; into its buffer.
1414 (set-buffer-multibyte t)
1415 (set-buffer-modified-p modified-p)
1416 (- (point-max) (point-min)))))
1417
c74fe809
EZ
1418;; If you add charsets here, be sure to modify the regexp used by
1419;; ctext-pre-write-conversion to look up non-standard charsets.
835cbadb
EZ
1420(defvar non-standard-designations-alist
1421 '(("$(0" . (big5 "big5-0" 2))
1422 ("$(1" . (big5 "big5-0" 2))
eb747e41
DL
1423 ;; The following are actually standard; generating extended
1424 ;; segments for them is wrong and screws e.g. Latin-9 users.
1425 ;; 8859-{10,13,16} aren't Emacs charsets anyhow. -- fx
1426;; ("-V" . (t "iso8859-10" 1))
1427;; ("-Y" . (t "iso8859-13" 1))
1428;; ("-_" . (t "iso8859-14" 1))
1429;; ("-b" . (t "iso8859-15" 1))
1430;; ("-f" . (t "iso8859-16" 1))
1431 )
835cbadb 1432 "Alist of ctext control sequences that introduce character sets which
eb747e41 1433are not in the list of approved encodings, and the corresponding
835cbadb
EZ
1434coding system, identifier string, and number of octets per encoded
1435character.
1436
1437Each element has the form (CTLSEQ . (ENCODING CHARSET NOCTETS)). CTLSEQ
1438is the control sequence (sans the leading ESC) that introduces the character
1439set in the text encoded by compound-text. ENCODING is a coding system
1440symbol; if it is t, it means that the ctext coding system already encodes
1441the text correctly, and only the leading control sequence needs to be altered.
1442If ENCODING is a coding system, we need to re-encode the text with that
eb747e41 1443coding system. CHARSET is the name of the charset we need to put into
835cbadb
EZ
1444the leading control sequence. NOCTETS is the number of octets (bytes) that
1445encode each character in this charset. NOCTETS can be 0 (meaning the number
1446of octets per character is variable), 1, 2, 3, or 4.")
1447
1448(defun ctext-pre-write-conversion (from to)
5dde3c71
EZ
1449 "Encode characters between FROM and TO as Compound Text w/Extended Segments.
1450
1451If FROM is a string, or if the current buffer is not the one set up for us
1452by run_pre_post_conversion_on_str, generate a new temp buffer, insert the
1453text, and convert it in the temporary buffer. Otherwise, convert in-place."
1454 (cond ((and (string= (buffer-name) " *code-converting-work*")
1455 (not (stringp from)))
1456 ; Minimize consing due to subsequent insertions and deletions.
1457 (buffer-disable-undo)
1458 (narrow-to-region from to))
1459 (t
1460 (let ((buf (current-buffer)))
1461 (set-buffer (generate-new-buffer " *temp"))
1462 (buffer-disable-undo)
1463 (if (stringp from)
1464 (insert from)
c74fe809
EZ
1465 (insert-buffer-substring buf from to))
1466 (setq from (point-min) to (point-max)))))
835cbadb
EZ
1467 (encode-coding-region from to 'ctext-no-compositions)
1468 ;; Replace ISO-2022 charset designations with extended segments, for
1469 ;; those charsets that are not part of the official X registry.
1470 (save-match-data
1471 (goto-char (point-min))
1472 (let ((newpt (make-marker))
1473 (case-fold-search nil)
1474 pt desig encode-info encoding chset noctets textlen)
1475 (set-buffer-multibyte nil)
eb747e41
DL
1476 ;; The regexp below finds the leading sequences for big5.
1477 (while (re-search-forward "\e\\(\$([01]\\)" nil 'move)
835cbadb
EZ
1478 (setq desig (match-string 1)
1479 pt (point-marker)
1480 encode-info (cdr (assoc desig non-standard-designations-alist))
1481 encoding (car encode-info)
1482 chset (cadr encode-info)
1483 noctets (car (cddr encode-info)))
1484 (skip-chars-forward "^\e")
1485 (set-marker newpt (point))
1486 (cond
1487 ((eq encoding t) ; only the leading sequence needs to be changed
1488 (setq textlen (+ (- newpt pt) (length chset) 1))
5dde3c71 1489 ;; Generate the ICCCM control sequence for an extended segment.
835cbadb
EZ
1490 (replace-match (format "\e%%/%d%c%c%s\ 2"
1491 noctets
1492 (+ (/ textlen 128) 128)
1493 (+ (% textlen 128) 128)
1494 chset)
1495 t t))
1496 ((coding-system-p encoding) ; need to recode the entire segment...
1497 (set-marker pt (match-beginning 0))
1498 (decode-coding-region pt newpt 'ctext-no-compositions)
1499 (set-buffer-multibyte t)
1500 (encode-coding-region pt newpt encoding)
1501 (set-buffer-multibyte nil)
1502 (setq textlen (+ (- newpt pt) (length chset) 1))
1503 (goto-char pt)
1504 (insert (format "\e%%/%d%c%c%s\ 2"
1505 noctets
1506 (+ (/ textlen 128) 128)
1507 (+ (% textlen 128) 128)
1508 chset))))
1509 (goto-char newpt))))
1510 (set-buffer-multibyte t)
5dde3c71 1511 ;; Must return nil, as build_annotations_2 expects that.
835cbadb
EZ
1512 nil)
1513
4ed46869
KH
1514;;; FILE I/O
1515
e76938e7 1516(defcustom auto-coding-alist
0bca779a 1517 '(("\\.\\(arc\\|zip\\|lzh\\|zoo\\|jar\\|sx[dmicw]\\|tar\\|tgz\\)\\'" . no-conversion)
6caef2da 1518 ("\\.\\(gz\\|Z\\|bz\\|bz2\\|gpg\\)\\'" . no-conversion)
45885400 1519 ("/#[^/]+#\\'" . emacs-mule))
835f49b8
KH
1520 "Alist of filename patterns vs corresponding coding systems.
1521Each element looks like (REGEXP . CODING-SYSTEM).
558b0c86 1522A file whose name matches REGEXP is decoded by CODING-SYSTEM on reading.
835f49b8 1523
7fed493a
RS
1524The settings in this alist take priority over `coding:' tags
1525in the file (see the function `set-auto-coding')
e76938e7
DL
1526and the contents of `file-coding-system-alist'."
1527 :group 'files
1528 :group 'mule
1529 :type '(repeat (cons (regexp :tag "File name regexp")
1530 (symbol :tag "Coding system"))))
835f49b8 1531
502522b2
GM
1532(defcustom auto-coding-regexp-alist
1533 '(("^BABYL OPTIONS:[ \t]*-\\*-[ \t]*rmail[ \t]*-\\*-" . no-conversion))
1534 "Alist of patterns vs corresponding coding systems.
1535Each element looks like (REGEXP . CODING-SYSTEM).
1536A file whose first bytes match REGEXP is decoded by CODING-SYSTEM on reading.
1537
1538The settings in this alist take priority over `coding:' tags
1539in the file (see the function `set-auto-coding')
1540and the contents of `file-coding-system-alist'."
1541 :group 'files
1542 :group 'mule
1543 :type '(repeat (cons (regexp :tag "Regexp")
1544 (symbol :tag "Coding system"))))
1545
d9f6dfe6 1546;; See the bottom of this file for built-in auto coding functions.
447404a3
CW
1547(defcustom auto-coding-functions '(sgml-xml-auto-coding-function
1548 sgml-html-meta-auto-coding-function)
d9f6dfe6
CW
1549 "A list of functions which attempt to determine a coding system.
1550
1551Each function in this list should be written to operate on the current
1552buffer, but should not modify it in any way. It should take one
1553argument SIZE, past which it should not search. If a function
1554succeeds in determining a coding system, it should return that coding
1555system. Otherwise, it should return nil.
1556
447404a3
CW
1557Any `coding:' tags present have a higher priority than the
1558functions in this list."
d9f6dfe6
CW
1559 :group 'files
1560 :group 'mule
1561 :type '(repeat function))
1562
1c4cc63a
KH
1563(defvar set-auto-coding-for-load nil
1564 "Non-nil means look for `load-coding' property instead of `coding'.
1565This is used for loading and byte-compiling Emacs Lisp files.")
1566
8a592131
RS
1567(defun auto-coding-alist-lookup (filename)
1568 "Return the coding system specified by `auto-coding-alist' for FILENAME."
1569 (let ((alist auto-coding-alist)
c60ee5e7 1570 (case-fold-search (memq system-type '(vax-vms windows-nt ms-dos cygwin)))
8a592131
RS
1571 coding-system)
1572 (while (and alist (not coding-system))
1573 (if (string-match (car (car alist)) filename)
1574 (setq coding-system (cdr (car alist)))
1575 (setq alist (cdr alist))))
1576 coding-system))
1577
835f49b8
KH
1578(defun set-auto-coding (filename size)
1579 "Return coding system for a file FILENAME of which SIZE bytes follow point.
1c4cc63a
KH
1580These bytes should include at least the first 1k of the file
1581and the last 3k of the file, but the middle may be omitted.
63561304 1582
d21ba5e0
DL
1583The function checks FILENAME against the variable `auto-coding-alist'.
1584If FILENAME doesn't match any entries in the variable, it checks the
502522b2 1585contents of the current buffer following point against
447404a3 1586`auto-coding-regexp-alist'. If no match is found, it checks for a
502522b2 1587`coding:' tag in the first one or two lines following point. If no
d21ba5e0 1588`coding:' tag is found, it checks any local variables list in the last
447404a3 15893K bytes out of the SIZE bytes. Finally, if none of these methods
d21ba5e0
DL
1590succeed, it checks to see if any function in `auto-coding-functions'
1591gives a match.
63561304 1592
d21ba5e0
DL
1593The return value is the specified coding system, or nil if nothing is
1594specified.
87aba788 1595
ba74e833 1596The variable `set-auto-coding-function' (which see) is set to this
87aba788 1597function by default."
502522b2 1598 (or (auto-coding-alist-lookup filename)
447404a3
CW
1599 ;; Try using `auto-coding-regexp-alist'.
1600 (save-excursion
1601 (let ((alist auto-coding-regexp-alist)
1602 coding-system)
1603 (while (and alist (not coding-system))
1604 (let ((regexp (car (car alist))))
1605 (when (re-search-forward regexp (+ (point) size) t)
1606 (setq coding-system (cdr (car alist)))))
0bca779a 1607 (setq alist (cdr alist)))
447404a3 1608 coding-system))
502522b2
GM
1609 (let* ((case-fold-search t)
1610 (head-start (point))
1611 (head-end (+ head-start (min size 1024)))
1612 (tail-start (+ head-start (max (- size 3072) 0)))
1613 (tail-end (+ head-start size))
1614 coding-system head-found tail-found pos)
1615 ;; Try a short cut by searching for the string "coding:"
1616 ;; and for "unibyte:" at the head and tail of SIZE bytes.
1617 (setq head-found (or (search-forward "coding:" head-end t)
1618 (search-forward "unibyte:" head-end t)))
1619 (if (and head-found (> head-found tail-start))
1620 ;; Head and tail are overlapped.
1621 (setq tail-found head-found)
1622 (goto-char tail-start)
1623 (setq tail-found (or (search-forward "coding:" tail-end t)
1624 (search-forward "unibyte:" tail-end t))))
1625
1626 ;; At first check the head.
1627 (when head-found
1628 (goto-char head-start)
6b66d028
RS
1629 (setq head-end (set-auto-mode-1))
1630 (setq head-start (point))
1d8e9a7c 1631 (when (and head-end (< head-found head-end))
835f49b8 1632 (goto-char head-start)
502522b2
GM
1633 (when (and set-auto-coding-for-load
1634 (re-search-forward
6b66d028 1635 "\\(.*;\\)?[ \t]*unibyte:[ \t]*\\([^ ;]+\\)"
502522b2
GM
1636 head-end t))
1637 (setq coding-system 'raw-text))
1638 (when (and (not coding-system)
1639 (re-search-forward
6b66d028 1640 "\\(.*;\\)?[ \t]*coding:[ \t]*\\([^ ;]+\\)"
502522b2
GM
1641 head-end t))
1642 (setq coding-system (intern (match-string 2)))
1643 (or (coding-system-p coding-system)
1644 (setq coding-system nil)))))
1645
1646 ;; If no coding: tag in the head, check the tail.
1647 (when (and tail-found (not coding-system))
1648 (goto-char tail-start)
1649 (search-forward "\n\^L" nil t)
1650 (if (re-search-forward
1651 "^\\(.*\\)[ \t]*Local Variables:[ \t]*\\(.*\\)$" tail-end t)
1652 ;; The prefix is what comes before "local variables:" in its
1653 ;; line. The suffix is what comes after "local variables:"
1654 ;; in its line.
1655 (let* ((prefix (regexp-quote (match-string 1)))
1656 (suffix (regexp-quote (match-string 2)))
1657 (re-coding
1658 (concat
1659 "^" prefix
cfe98f50
GM
1660 ;; N.B. without the \n below, the regexp can
1661 ;; eat newlines.
1662 "[ \t]*coding[ \t]*:[ \t]*\\([^ \t\n]+\\)[ \t]*"
502522b2
GM
1663 suffix "$"))
1664 (re-unibyte
1665 (concat
1666 "^" prefix
cfe98f50 1667 "[ \t]*unibyte[ \t]*:[ \t]*\\([^ \t\n]+\\)[ \t]*"
502522b2
GM
1668 suffix "$"))
1669 (re-end
cfe98f50 1670 (concat "^" prefix "[ \t]*End *:[ \t]*" suffix "$"))
502522b2
GM
1671 (pos (point)))
1672 (re-search-forward re-end tail-end 'move)
1673 (setq tail-end (point))
1674 (goto-char pos)
1675 (when (and set-auto-coding-for-load
1676 (re-search-forward re-unibyte tail-end t))
1677 (setq coding-system 'raw-text))
1678 (when (and (not coding-system)
1679 (re-search-forward re-coding tail-end t))
1680 (setq coding-system (intern (match-string 1)))
1681 (or (coding-system-p coding-system)
1682 (setq coding-system nil))))))
447404a3
CW
1683 coding-system)
1684 ;; Finally, try all the `auto-coding-functions'.
1685 (let ((funcs auto-coding-functions)
1686 (coding-system nil))
1687 (while (and funcs (not coding-system))
1688 (setq coding-system (condition-case e
1689 (save-excursion
1690 (goto-char (point-min))
1691 (funcall (pop funcs) size))
1692 (error nil))))
502522b2 1693 coding-system)))
63561304
KH
1694
1695(setq set-auto-coding-function 'set-auto-coding)
87aba788 1696
4ed46869 1697(defun after-insert-file-set-buffer-file-coding-system (inserted)
521d4010 1698 "Set `buffer-file-coding-system' of current buffer after text is inserted."
4ed46869
KH
1699 (if last-coding-system-used
1700 (let ((coding-system
1701 (find-new-buffer-file-coding-system last-coding-system-used))
1702 (modified-p (buffer-modified-p)))
0269ddfb 1703 (when coding-system
71983219 1704 (set-buffer-file-coding-system coding-system t)
d0c26c63
KH
1705 (if (and enable-multibyte-characters
1706 (or (eq coding-system 'no-conversion)
ccb77b4e 1707 (eq (coding-system-type coding-system) 5))
136e48e4
KH
1708 ;; If buffer was unmodified and the size is the
1709 ;; same as INSERTED, we must be visiting it.
1710 (not modified-p)
1711 (= (buffer-size) inserted))
ccb77b4e
RS
1712 ;; For coding systems no-conversion and raw-text...,
1713 ;; edit the buffer as unibyte.
d0c26c63
KH
1714 (let ((pos-byte (position-bytes (+ (point) inserted))))
1715 (set-buffer-multibyte nil)
1716 (setq inserted (- pos-byte (position-bytes (point))))))
0269ddfb 1717 (set-buffer-modified-p modified-p))))
d0c26c63 1718 inserted)
4ed46869 1719
8d1d818a
KH
1720(setq after-insert-file-adjust-coding-function
1721 'after-insert-file-set-buffer-file-coding-system)
4ed46869 1722
8057896b 1723;; The coding-spec and eol-type of coding-system returned is decided
4ed46869
KH
1724;; independently in the following order.
1725;; 1. That of buffer-file-coding-system locally bound.
1726;; 2. That of CODING.
1727
1728(defun find-new-buffer-file-coding-system (coding)
1729 "Return a coding system for a buffer when a file of CODING is inserted.
a73a8c89
KH
1730The local variable `buffer-file-coding-system' of the current buffer
1731is set to the returned value.
509064c5 1732Return nil if there's no need to set `buffer-file-coding-system'."
4ed46869 1733 (let (local-coding local-eol
b685f8d6 1734 found-coding found-eol
4ed46869
KH
1735 new-coding new-eol)
1736 (if (null coding)
1737 ;; Nothing found about coding.
1738 nil
1739
b685f8d6
RS
1740 ;; Get information of `buffer-file-coding-system' in LOCAL-EOL
1741 ;; and LOCAL-CODING.
1742 (setq local-eol (coding-system-eol-type buffer-file-coding-system))
1743 (if (null (numberp local-eol))
1744 ;; But eol-type is not yet set.
1745 (setq local-eol nil))
0269ddfb
KH
1746 (if (and buffer-file-coding-system
1747 (not (eq (coding-system-type buffer-file-coding-system) t)))
1748 ;; This is not `undecided'.
1749 (setq local-coding (coding-system-base buffer-file-coding-system)))
b685f8d6
RS
1750
1751 (if (and (local-variable-p 'buffer-file-coding-system)
1752 local-eol local-coding)
4ed46869
KH
1753 ;; The current buffer has already set full coding-system, we
1754 ;; had better not change it.
1755 nil
1756
8057896b 1757 (setq found-eol (coding-system-eol-type coding))
4ed46869 1758 (if (null (numberp found-eol))
be02cd54
EZ
1759 ;; But eol-type is not found.
1760 ;; If EOL conversions are inhibited, force unix eol-type.
1761 (setq found-eol (if inhibit-eol-conversion 0)))
c76b5c99
KH
1762 (if (eq (coding-system-type coding) t)
1763 (setq found-coding 'undecided)
1764 (setq found-coding (coding-system-base coding)))
1765
1766 (if (and (not found-eol) (eq found-coding 'undecided))
1767 ;; No valid coding information found.
1768 nil
1769
1770 ;; Some coding information (eol or text) found.
1771
1772 ;; The local setting takes precedence over the found one.
1773 (setq new-coding (if (local-variable-p 'buffer-file-coding-system)
1774 (or local-coding found-coding)
1775 (or found-coding local-coding)))
1776 (setq new-eol (if (local-variable-p 'buffer-file-coding-system)
1777 (or local-eol found-eol)
1778 (or found-eol local-eol)))
1779
1780 (let ((eol-type (coding-system-eol-type new-coding)))
1781 (if (and (numberp new-eol) (vectorp eol-type))
1782 (aref eol-type new-eol)
1783 new-coding)))))))
4ed46869 1784
fe831d33
GV
1785(defun modify-coding-system-alist (target-type regexp coding-system)
1786 "Modify one of look up tables for finding a coding system on I/O operation.
8c453b46
RS
1787There are three of such tables, `file-coding-system-alist',
1788`process-coding-system-alist', and `network-coding-system-alist'.
fe831d33
GV
1789
1790TARGET-TYPE specifies which of them to modify.
8c453b46
RS
1791If it is `file', it affects `file-coding-system-alist' (which see).
1792If it is `process', it affects `process-coding-system-alist' (which see).
e8dd0160 1793If it is `network', it affects `network-coding-system-alist' (which see).
fe831d33
GV
1794
1795REGEXP is a regular expression matching a target of I/O operation.
1796The target is a file name if TARGET-TYPE is `file', a program name if
1797TARGET-TYPE is `process', or a network service name or a port number
1798to connect to if TARGET-TYPE is `network'.
1799
1800CODING-SYSTEM is a coding system to perform code conversion on the I/O
8c453b46
RS
1801operation, or a cons cell (DECODING . ENCODING) specifying the coding systems
1802for decoding and encoding respectively,
1803or a function symbol which, when called, returns such a cons cell."
fe831d33
GV
1804 (or (memq target-type '(file process network))
1805 (error "Invalid target type: %s" target-type))
1806 (or (stringp regexp)
1807 (and (eq target-type 'network) (integerp regexp))
1808 (error "Invalid regular expression: %s" regexp))
1809 (if (symbolp coding-system)
1810 (if (not (fboundp coding-system))
1811 (progn
1812 (check-coding-system coding-system)
1813 (setq coding-system (cons coding-system coding-system))))
1814 (check-coding-system (car coding-system))
1815 (check-coding-system (cdr coding-system)))
1816 (cond ((eq target-type 'file)
1817 (let ((slot (assoc regexp file-coding-system-alist)))
1818 (if slot
1819 (setcdr slot coding-system)
1820 (setq file-coding-system-alist
1821 (cons (cons regexp coding-system)
1822 file-coding-system-alist)))))
1823 ((eq target-type 'process)
1824 (let ((slot (assoc regexp process-coding-system-alist)))
1825 (if slot
1826 (setcdr slot coding-system)
1827 (setq process-coding-system-alist
1828 (cons (cons regexp coding-system)
1829 process-coding-system-alist)))))
1830 (t
1831 (let ((slot (assoc regexp network-coding-system-alist)))
1832 (if slot
1833 (setcdr slot coding-system)
1834 (setq network-coding-system-alist
1835 (cons (cons regexp coding-system)
1836 network-coding-system-alist)))))))
1837
db046b7d
KH
1838(defun decode-coding-inserted-region (from to filename
1839 &optional visit beg end replace)
f29387e8
KH
1840 "Decode the region between FROM and TO as if it is read from file FILENAME.
1841Optional arguments VISIT, BEG, END, and REPLACE are the same as those
1842of the function `insert-file-contents'."
1843 (save-excursion
1844 (save-restriction
1845 (narrow-to-region from to)
1846 (goto-char (point-min))
1847 (let ((coding coding-system-for-read))
1848 (or coding
1849 (setq coding (funcall set-auto-coding-function
1850 filename (- (point-max) (point-min)))))
1851 (or coding
1852 (setq coding (find-operation-coding-system
1853 'insert-file-contents
1854 filename visit beg end replace)))
1855 (if (coding-system-p coding)
1856 (or enable-multibyte-characters
1857 (setq coding
1858 (coding-system-change-text-conversion coding 'raw-text)))
1859 (setq coding nil))
1860 (if coding
1861 (decode-coding-region (point-min) (point-max) coding))
1862 (setq last-coding-system-used coding)))))
1863
b25eef20 1864(defun make-translation-table (&rest args)
a284eea3 1865 "Make a translation table from arguments.
d38b07f9 1866A translation table is a char table intended for character
a284eea3
DL
1867translation in CCL programs.
1868
d38b07f9 1869Each argument is a list of elements of the form (FROM . TO), where FROM
a284eea3 1870is a character to be translated to TO.
13d5617d 1871
452fdb31 1872FROM can be a generic character (see `make-char'). In this case, TO is
d38b07f9 1873a generic character containing the same number of characters, or an
452fdb31 1874ordinary character. If FROM and TO are both generic characters, all
b25eef20 1875characters belonging to FROM are translated to characters belonging to TO
4e003d37
KH
1876without changing their position code(s).
1877
1878The arguments and forms in each argument are processed in the given
1879order, and if a previous form already translates TO to some other
1880character, say TO-ALT, FROM is also translated to TO-ALT."
f967223b 1881 (let ((table (make-char-table 'translation-table))
a73a8c89
KH
1882 revlist)
1883 (while args
1884 (let ((elts (car args)))
1885 (while elts
13d5617d
KH
1886 (let* ((from (car (car elts)))
1887 (from-i 0) ; degree of freedom of FROM
1888 (from-rev (nreverse (split-char from)))
1889 (to (cdr (car elts)))
1890 (to-i 0) ; degree of freedom of TO
1891 (to-rev (nreverse (split-char to))))
1892 ;; Check numbers of heading 0s in FROM-REV and TO-REV.
1893 (while (eq (car from-rev) 0)
1894 (setq from-i (1+ from-i) from-rev (cdr from-rev)))
1895 (while (eq (car to-rev) 0)
1896 (setq to-i (1+ to-i) to-rev (cdr to-rev)))
1897 (if (and (/= from-i to-i) (/= to-i 0))
1898 (error "Invalid character pair (%d . %d)" from to))
b25eef20
KH
1899 ;; If we have already translated TO to TO-ALT, FROM should
1900 ;; also be translated to TO-ALT. But, this is only if TO
1901 ;; is a generic character or TO-ALT is not a generic
13d5617d
KH
1902 ;; character.
1903 (let ((to-alt (aref table to)))
1904 (if (and to-alt
1905 (or (> to-i 0) (not (generic-char-p to-alt))))
1906 (setq to to-alt)))
1907 (if (> from-i 0)
1908 (set-char-table-default table from to)
1909 (aset table from to))
b25eef20
KH
1910 ;; If we have already translated some chars to FROM, they
1911 ;; should also be translated to TO.
a73a8c89
KH
1912 (let ((l (assq from revlist)))
1913 (if l
1914 (let ((ch (car l)))
1915 (setcar l to)
1916 (setq l (cdr l))
1917 (while l
1918 (aset table ch to)
1919 (setq l (cdr l)) ))))
1920 ;; Now update REVLIST.
1921 (let ((l (assq to revlist)))
1922 (if l
1923 (setcdr l (cons from (cdr l)))
1924 (setq revlist (cons (list to from) revlist)))))
1925 (setq elts (cdr elts))))
1926 (setq args (cdr args)))
1927 ;; Return TABLE just created.
1928 table))
1929
c76b5c99
KH
1930(defun make-translation-table-from-vector (vec)
1931 "Make translation table from decoding vector VEC.
9e3b6057
DL
1932VEC is an array of 256 elements to map unibyte codes to multibyte
1933characters. Elements may be nil for undefined code points.
c76b5c99
KH
1934See also the variable `nonascii-translation-table'."
1935 (let ((table (make-char-table 'translation-table))
1936 (rev-table (make-char-table 'translation-table))
c76b5c99 1937 ch)
9e3b6057 1938 (dotimes (i 256)
c76b5c99 1939 (setq ch (aref vec i))
9e3b6057
DL
1940 (when ch
1941 (aset table i ch)
1942 (if (>= ch 256)
1943 (aset rev-table ch i))))
c76b5c99
KH
1944 (set-char-table-extra-slot table 0 rev-table)
1945 table))
1946
f967223b 1947(defun define-translation-table (symbol &rest args)
a284eea3
DL
1948 "Define SYMBOL as the name of translation table made by ARGS.
1949This sets up information so that the table can be used for
1950translations in a CCL program.
b25eef20 1951
a284eea3
DL
1952If the first element of ARGS is a char-table whose purpose is
1953`translation-table', just define SYMBOL to name it. (Note that this
1954function does not bind SYMBOL.)
007c79c8 1955
a284eea3 1956Any other ARGS should be suitable as arguments of the function
007c79c8 1957`make-translation-table' (which see).
b25eef20 1958
452fdb31 1959This function sets properties `translation-table' and
521d4010
DL
1960`translation-table-id' of SYMBOL to the created table itself and the
1961identification number of the table respectively. It also registers
1962the table in `translation-table-vector'."
007c79c8
KH
1963 (let ((table (if (and (char-table-p (car args))
1964 (eq (char-table-subtype (car args))
1965 'translation-table))
1966 (car args)
1967 (apply 'make-translation-table args)))
f967223b 1968 (len (length translation-table-vector))
d9e3229d 1969 (id 0)
b25eef20 1970 (done nil))
f967223b 1971 (put symbol 'translation-table table)
b25eef20
KH
1972 (while (not done)
1973 (if (>= id len)
f967223b
KH
1974 (setq translation-table-vector
1975 (vconcat translation-table-vector (make-vector len nil))))
1976 (let ((slot (aref translation-table-vector id)))
b25eef20
KH
1977 (if (or (not slot)
1978 (eq (car slot) symbol))
1979 (progn
f967223b 1980 (aset translation-table-vector id (cons symbol table))
007c79c8
KH
1981 (setq done t))
1982 (setq id (1+ id)))))
f967223b 1983 (put symbol 'translation-table-id id)
d9e3229d
KH
1984 id))
1985
35554641
KH
1986(put 'with-category-table 'lisp-indent-function 1)
1987
ef6e365d
JPW
1988(defmacro with-category-table (table &rest body)
1989 "Evaluate BODY with category table of current buffer set to TABLE.
1990The category table of the current buffer is saved, BODY is evaluated,
1991then the saved table is restored, even in case of an abnormal exit.
1992Value is what BODY returns."
1993 (let ((old-table (make-symbol "old-table"))
1994 (old-buffer (make-symbol "old-buffer")))
1995 `(let ((,old-table (category-table))
1996 (,old-buffer (current-buffer)))
1997 (unwind-protect
1998 (progn
1999 (set-category-table ,table)
2000 ,@body)
2001 (save-current-buffer
2002 (set-buffer ,old-buffer)
2003 (set-category-table ,old-table))))))
35554641 2004
394e4eb0
DL
2005(defun define-translation-hash-table (symbol table)
2006 "Define SYMBOL as the name of the hash translation TABLE for use in CCL.
2007
2008Analogous to `define-translation-table', but updates
2009`translation-hash-table-vector' and the table is for use in the CCL
2010`lookup-integer' and `lookup-character' functions."
2011 (unless (and (symbolp symbol)
2012 (hash-table-p table))
2013 (error "Bad args to define-translation-hash-table"))
2014 (let ((len (length translation-hash-table-vector))
2015 (id 0)
2016 done)
2017 (put symbol 'translation-hash-table table)
2018 (while (not done)
2019 (if (>= id len)
2020 (setq translation-hash-table-vector
2021 (vconcat translation-hash-table-vector [nil])))
2022 (let ((slot (aref translation-hash-table-vector id)))
2023 (if (or (not slot)
2024 (eq (car slot) symbol))
2025 (progn
2026 (aset translation-hash-table-vector id (cons symbol table))
2027 (setq done t))
2028 (setq id (1+ id)))))
2029 (put symbol 'translation-hash-table-id id)
2030 id))
2031
69eba008
KH
2032;;; Initialize some variables.
2033
2034(put 'use-default-ascent 'char-table-extra-slots 0)
2035(setq use-default-ascent (make-char-table 'use-default-ascent))
d6d6d592
KH
2036(put 'ignore-relative-composition 'char-table-extra-slots 0)
2037(setq ignore-relative-composition
2038 (make-char-table 'ignore-relative-composition))
69eba008 2039
d9f6dfe6
CW
2040
2041;;; Built-in auto-coding-functions:
2042
2043(defun sgml-xml-auto-coding-function (size)
2044 "Determine whether the buffer is XML, and if so, its encoding.
2045This function is intended to be added to `auto-coding-functions'."
623b1d5e 2046 (when (re-search-forward "\\`[[:space:]\n]*<\\?xml" nil t)
d9f6dfe6
CW
2047 (let ((end (save-excursion
2048 ;; This is a hack.
2f4e9c47 2049 (re-search-forward "\"\\s-*\\?>" size t))))
d9f6dfe6
CW
2050 (when end
2051 (if (re-search-forward "encoding=\"\\(.+?\\)\"" end t)
447404a3
CW
2052 (let* ((match (match-string 1))
2053 (sym (intern (downcase match))))
2054 (if (coding-system-p sym)
2055 sym
2056 (message "Warning: unknown coding system \"%s\"" match)
2057 nil))
d9f6dfe6
CW
2058 'utf-8)))))
2059
447404a3
CW
2060(defun sgml-html-meta-auto-coding-function (size)
2061 "If the buffer has an HTML meta tag, use it to determine encoding.
2062This function is intended to be added to `auto-coding-functions'."
2063 (setq size (min size
2064 ;; Only search forward 10 lines
2065 (save-excursion
2066 (forward-line 10)
2067 (point))))
2068 (when (and (search-forward "<html>" size t)
2069 (re-search-forward "<meta\\s-+http-equiv=\"content-type\"\\s-+content=\"text/\\sw+;\\s-*charset=\\(.+?\\)\"" size t))
2070 (let* ((match (match-string 1))
2071 (sym (intern (downcase match))))
2072 (if (coding-system-p sym)
2073 sym
2074 (message "Warning: unknown coding system \"%s\"" match)
2075 nil))))
0bca779a 2076
69eba008 2077;;;
4ed46869
KH
2078(provide 'mule)
2079
2080;;; mule.el ends here